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 ObjectSet swFlaeche = swNetz.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
' 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 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 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.