Objekt · SldWorks
GraphicsBody-Objekt
Ein Grafikkörper aus einer importierten Netzdatei: liefert seine dreieckigen Facetten und den Körper und macht aus ausgewählten Facetten eine Fläche.
Beschreibung
GraphicsBody gibt Zugriff auf einen Grafikkörper (graphics body). Ein Grafikkörper entsteht, wenn du eine Netzdatei wie STL oder PLY mit der Einstellung swImportStlVrmlModelType_Graphics (swImportStlVrmlModelType_e) als Grafik importierst. Er besteht aus dreieckigen Facetten. Dem Hilfethema „Graphics Mesh and Mesh BREP Bodies“ nach ist er anders als ein Netzkörper (MeshBody) vermutlich kein BREP-Körper. Den Körper selbst beschreibt Body2, GraphicsBody gibt Zugriff auf seine Facetten. Die Befehle gibt es seit SOLIDWORKS 2022, GraphicsBody.SurfaceFromMesh seit SOLIDWORKS 2023.
Zugriff
Body2.GetGraphicsBody: aus einem Körper, für denBody2.IsGraphicsBodyTrueliefert
Den Körper findest du wie in den Hilfebeispielen etwa mit PartDoc.GetBodies2 und swAllBodies, wenn Body2.GetType swGraphicsBody (swBodyType_e) liefert. In der Auswahl hat ein Grafikkörper den Typ swSelGRAPHICSBODY (swSelectType_e, Text "MESH BODY FEATURE"). Das Hilfebeispiel „Inspect Facets of Graphics and Mesh Bodies“ bekommt dabei aus SelectionMgr.GetSelectedObject6 ein Feature und daraus mit Feature.GetSpecificFeature2 den Körper.
Beispiel
' Gibt für jeden Grafikkörper des aktiven Teils die Zahl der Facetten und die
' Eckpunkte der ersten Facette aus.
' Vorbedingung: Ein Teil mit mindestens einem Grafikkörper ist offen, etwa aus einer
' STL- oder PLY-Datei, die als Grafik importiert wurde.
' 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 swGrafik As SldWorks.GraphicsBody
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.IsGraphicsBody Then
Set swGrafik = swBody.GetGraphicsBody
Debug.Print swBody.Name & ": " & swGrafik.GetFacetCount & " Facetten"
vFacetten = swGrafik.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 mit SldWorks.SetUserPreferenceIntegerValue und swImportStlVrmlModelType (swUserPreferenceIntegerValue_e) erst als Grafikkörper, dann als Netzkörper. Für den Grafikkörper wählt es den Körper mit ModelDocExtension.SelectByID2 und dem Typ "MESH BODY FEATURE" aus, holt mit Body2.GetGraphicsBody den Grafikkörper, mit GraphicsBody.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 GraphicsBody.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.
Netzkörper: Einen Grafikkörper wandelst du mit Body2.ConvertToMeshBody in einen Netzkörper (MeshBody) um, der dieselben vier Befehle hat. Der Parameter GroupFacetsIntoFaces gilt dort nur für Grafikkörper. 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.
Vertex.GetPoint liefert bei den Eckpunkten einer Facette deren Koordinaten.
Eigenschaften und Methoden
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| GetBody | Liefert den Körper zu diesem Grafikkörper. |
| GetFacetCount | Liefert die Zahl der Facetten des Grafikkörpers. |
| GetFacets | Liefert die Facetten des Grafikkörpers, also seine Dreiecke. |
| SurfaceFromMesh | Erzeugt aus den ausgewählten Facetten des Grafikkörpers eine Fläche: Ebene, Kugel, Zylinder oder Kegel. |
Siehe auch
Englisches Original: IGraphicsBody in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.