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 ObjectSet 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. KnotsVariantByValDouble-Array mit dem Knotenvektor, siehe Bemerkungen.CtrlPtCoordsVariantByValDouble-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.IsTrimmedCurveBemerkungen
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:
2für nicht rationale Kurven (U, V),3für rationale (U, V, Gewicht, Gewichte positiv) - Ordnung: Grad + 1, mindestens
2 - Anzahl der Kontrollpunkte: mindestens so groß wie die Ordnung
- Periodizität:
1periodisch,0nicht 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.