SolidWorksMakroprogrammierung

Methode · MeshBody

SurfaceFromMesh-Methode (MeshBody)

Erzeugt aus den ausgewählten Facetten des Netzkö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 = swNetz.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

' swNetz ist ein Netzkörper (MeshBody), etwa aus Body2.GetMeshBody.
' Im Netzkörper sind die Facetten einer ebenen Stelle ausgewählt.
Dim swFlaeche As SldWorks.Body2
Dim nFehler As Long
Set swFlaeche = swNetz.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 Netzkörper so viele Facetten aus, wie die Art der Fläche braucht. Das geht etwa mit Facet.Select für Facetten aus MeshBody.GetFacets oder mit ModelDocExtension.SelectByID2 und dem Typ MESHFACETREF.

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 Grafikkörper gibt es denselben Befehl als GraphicsBody.SurfaceFromMesh.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2023

Englisches Original: IMeshBody::SurfaceFromMesh in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.