Methode · GraphicsBody
SurfaceFromMesh-Methode (GraphicsBody)
Erzeugt aus den ausgewählten Facetten des Grafikkörpers eine Fläche: Ebene, Kugel, Zylinder oder Kegel.
Syntax
Function SurfaceFromMesh( _
ByVal SurfaceType As Long, _
ByVal FacetTolerance As Double, _
ByVal ExtendSurfaceSize As Double, _
ByRef ErrorCode As Long _
) As ObjectSet swFlaeche = swGrafik.SurfaceFromMesh(PLANE_TYPE, 0, 0.005, nFehler)Parameter
SurfaceTypeLongByVal- Die Art der Fläche aus
swSurfaceTypes_e. NurPLANE_TYPE,SPHERE_TYPE,CYLINDER_TYPEoderCONE_TYPE. FacetToleranceDoubleByVal- Anteil der Facettenauswahl in Prozent, von
0(hohe Toleranz) bis100(niedrige Toleranz). ExtendSurfaceSizeDoubleByVal- Verlängerung der Fläche in Metern, damit sie die ausgewählten Facetten und die Form abdeckt.
ErrorCodeLongByRef · Rückgabe- Gibt
0bei Erfolg und-1bei einem Fehler zurück.
Rückgabewert
Ein Körper (Body2), vermutlich der neue Flächenkörper. Die Hilfe nennt nur den Typ.
Beispiel
' swGrafik ist ein Grafikkörper (GraphicsBody), etwa aus Body2.GetGraphicsBody.
' Im Grafikkörper sind die Facetten einer ebenen Stelle ausgewählt.
Dim swFlaeche As SldWorks.Body2
Dim nFehler As Long
Set swFlaeche = swGrafik.SurfaceFromMesh(PLANE_TYPE, 0, 0.005, nFehler)
If nFehler <> 0 Then
Debug.Print "Keine Fläche erzeugt. Mehr Facetten auswählen oder die Werte ändern."
End IfBemerkungen
Der Befehl entspricht dem Menübefehl Insert › Mesh › Surface From Mesh und erzeugt im FeatureManager das Feature Surface-From-MeshX. Vorher wählst du im Grafikkörper so viele Facetten aus, wie die Art der Fläche braucht. Das geht etwa mit Facet.Select für Facetten aus GraphicsBody.GetFacets oder mit ModelDocExtension.SelectByID2 und dem Typ MESHFACETREF, so wählt das Hilfebeispiel „Inspect Facets of Graphics and Mesh Bodies“ eine Facette im Grafikkörper aus.
Das Hilfebeispiel zu Body2.ConvertToMeshBody erzeugt so eine Ebene mit FacetTolerance = 0 und ExtendSurfaceSize = 0,023. Ist ErrorCode -1, rät das Beispiel, mehr Facetten auszuwählen oder SurfaceType, FacetTolerance und ExtendSurfaceSize zu ändern.
Was der Prozentwert von FacetTolerance genau bedeutet, sagt die API-Hilfe nicht. Sie verweist auf das Thema „Creating a Surface from Mesh Feature“ in der SOLIDWORKS-Hilfe. Für Netzkörper gibt es denselben Befehl als MeshBody.SurfaceFromMesh.
Facet.Select liefert bei den Facetten eines Grafikkörpers aus einer STL-Datei False und wählt nichts aus. SurfaceFromMesh gibt dann Nothing und den Fehlerwert -1 zurück.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2023
Englisches Original: IGraphicsBody::SurfaceFromMesh in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.