SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.GraphicsBody · in der englischen .NET-Hilfe: IGraphicsBody

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

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 Sub

Bemerkungen

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

NameBeschreibung
GetBodyLiefert den Körper zu diesem Grafikkörper.
GetFacetCountLiefert die Zahl der Facetten des Grafikkörpers.
GetFacetsLiefert die Facetten des Grafikkörpers, also seine Dreiecke.
SurfaceFromMeshErzeugt 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.