Methode · Modeler
CreateBsplineSurface-Methode (Modeler)
Erzeugt eine B-Spline-Fläche (Surface) aus Ordnungen, Knoten und Kontrollpunkten.
Syntax
Function CreateBsplineSurface( _
ByVal Props As Variant, _
ByVal UKnots As Variant, _
ByVal VKnots As Variant, _
ByVal CtrlPtCoords As Variant _
) As ObjectSet swFlaeche = swModeler.CreateBsplineSurface(dProps, dUKnoten, dVKnoten, dPunkte)Parameter
PropsVariantByVal- Acht ganze Zahlen, gepackt in vier
Double-Werte, siehe Bemerkungen. UKnotsVariantByValDouble-Array mit dem Knotenvektor in U, Anzahl der Kontrollpunkte in U + Ordnung in U Werte.VKnotsVariantByValDouble-Array mit dem Knotenvektor in V, Anzahl der Kontrollpunkte in V + Ordnung in V Werte.CtrlPtCoordsVariantByValDouble-Array mit den Koordinaten der Kontrollpunkte, Anzahl in U × Anzahl in V × Dimension Werte.
Rückgabewert
Die B-Spline-Fläche (Surface).
Beispiel
' swModeler ist der Modeler (SldWorks.GetModeler).
' Packen(a, b) packt zwei Long in ein Double, siehe das Beispiel zu Modeler.CreateBsplineCurve.
Dim swFlaeche As SldWorks.Surface
Dim dProps(3) As Double, dU(3) As Double, dV(3) As Double, dPunkte(11) As Double
dProps(0) = Packen(2, 2) ' Ordnung in U und in V
dProps(1) = Packen(2, 2) ' Kontrollpunkte in V und in U
dProps(2) = Packen(0, 0) ' nicht periodisch
dProps(3) = Packen(3, 0) ' Dimension 3, ungenutzt
dU(2) = 1: dU(3) = 1: dV(2) = 1: dV(3) = 1 ' Knoten 0, 0, 1, 1
dPunkte(3) = 0.1 ' (0/0/0), (100/0/0),
dPunkte(7) = 0.1 ' (0/100/0),
dPunkte(9) = 0.1: dPunkte(10) = 0.1 ' (100/100/0) mm
Set swFlaeche = swModeler.CreateBsplineSurface(dProps, dU, dV, dPunkte)
If Not swFlaeche Is Nothing Then Debug.Print "B-Spline-Fläche: " & (swFlaeche.Identity = BSURF_TYPE)Bemerkungen
Props enthält diese Paare, als ganze Zahlen in vier Double-Werte gepackt:
- Ordnung in U, Ordnung in V
- Anzahl der Kontrollpunkte in V, Anzahl in U (in dieser Reihenfolge)
- Periodizität in U, in V
- Dimension der Kontrollpunkte, ein ungenutzter Wert
0
Wie ein Paar in einem Double steckt, steht bei Modeler.CreateBsplineCurve. Stammen die Daten aus Surface.GetBSurfParams3, ist die Reihenfolge der UV-Kontrollpunkte vertauscht. Statt die Punkte umzusortieren, vertauschst du die U- und V-Knoten und die zugehörigen Werte. In welcher Reihenfolge die Kontrollpunkte stehen, sagt die Hilfe nicht. Beim Quadrat im Beispiel spielt das keine Rolle.
Periodisch: Der erste Knoten muss dann die Vielfachheit 1 haben, die übrige Vielfachheit gehört an den letzten Knoten, etwa { 0, 1, 2, 3, 3, 3 } bei einer kubischen Kurve. Der Kontrollpunkt auf der Naht steht nur am Anfang, nicht an beiden Enden. Eine geklemmte periodische Kurve wandelst du um, indem du am Anfang alle Knoten bis auf einen und am Ende einen Knoten entfernst und den letzten Kontrollpunkt weglässt.
Dasselbe für einen Körper im Aufbau bietet Body2.CreateBsplineSurface.
Siehe auch
Verfügbarkeit
In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.
Englisches Original: IModeler::CreateBsplineSurface in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.