SolidWorksMakroprogrammierung

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 Variant
vDaten = swFace.GetTrimCurves2(True, False)

Parameter

WantCubicBooleanByVal
True: Die Kurven sollen kubisch sein. Zusätzlich liefert der Befehl die Surface der Fläche als B-Spline-Fläche (Bsurface). Mit True passen Kurven und Fläche besser zusammen, weil beide im selben Schritt entstehen.
WantNRationalBooleanByVal
True: 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“ (1 oder 0), dann ein Paar aus Dimension und Anzahl der Kontrollpunkte. Dimension 2 heißt nicht rational, 3 rational.
  • 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. 3 heißt nicht rational, 4 rational.
  • 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 Sub

Das 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.