SolidWorksMakroprogrammierung

Methode · Modeler

CreatePCurve-Methode (Modeler)

Erzeugt eine Kurve auf einer Surface aus einem B-Spline im UV-Raum dieser Surface (P-Kurve).

Syntax

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

Parameter

SurfaceObjectByVal
Die Surface (Surface), auf der die Kurve liegt.
PropsVariantByVal
Vier ganze Zahlen, gepackt in zwei Double-Werte: erst Dimension der Kontrollpunkte und Ordnung, dann Anzahl der Kontrollpunkte und Periodizität.
KnotsVariantByVal
Double-Array mit dem Knotenvektor, siehe Bemerkungen.
CtrlPtCoordsVariantByVal
Double-Array mit den Kontrollpunkten im UV-Raum der Surface, siehe Bemerkungen.

Rückgabewert

Die Kurve (Curve).

Beispiel

' swModeler ist der Modeler (SldWorks.GetModeler), swFace die ausgewählte Fläche (Face2).
' Packen(a, b) packt zwei Long in ein Double, siehe das Beispiel zu Modeler.CreateBsplineCurve.
Dim swKurve As SldWorks.Curve
Dim dProps(1) As Double, dKnoten(3) As Double, dPunkte(3) As Double
Dim vUV As Variant
vUV = swFace.GetUVBounds                     ' UMin, UMax, VMin, VMax
dProps(0) = Packen(2, 2)                     ' Dimension 2 (U, V), Ordnung 2
dProps(1) = Packen(2, 0)                     ' 2 Kontrollpunkte, nicht periodisch
dKnoten(2) = 1: dKnoten(3) = 1               ' Knoten 0, 0, 1, 1
dPunkte(0) = vUV(0): dPunkte(1) = vUV(2)     ' Ecke UMin, VMin
dPunkte(2) = vUV(1): dPunkte(3) = vUV(3)     ' Ecke UMax, VMax
Set swKurve = swModeler.CreatePCurve(swFace.GetSurface, dProps, dKnoten, dPunkte)
If Not swKurve Is Nothing Then Debug.Print "Begrenzt: " & swKurve.IsTrimmedCurve

Bemerkungen

Das Programmierhandbuch (Kapitel „Splines“) beschreibt P-Kurven als B-Splines, die auf einer Fläche liegen und aus B-Splines im Parameterraum der Fläche entstehen. Die Kontrollpunkte sind deshalb UV-Werte, keine Koordinaten im Raum. Das Hilfebeispiel nennt sie SP-Kurven (space parameter curve).

Props enthält Dimension der Kontrollpunkte, Ordnung, Anzahl der Kontrollpunkte und Periodizität. Das Hilfebeispiel „Create Space Parameter Curve on Surface“ erklärt sie so:

  • Dimension: 2 für nicht rationale Kurven (U, V), 3 für rationale (U, V, Gewicht, Gewichte positiv)
  • Ordnung: Grad + 1, mindestens 2
  • Anzahl der Kontrollpunkte: mindestens so groß wie die Ordnung
  • Periodizität: 1 periodisch, 0 nicht periodisch

Der Knotenvektor hat Anzahl der Kontrollpunkte + Ordnung Werte, nicht fallend. Die Koordinaten sind Anzahl der Kontrollpunkte × Dimension Werte. Das Hilfebeispiel packt die Zahlen mit LSet in die Double-Werte, wie das Beispiel zu Modeler.CreateBsplineCurve. Es übergibt allerdings zehn Knoten bei drei Kontrollpunkten und Ordnung 3, nach der Regel der Hilfe wären es sechs. Das Ergebnis prüft es mit Curve.IsTrimmedCurve und zeichnet die Kurve über Curve.GetTessPts als Linien in eine 3D-Skizze.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2004

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

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