SolidWorksMakroprogrammierung

Objekt · SldWorks

Tessellation-Objekt

Die Zerlegung eines Körpers in Dreiecke (Tessellierung): Toleranzen einstellen, tessellieren und Facetten, Fins und Knoten mit ihren Flächen und Kanten abfragen.

Deklaration Dim x As SldWorks.Tessellation · in der englischen .NET-Hilfe: ITessellation

Beschreibung

Tessellation liefert die Tessellierung eines SOLIDWORKS-Körpers, also seine Zerlegung in ebene Dreiecke. Du stellst zuerst Toleranzen und Optionen ein, rufst dann Tessellation.Tessellate auf und fragst danach die Daten ab. Die Daten bestehen aus drei Arten von Elementen mit Nummern (IDs): Facetten (die Dreiecke), Fins (die Seiten einer Facette, je Facette drei) und Knoten (die Eckpunkte der Fins, je Fin zwei). Zu Facetten und Fins bekommst du die Fläche und Kante des Modells, zu der sie gehören. Die meisten Befehle gibt es seit SOLIDWORKS 2001.

Zugriff

Beispiel

' Tesselliert den ersten Volumenkörper des aktiven Teils und gibt je Fläche die Zahl
' der Facetten und die Ecken der ersten Facette aus.
' Vorbedingung: Ein Teil mit mindestens einem Volumenkörper ist offen.
' Ergebnis:     Die Angaben stehen im Direktfenster, das Teil bleibt unverändert.
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 swTess As SldWorks.Tessellation
    Dim swFace As SldWorks.Face2
    Dim vKoerper As Variant, vFacetten As Variant, vFins As Variant
    Dim vKnoten As Variant, vPunkt As Variant
    Dim i 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(swSolidBody, True)
    If IsEmpty(vKoerper) Then Exit Sub
    Set swBody = vKoerper(0)

    Set swTess = swBody.GetTessellation(Empty)          ' Empty: der ganze Körper
    swTess.NeedFaceFacetMap = True
    swTess.ImprovedQuality = True
    swTess.MatchType = swTesselationMatchFacetTopology
    If False = swTess.Tessellate Then Exit Sub
    Debug.Print swTess.GetFacetCount & " Facetten, " & swTess.GetVertexCount & " Knoten"

    Set swFace = swBody.GetFirstFace
    Do While Not swFace Is Nothing
        vFacetten = swTess.GetFaceFacets(swFace)
        If IsArray(vFacetten) Then
            Debug.Print "Fläche: " & UBound(vFacetten) + 1 & " Facetten"
            vFins = swTess.GetFacetFins(vFacetten(0))
            For i = 0 To 2                                   ' drei Fins je Facette
                vKnoten = swTess.GetFinVertices(vFins(i))
                vPunkt = swTess.GetVertexPoint(vKnoten(0))
                Debug.Print "  Ecke: " & vPunkt(0) * 1000 & ", " & vPunkt(1) * 1000 & ", " & vPunkt(2) * 1000 & " mm"
            Next i
        End If
        Set swFace = swFace.GetNextFace
    Loop
End Sub

Bemerkungen

Reihenfolge: Erst die Optionen setzen, dann Tessellation.Tessellate aufrufen, dann abfragen. So macht es das Hilfebeispiel „Tessellate a Body“. Es zeichnet die Seiten aller Facetten als Linien in eine 3D-Skizze. Seine Kommentare geben für jede Facette drei Fins und für jedes Fin zwei Knoten an.

Optionen für Zuordnungen: Manche Abfragen liefern nur etwas, wenn du vorher die passende Option setzt, etwa Tessellation.GetFaceFacets nur mit Tessellation.NeedFaceFacetMap True. Für die übrigen Zuordnungen sagt die Hilfe das nicht ausdrücklich, vermutlich gilt dasselbe.

Anders als GetTessTriangles: Face2.GetTessTriangles liefert die Dreiecke einer Fläche aus der Anzeige, ohne eigene Toleranzen. Mit Tessellation stellst du die Feinheit selbst ein und bekommst die Zusammenhänge zwischen Facetten, Kanten und Flächen.

Einheiten: Die Hilfe nennt die Einheit nur für CurveChordAngleTolerance (Bogenmaß). Für die anderen Toleranzen und die Facettenbreiten nennt sie keine, vermutlich Meter und Bogenmaß. Die Punkte sind Meter (die Knoten des Zylinders r 20 mm lagen bei ±0,02).

Eigenschaften und Methoden

Eigenschaften 13, davon 13 beschrieben

NameBeschreibung
CurveChordAngleToleranceLiest oder setzt den größten Winkel zwischen einer Sehne und der Kurve, die sie annähert.
CurveChordToleranceLiest oder setzt den größten Abstand zwischen einer Sehne (Fin) und der Kurve der Kante.
ImprovedQualityLiest oder setzt, ob die Tessellierung genauere Daten für Analysen statt der Daten für die Anzeige liefert.
MatchTypeLiest oder setzt, wie die Facetten an gemeinsamen Kanten zusammenpassen (Parasolid facet match).
MaxFacetWidthLiest oder setzt, wie lang eine Seite einer Facette höchstens sein darf.
MinFacetWidthLiest oder setzt die kleinste Breite einer Facette.
NeedEdgeFinMapLiest oder setzt, ob die Tessellierung die Zuordnung von Kanten zu Fins anlegt.
NeedErrorListLiest oder setzt, ob die Tessellierung eine Fehlerliste anlegt.
NeedFaceFacetMapLiest oder setzt, ob die Tessellierung die Zuordnung von Flächen zu Facetten anlegt.
NeedVertexNormalLiest oder setzt, ob die Tessellierung die Normalen an den Knoten berechnet.
NeedVertexParamsLiest oder setzt, ob die Tessellierung die Flächenparameter an den Knoten berechnet.
SurfacePlaneAngleToleranceLiest oder setzt die Winkeltoleranz zwischen Fläche und Facette.
SurfacePlaneToleranceLiest oder setzt die Abstandstoleranz zwischen Fläche und Facette.

Methoden 15, davon 15 beschrieben

NameBeschreibung
GetEdgeFinsLiefert die Nummern aller Fins, die an einer Kante liegen.
GetErrorListLiefert die Nummern der Flächen, Facetten und Knoten, bei denen die Tessellierung Fehler hatte.
GetFaceFacetsLiefert die Nummern der Facetten, die zu einer Fläche gehören.
GetFacetCountLiefert die Zahl der Facetten der Tessellierung.
GetFacetFaceLiefert die Fläche, zu der eine Facette gehört.
GetFacetFinsLiefert die Nummern der Fins, die eine Facette begrenzen.
GetFinCoFinLiefert die Nummer des Gegen-Fins, das mit einem Fin dieselbe Strecke teilt.
GetFinCountLiefert die Zahl der Fins der Tessellierung.
GetFinEdgeLiefert die Kante des Modells, an der ein Fin liegt.
GetFinVerticesLiefert die Nummern der beiden Knoten an den Enden eines Fins.
GetVertexCountLiefert die Zahl der Knoten der Tessellierung.
GetVertexNormalLiefert die Normale an einem Knoten der Tessellierung.
GetVertexParamsLiefert die Flächenparameter, Tangenten und Krümmungsvektoren an einem Knoten der Tessellierung.
GetVertexPointLiefert X, Y und Z eines Knotens der Tessellierung.
TessellateFührt die Tessellierung mit den eingestellten Toleranzen und Optionen aus.

Nicht aufgeführt sind 18 C++-Varianten (Namen mit I davor, zum Beispiel IGetEdgeFins). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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