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.
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
Body2.GetTessellation: für den ganzen Körper oder für ausgewählte Flächen
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CurveChordAngleTolerance | Liest oder setzt den größten Winkel zwischen einer Sehne und der Kurve, die sie annähert. |
| CurveChordTolerance | Liest oder setzt den größten Abstand zwischen einer Sehne (Fin) und der Kurve der Kante. |
| ImprovedQuality | Liest oder setzt, ob die Tessellierung genauere Daten für Analysen statt der Daten für die Anzeige liefert. |
| MatchType | Liest oder setzt, wie die Facetten an gemeinsamen Kanten zusammenpassen (Parasolid facet match). |
| MaxFacetWidth | Liest oder setzt, wie lang eine Seite einer Facette höchstens sein darf. |
| MinFacetWidth | Liest oder setzt die kleinste Breite einer Facette. |
| NeedEdgeFinMap | Liest oder setzt, ob die Tessellierung die Zuordnung von Kanten zu Fins anlegt. |
| NeedErrorList | Liest oder setzt, ob die Tessellierung eine Fehlerliste anlegt. |
| NeedFaceFacetMap | Liest oder setzt, ob die Tessellierung die Zuordnung von Flächen zu Facetten anlegt. |
| NeedVertexNormal | Liest oder setzt, ob die Tessellierung die Normalen an den Knoten berechnet. |
| NeedVertexParams | Liest oder setzt, ob die Tessellierung die Flächenparameter an den Knoten berechnet. |
| SurfacePlaneAngleTolerance | Liest oder setzt die Winkeltoleranz zwischen Fläche und Facette. |
| SurfacePlaneTolerance | Liest oder setzt die Abstandstoleranz zwischen Fläche und Facette. |
Methoden 15, davon 15 beschrieben
| Name | Beschreibung |
|---|---|
| GetEdgeFins | Liefert die Nummern aller Fins, die an einer Kante liegen. |
| GetErrorList | Liefert die Nummern der Flächen, Facetten und Knoten, bei denen die Tessellierung Fehler hatte. |
| GetFaceFacets | Liefert die Nummern der Facetten, die zu einer Fläche gehören. |
| GetFacetCount | Liefert die Zahl der Facetten der Tessellierung. |
| GetFacetFace | Liefert die Fläche, zu der eine Facette gehört. |
| GetFacetFins | Liefert die Nummern der Fins, die eine Facette begrenzen. |
| GetFinCoFin | Liefert die Nummer des Gegen-Fins, das mit einem Fin dieselbe Strecke teilt. |
| GetFinCount | Liefert die Zahl der Fins der Tessellierung. |
| GetFinEdge | Liefert die Kante des Modells, an der ein Fin liegt. |
| GetFinVertices | Liefert die Nummern der beiden Knoten an den Enden eines Fins. |
| GetVertexCount | Liefert die Zahl der Knoten der Tessellierung. |
| GetVertexNormal | Liefert die Normale an einem Knoten der Tessellierung. |
| GetVertexParams | Liefert die Flächenparameter, Tangenten und Krümmungsvektoren an einem Knoten der Tessellierung. |
| GetVertexPoint | Liefert X, Y und Z eines Knotens der Tessellierung. |
| Tessellate | Fü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.