Objekt · SldWorks
MeshBody-Objekt
Ein Netzkörper (Mesh-BREP-Körper) aus dreieckigen Facetten: liefert die Facetten und den Körper und macht aus ausgewählten Facetten eine Fläche.
Beschreibung
MeshBody gibt Zugriff auf einen Netzkörper (mesh body). Ein Netzkörper, auch Mesh-BREP-Körper, besteht aus dreieckigen Facetten. Er entsteht, wenn du einen Volumen-, Flächen- oder Grafikkörper mit Body2.ConvertToMeshBody umwandelst oder eine Netzdatei wie STL oder PLY mit dem Schalter swVrmlStlImportAsPSMesh (swUserPreferenceToggle_e) als Volumen- oder Flächenkörper importierst. Den Körper selbst beschreibt Body2, MeshBody gibt Zugriff auf seine Facetten. Die Befehle gibt es seit SOLIDWORKS 2022, MeshBody.SurfaceFromMesh seit SOLIDWORKS 2023.
Zugriff
Body2.GetMeshBody: aus einem Körper, für denBody2.IsMeshBodyTrueliefert
Den Körper findest du etwa mit PartDoc.GetBodies2. In den Hilfebeispielen hat ein Netzkörper in der Auswahl den Typ swSelMESHSOLIDBODIES oder, als Flächenkörper importiert, swSelSURFACEBODIES (swSelectType_e).
Beispiel
' Gibt für jeden Netzkörper des aktiven Teils die Zahl der Facetten und die
' Eckpunkte der ersten Facette aus.
' Vorbedingung: Ein Teil mit mindestens einem Netzkörper ist offen, etwa aus einer
' STL-Datei oder aus Body2.ConvertToMeshBody.
' Ergebnis: Die Angaben stehen im Direktfenster (Strg+G), Koordinaten in mm.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swPart As SldWorks.PartDoc
Dim swBody As SldWorks.Body2
Dim swNetz As SldWorks.MeshBody
Dim swFacette As SldWorks.Facet
Dim swEckpunkt As SldWorks.Vertex
Dim vKoerper As Variant
Dim vFacetten As Variant
Dim vEcken As Variant
Dim vPunkt As Variant
Dim i As Long
Dim j As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART Then Exit Sub
Set swPart = swModel
vKoerper = swPart.GetBodies2(swAllBodies, False)
If Not IsArray(vKoerper) Then Exit Sub
For i = 0 To UBound(vKoerper)
Set swBody = vKoerper(i)
If swBody.IsMeshBody Then
Set swNetz = swBody.GetMeshBody
Debug.Print swBody.Name & ": " & swNetz.GetFacetCount & " Facetten"
vFacetten = swNetz.GetFacets
If IsArray(vFacetten) Then
Set swFacette = vFacetten(0)
vEcken = swFacette.GetFacetVertices
For j = 0 To UBound(vEcken)
Set swEckpunkt = vEcken(j)
vPunkt = swEckpunkt.GetPoint
Debug.Print " Ecke " & j + 1 & ": " & vPunkt(0) * 1000# & ", " & vPunkt(1) * 1000# & ", " & vPunkt(2) * 1000#
Next j
End If
End If
Next i
End SubBemerkungen
Hilfebeispiele: „Inspect Facets of Graphics and Mesh Bodies“ (bei Facet) importiert die Datei Part1.PLY erst als Grafikkörper, dann als Netzkörper. Für den Netzkörper setzt es vorher swImportStlVrmlModelType_Surface (swImportStlVrmlModelType_e) und swVrmlStlImportAsPSMesh. Dann holt es mit Body2.GetMeshBody den Netzkörper, mit MeshBody.GetBody wieder den Körper, gibt die Zahl der Facetten aus und geht alle Facetten mit ihren Kanten und Eckpunkten durch. Das Beispiel zu Body2.ConvertToMeshBody macht mit MeshBody.SurfaceFromMesh aus vorher ausgewählten Facetten eine Ebene.
Facetten: Eine Facette (Facet) ist ein Dreieck eines Netz- oder Grafikkörpers. Facet.GetFacetEdges liefert ihre drei Kanten (Edge), Facet.GetFacetVertices ihre drei Eckpunkte (Vertex), Facet.Select wählt sie aus. Das Hilfebeispiel prüft bei Kanten und Eckpunkten nur, ob sie nicht Nothing sind. Ob Vertex.GetPoint bei den Eckpunkten einer Facette die Koordinaten liefert wie im Beispiel oben, sagt die Hilfe nicht, vermutlich ja.
Grafikkörper: Ein Grafikkörper (GraphicsBody aus Body2.GetGraphicsBody) hat dieselben vier Befehle. Er entsteht beim Import einer Netzdatei mit swImportStlVrmlModelType_Graphics. Ob ein Körper ein Netz- oder Grafikkörper ist, liefern Body2.IsMeshBody und Body2.IsGraphicsBody oder Body2.GetType mit swMeshBody bzw. swGraphicsBody (swBodyType_e).
Körper finden: Beide Hilfebeispiele holen die Körper mit PartDoc.GetBodies2 und swAllBodies und finden darunter Netz- und Grafikkörper. Auf der Seite zu GetBodies2 steht aber, dass der Befehl nur Volumen- und Flächenkörper unterstützt.
Mehr dazu: Für Einzelheiten verweist die API-Hilfe auf das Thema „Graphics Mesh and Mesh BREP Bodies“ unter Parts and Features in der SOLIDWORKS-Hilfe.
Eigenschaften und Methoden
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| GetBody | Liefert den Körper zu diesem Netzkörper. |
| GetFacetCount | Liefert die Zahl der Facetten des Netzkörpers. |
| GetFacets | Liefert die Facetten des Netzkörpers, also seine Dreiecke. |
| SurfaceFromMesh | Erzeugt aus den ausgewählten Facetten des Netzkörpers eine Fläche: Ebene, Kugel, Zylinder oder Kegel. |
Siehe auch
Englisches Original: IMeshBody in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.