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 ObjectSet 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. KnotsVariantByValDouble-Array mit dem Knotenvektor, Anzahl der Kontrollpunkte + Ordnung Werte.CtrlPtCoordsVariantByValDouble-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 SubBemerkungen
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.