SolidWorksMakroprogrammierung

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 Object
Set swFlaeche = swGrafik.SurfaceFromMesh(PLANE_TYPE, 0, 0.005, nFehler)

Parameter

SurfaceTypeLongByVal
Die Art der Fläche aus swSurfaceTypes_e. Nur PLANE_TYPE, SPHERE_TYPE, CYLINDER_TYPE oder CONE_TYPE.
FacetToleranceDoubleByVal
Anteil der Facettenauswahl in Prozent, von 0 (hohe Toleranz) bis 100 (niedrige Toleranz).
ExtendSurfaceSizeDoubleByVal
Verlängerung der Fläche in Metern, damit sie die ausgewählten Facetten und die Form abdeckt.
ErrorCodeLongByRef · Rückgabe
Gibt 0 bei Erfolg und -1 bei 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 If

Bemerkungen

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.