SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.MeshBody · in der englischen .NET-Hilfe: IMeshBody

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

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 Sub

Bemerkungen

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

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