SolidWorksMakroprogrammierung

Objekt · SldWorks

Facet-Objekt

Eine dreieckige Facette eines Netz- oder Grafikkörpers: liefert ihre drei Kanten, ihre drei Eckpunkte und den Körper und wählt sie aus.

Deklaration Dim x As SldWorks.Facet · in der englischen .NET-Hilfe: IFacet

Beschreibung

Facet gibt Zugriff auf eine dreieckige Facette eines Netzkörpers (MeshBody) oder eines Grafikkörpers (GraphicsBody). Netzkörper und Grafikkörper bestehen aus solchen Dreiecken, etwa nach dem Import einer STL- oder PLY-Datei. Die Befehle gibt es seit SOLIDWORKS 2022.

Zugriff

Die Zahl der Facetten liefern MeshBody.GetFacetCount und GraphicsBody.GetFacetCount.

Beispiel

' Gibt für jeden Netzkörper des aktiven Teils die Eckpunkte der ersten Facette
' und die Zahl ihrer Kanten aus und wählt die 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.
'               Ausgewählt ist die erste Facette des letzten Netzkörpers.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swSelMgr As SldWorks.SelectionMgr
    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 vKanten 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
    Set swSelMgr = swModel.SelectionManager

    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
            vFacetten = swNetz.GetFacets
            If IsArray(vFacetten) Then
                Set swFacette = vFacetten(0)
                Debug.Print "Körper " & swBody.Name & ", erste Facette:"   ' nicht swFacette.GetBody, das stürzte in SOLIDWORKS 2024 ab
                vKanten = swFacette.GetFacetEdges
                Debug.Print "  " & UBound(vKanten) + 1 & " Kanten"
                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
                If swFacette.Select(False, Nothing) Then
                    Debug.Print "  ausgewählt, Typ " & swSelMgr.GetSelectedObjectType3(1, -1) & _
                        IIf(swSelMgr.GetSelectedObjectType3(1, -1) = swSelFACETS, " (swSelFACETS)", "")
                End If
            End If
        End If
    Next i
End Sub

Bemerkungen

Hilfebeispiel: „Inspect Facets of Graphics and Mesh Bodies“ importiert die Datei Part1.PLY erst als Grafikkörper, dann als Netzkörper. Für jeden Körper holt es die Facetten, ruft bei jeder Facette Facet.GetBody, Facet.GetFacetEdges und Facet.GetFacetVertices auf und wählt sie mit Facet.Select aus. Es prüft bei Kanten und Eckpunkten nur, ob sie nicht Nothing sind, und nach der Auswahl, ob SelectionMgr.GetSelectedObjectType3 swSelFACETS liefert.

Auswahl: In swSelectType_e steht eine Facette für swSelFACETS (Typname MESHFACETREF), eine Facettenkante für swSelMESHFACETEDGES (MESHFINREF) und ein Facetteneckpunkt für swSelMESHFACETVERTICES (MESHVERTEXREF). Mit diesen Typnamen wählt das Hilfebeispiel auch über ModelDocExtension.SelectByID2 und Koordinaten aus. Ausgewählte Facetten braucht etwa MeshBody.SurfaceFromMesh.

Kanten und Eckpunkte: Die Hilfe sagt nur, dass die Kanten Edge- und die Eckpunkte Vertex-Objekte sind. Ob alle Befehle von Edge und Vertex bei Facetten funktionieren, sagt sie nicht. Vertex.GetPoint liefert die Koordinaten in Metern wie im Beispiel oben.

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.

Achtung: Facet.GetBody kann SOLIDWORKS zum Absturz bringen. Das Beispiel nimmt den Körper deshalb aus der Schleife über die Körper.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetBodyLiefert den Körper, zu dem diese Facette gehört.
GetFacetEdgesLiefert die drei Kanten dieser Facette.
GetFacetVerticesLiefert die drei Eckpunkte dieser Facette.
SelectWählt diese Facette aus.

Siehe auch

Englisches Original: IFacet in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.