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.
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
MeshBody.GetFacets: alle Facetten eines Netzkörpers, etwa ausBody2.GetMeshBodyGraphicsBody.GetFacets: alle Facetten eines Grafikkörpers, etwa ausBody2.GetGraphicsBody
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetBody | Liefert den Körper, zu dem diese Facette gehört. |
| GetFacetEdges | Liefert die drei Kanten dieser Facette. |
| GetFacetVertices | Liefert die drei Eckpunkte dieser Facette. |
| Select | Wä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.