SolidWorksMakroprogrammierung

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 Object
Set swFlaeche = swModeler.CreateBsplineSurface(dProps, dUKnoten, dVKnoten, dPunkte)

Parameter

PropsVariantByVal
Acht ganze Zahlen, gepackt in vier Double-Werte, siehe Bemerkungen.
UKnotsVariantByVal
Double-Array mit dem Knotenvektor in U, Anzahl der Kontrollpunkte in U + Ordnung in U Werte.
VKnotsVariantByVal
Double-Array mit dem Knotenvektor in V, Anzahl der Kontrollpunkte in V + Ordnung in V Werte.
CtrlPtCoordsVariantByVal
Double-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.