SolidWorksMakroprogrammierung

Methode · Modeler

CreateBsplineCurve-Methode (Modeler)

Erzeugt eine B-Spline-Kurve aus Ordnung, Knoten und Kontrollpunkten.

Syntax

Function CreateBsplineCurve( _
   ByVal Props As Variant, _
   ByVal Knots As Variant, _
   ByVal CtrlPtCoords As Variant _
) As Object
Set swKurve = swModeler.CreateBsplineCurve(dProps, dKnoten, dPunkte)

Parameter

PropsVariantByVal
Vier ganze Zahlen, gepackt in zwei Double-Werte: erst Dimension der Kontrollpunkte und Ordnung, dann Anzahl der Kontrollpunkte und Periodizität. Siehe Bemerkungen.
KnotsVariantByVal
Double-Array mit dem Knotenvektor, Anzahl der Kontrollpunkte + Ordnung Werte.
CtrlPtCoordsVariantByVal
Double-Array mit den Koordinaten der Kontrollpunkte, siehe Bemerkungen.

Rückgabewert

Die B-Spline-Kurve (Curve).

Beispiel

' Die Typen und die Funktion Packen stehen oben im Modul.
Private Type DoubleRec
    dWert As Double
End Type

Private Type Long2Rec
    nErste As Long
    nZweite As Long
End Type

' Packt zwei Long in die 8 Bytes eines Double, die erste Zahl in die unteren 4 Bytes.
Private Function Packen(ByVal nErste As Long, ByVal nZweite As Long) As Double
    Dim lr As Long2Rec, dr As DoubleRec
    lr.nErste = nErste
    lr.nZweite = nZweite
    LSet dr = lr
    Packen = dr.dWert
End Function

Sub main()
    Dim swModeler As SldWorks.Modeler
    Dim swKurve As SldWorks.Curve
    Dim dProps(1) As Double, dKnoten(3) As Double, dPunkte(5) As Double
    Set swModeler = Application.SldWorks.GetModeler
    dProps(0) = Packen(3, 2)          ' Dimension 3, Ordnung 2 (Grad 1)
    dProps(1) = Packen(2, 0)          ' 2 Kontrollpunkte, nicht periodisch
    dKnoten(2) = 1: dKnoten(3) = 1    ' Knoten 0, 0, 1, 1
    dPunkte(3) = 0.1                  ' Punkte (0/0/0) und (100/0/0) mm
    Set swKurve = swModeler.CreateBsplineCurve(dProps, dKnoten, dPunkte)
    If Not swKurve Is Nothing Then Debug.Print "Länge: " & swKurve.GetLength3(0, 1) * 1000 & " mm"
End Sub

Bemerkungen

Props enthält vier ganze Zahlen: Dimension der Kontrollpunkte, Ordnung, Anzahl der Kontrollpunkte und Periodizität. Wie zwei Zahlen in einem Double stecken, zeigt das Hilfebeispiel zu Modeler.CreatePCurve: zwei Long in den 8 Bytes, die erste Zahl in den unteren 4 Bytes, kopiert mit LSet. Das Beispiel oben macht es genauso.

Der Knotenvektor hat Anzahl der Kontrollpunkte + Ordnung Werte. Für die Länge der Koordinaten nennt die Hilfe „Anzahl Kontrollpunkte + Dimension“. Gemeint ist „mal“, wie bei Modeler.CreatePCurve: In SOLIDWORKS 2024 ergaben Dimension 3, zwei Kontrollpunkte und sechs Koordinaten die Strecke von 100 mm aus dem Beispiel. Welche Dimension gilt, sagt die Hilfe hier nicht. 3 passt für nicht rationale Kurven (X, Y, Z); für rationale ist es vermutlich wie bei Curve.ConvertLineToBcurve 4 (X, Y, Z, Gewicht). Die Ordnung ist wie im Hilfebeispiel zu CreatePCurve der Grad + 1.

Die Spline-Daten einer vorhandenen Kurve liefert Curve.GetBCurveParams5. Für Flächen gibt es Modeler.CreateBsplineSurface.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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