Methode · Face2
GetTrimCurves2-Methode (Face2)
Liefert die Begrenzungskurven einer Fläche als B-Splines im UV-Raum ihrer Surface, auf Wunsch zusammen mit der Surface als B-Spline-Fläche.
Syntax
Function GetTrimCurves2( _
ByVal WantCubic As Boolean, _
ByVal WantNRational As Boolean _
) As VariantvDaten = swFace.GetTrimCurves2(True, False)Parameter
WantCubicBooleanByValTrue: Die Kurven sollen kubisch sein. Zusätzlich liefert der Befehl die Surface der Fläche als B-Spline-Fläche (Bsurface). MitTruepassen Kurven und Fläche besser zusammen, weil beide im selben Schritt entstehen.WantNRationalBooleanByValTrue: Die Kurven sollen nicht rational sein.
Rückgabewert
Ein Array mit Double-Werten. Ganzzahlen stecken darin paarweise: Zwei Long-Werte teilen sich die 8 Bytes eines Double. Wie du sie herausholst, zeigt das Beispiel. Den Aufbau des Arrays beschreibt der nächste Abschnitt.
Aufbau des Arrays
Die Daten folgen ohne Lücke aufeinander. „Paar“ heißt: ein Double mit zwei Ganzzahlen, die erste in den unteren 4 Bytes.
- Kopf (1 Wert): Paar aus Anzahl der Schleifen und Gesamtzahl der Begrenzungskurven (SP-Kurven).
- Kurven je Schleife (Anzahl Schleifen durch 2, aufgerundet): je ein Paar für zwei Schleifen. Die erste Zahl gilt für die 1., 3., 5. … Schleife, die zweite für die 2., 4., 6. … Schleife.
- Daten je Kurve (2 Werte je Kurve): erst ein Paar aus Ordnung und „periodisch“ (
1oder0), dann ein Paar aus Dimension und Anzahl der Kontrollpunkte. Dimension2heißt nicht rational,3rational. - Knoten aller Kurven hintereinander: je Kurve Ordnung plus Anzahl der Kontrollpunkte Werte.
- Kontrollpunkte aller Kurven hintereinander: je Punkt U und V, bei rationalen Kurven U, V und das Gewicht W.
Nur mit WantCubic = True folgt die Surface als B-Spline-Fläche:
- Dimension (1 Wert): Paar aus Dimension und
0.3heißt nicht rational,4rational. - Ordnungen (1 Wert): Paar aus Ordnung in U und Ordnung in V.
- Kontrollpunkte (1 Wert): Paar aus Anzahl in U und Anzahl in V.
- Periodisch (1 Wert): Paar aus „periodisch in U“ und „periodisch in V“.
- Knoten in U: Ordnung in U plus Anzahl in U Werte.
- Knoten in V: Ordnung in V plus Anzahl in V Werte.
- Kontrollpunkte der Fläche: je Punkt X, Y, Z in Metern, bei rationalen Flächen X, Y, Z und W. Zeilenweise, U läuft am schnellsten.
Am Ende steht immer:
- Teilflächen (1 Wert): Paar aus der Anzahl der Teilflächen (trimmed surfaces) dieser Fläche und der Nummer der Teilfläche, die gerade geliefert wird.
Beispiel
' Liest die Begrenzungskurven der ausgewählten Fläche und gibt Schleifen, Kurven
' und die Daten der B-Spline-Fläche aus.
' Vorbedingung: In einem Teil ist eine Fläche ausgewählt.
' Ergebnis: Liste im Direktfenster (Strg+G).
Option Explicit
' Zwei Long stecken in den 8 Bytes eines Double. LSet kopiert die Bytes in zwei Long.
Private Type DoubleRec
dWert As Double
End Type
Private Type Long2Rec
nErste As Long
nZweite As Long
End Type
Private Sub Entpacken(ByVal dWert As Double, nErste As Long, nZweite As Long)
Dim dr As DoubleRec
Dim lr As Long2Rec
dr.dWert = dWert
LSet lr = dr
nErste = lr.nErste
nZweite = lr.nZweite
End Sub
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swFace As SldWorks.Face2
Dim vDaten As Variant
Dim nSchleifen As Long, nKurven As Long
Dim nOrdnung As Long, nPeriodisch As Long, nDimension As Long, nPunkte As Long
Dim nA As Long, nB As Long
Dim nKnoten As Long, nKoord As Long
Dim nFlDim As Long, nUOrd As Long, nVOrd As Long, nUPkt As Long, nVPkt As Long
Dim nPos As Long, i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelFACES Then
swApp.SendMsgToUser2 "Bitte zuerst eine Fläche auswählen.", swMbWarning, swMbOk
Exit Sub
End If
Set swFace = swSelMgr.GetSelectedObject6(1, -1)
vDaten = swFace.GetTrimCurves2(True, False)
If IsEmpty(vDaten) Then Exit Sub
' Kopf: Anzahl Schleifen und Anzahl Kurven
Entpacken vDaten(0), nSchleifen, nKurven
Debug.Print nSchleifen & " Schleifen, " & nKurven & " Begrenzungskurven"
nPos = 1
' Kurven je Schleife, zwei Schleifen pro Wert
For i = 1 To nSchleifen Step 2
Entpacken vDaten(nPos), nA, nB
Debug.Print " Schleife " & i & ": " & nA & " Kurven"
If i + 1 <= nSchleifen Then Debug.Print " Schleife " & i + 1 & ": " & nB & " Kurven"
nPos = nPos + 1
Next i
' Daten je Kurve; Knoten und Koordinaten für später zusammenzählen
For i = 1 To nKurven
Entpacken vDaten(nPos), nOrdnung, nPeriodisch
Entpacken vDaten(nPos + 1), nDimension, nPunkte
Debug.Print " Kurve " & i & ": Ordnung " & nOrdnung & ", " & nPunkte & " Kontrollpunkte" & _
IIf(nDimension = 3, ", rational", "") & IIf(nPeriodisch = 1, ", periodisch", "")
nKnoten = nKnoten + nOrdnung + nPunkte
nKoord = nKoord + nPunkte * nDimension
nPos = nPos + 2
Next i
' Knoten und Kontrollpunkte der Kurven überspringen
nPos = nPos + nKnoten + nKoord
' Mit WantCubic = True folgt die B-Spline-Fläche
Entpacken vDaten(nPos), nFlDim, nA
Entpacken vDaten(nPos + 1), nUOrd, nVOrd
Entpacken vDaten(nPos + 2), nUPkt, nVPkt
Debug.Print "Fläche: Ordnung " & nUOrd & " x " & nVOrd & ", " & nUPkt & " x " & nVPkt & _
" Kontrollpunkte" & IIf(nFlDim = 4, ", rational", "")
nPos = nPos + 4 + (nUOrd + nUPkt) + (nVOrd + nVPkt) + nUPkt * nVPkt * nFlDim
' Letzter Wert: Anzahl Teilflächen und Nummer der aktuellen
If nPos <> UBound(vDaten) Then
Debug.Print "Aufbau passt nicht: Position " & nPos & ", letzter Index " & UBound(vDaten)
Exit Sub
End If
Entpacken vDaten(nPos), nA, nB
Debug.Print "Teilfläche " & nB & " von " & nA
End SubDas Beispiel liest nur die Anzahlen aus. Die Knoten und Kontrollpunkte stehen an den Stellen, die es überspringt. Die Kontrollpunkte der Kurven sind UV-Werte auf der Surface, keine Koordinaten im Raum. Die Kontrollpunkte der Fläche sind X, Y, Z in Metern.
Am Ende prüft das Beispiel, ob die gezählte Länge zur Länge des Arrays passt. So merkst du sofort, wenn ein Wert falsch entpackt wurde.
Bemerkungen
Gepackte Ganzzahlen: In VBA gibt es keinen direkten Weg, die Bytes eines Double als zwei Long zu lesen. Der übliche Umweg sind zwei benutzerdefinierte Typen gleicher Größe und LSet, wie im Beispiel. Die erste Zahl eines Paars steht in den unteren 4 Bytes. Die Hilfe verlangt vor dem Aufruf IGetTrimCurveSize2. Diesen Befehl gibt es nur für C++. In VBA rufst du GetTrimCurves2 direkt auf.
Schleifen: Eine Fläche hat meist eine Außenschleife und keine oder mehrere Innenschleifen (Löcher). Außenschleifen kommen zuerst, wenn möglich. Sicher erkennst du sie nur mit Loop2.IsOuter.
Parametrisierung: Alle Kurven kommen als B-Splines im UV-Raum der Surface. Diese Parametrisierung kann von der anderer Befehle abweichen, etwa von Face2.GetUVBounds, Surface.Parameterization2 oder Edge.GetCurveParams3. Wie genau die Kurven angenähert werden, stellst du mit Modeler.GetToleranceValue und Modeler.SetToleranceValue ein.
Periodische Flächen: Reicht eine periodische Fläche über die Naht (0° bzw. 360°, etwa bei einem Zylinder), teilt der Befehl sie in mehrere Teilflächen. Der erste Aufruf liefert die erste, jeder weitere Aufruf an derselben Fläche die nächste. Wie viele es gibt, steht im letzten Wert des Arrays. Meist ist es besser, vorher mit Body2.GetProcessedBody2 eine aufbereitete Kopie des Körpers zu holen und deren Flächen auszuwerten. Dort sind periodische Flächen schon geteilt. Ob die Nummer der aktuellen Teilfläche bei 0 oder 1 beginnt, sagt die Hilfe nicht.
Kanten zu den Kurven: Rufst du Face2.GetEdges direkt nach GetTrimCurves2 an derselben Fläche auf, kommen die Kanten in der Reihenfolge der Kurven. Dafür legt GetTrimCurves2 einen Zwischenspeicher an, den der nächste Aufruf von GetEdges verbraucht. Holst du erst die Kurven aller Flächen und danach die Kanten, passt nichts zusammen. Ruf GetEdges deshalb in derselben Schleife direkt danach auf. Nicht jede Kurve hat eine Kante, etwa an der Naht eines Zylinders. Das merkst du, wenn Face2.GetEdgeCount kleiner ist als die Anzahl der Kurven aus dem Kopf.
Topologie: Teilkanten und Eckpunkte passend zu den Kurven liefern Face2.GetTrimCurveTopology und Face2.GetTrimCurveTopologyTypes. Auch sie brauchen den vorherigen Aufruf von GetTrimCurves2.
Periodisch bei Kurven: Eine Kurve kann als periodisch gekennzeichnet sein, obwohl ihre Daten im nicht periodischen Format kommen. Das gilt für geschlossene, tangential stetige Kurven wie einen Kreis als Rand eines Flächenkörpers. Rechne die Anzahl der Knoten deshalb immer als Ordnung plus Anzahl der Kontrollpunkte, wie im Beispiel.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2001Plus
Englisches Original: IFace2::GetTrimCurves2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.