Objekt · SldWorks
SplineParamData-Objekt
Die Parameterdaten eines Splines: Dimension, Ordnung, Periodizität, Kontrollpunkte, Knotenvektor und bei P-Splines die Polynomsegmente.
Beschreibung
SplineParamData gibt Zugriff auf die Parameterdaten eines Splines. Ein B-Spline ist durch seine Kontrollpunkte und den Knotenvektor bestimmt, dazu Dimension, Ordnung und Periodizität. Bei einem P-Spline (stückweise Polynome) liefert das Objekt stattdessen die Koeffizienten der Segmente. Du kannst die Daten lesen oder selbst füllen und daraus Splines in einer Skizze anlegen. Die Befehle gibt es seit SOLIDWORKS 2011.
Zugriff
Curve.GetBCurveParams5: die B-Spline-Daten einer KurveCurve.GetPCurveParams2: die P-Spline-Daten einer KurveSketch.GetSplineParams5: die Daten eines Splines in einer SkizzeSketchManager.CreateSplineParamData: leere Daten, die du füllst und anSketchManager.CreateSplinesByEqnParams2übergibst
Beispiel
' Gibt Dimension, Ordnung, Periodizität, Kontrollpunkte und Knoten des ausgewählten
' Skizzensplines aus.
' Vorbedingung: Ein Teil ist offen, ein Spline einer Skizze ist ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, die Skizze bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swSeg As SldWorks.SketchSegment
Dim swKurve As SldWorks.Curve
Dim swDaten As SldWorks.SplineParamData
Dim vPunkte As Variant, vKnoten As Variant
Dim nDim As Long, i As Long, j As Long
Dim sZeile As String
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
If swSel Is Nothing Then Exit Sub
If Not TypeOf swSel Is SldWorks.SketchSpline Then Exit Sub
Set swSeg = swSel
Set swKurve = swSeg.GetCurve
Set swDaten = swKurve.GetBCurveParams5(False, False, False, False)
If swDaten Is Nothing Then Exit Sub
nDim = swDaten.Dimension
Debug.Print "Dimension " & nDim & ", Ordnung " & swDaten.Order & ", periodisch " & swDaten.Periodic
If swDaten.GetControlPoints(vPunkte) Then
Debug.Print swDaten.ControlPointsCount & " Kontrollpunkte:"
For i = 0 To swDaten.ControlPointsCount - 1
sZeile = " "
For j = 0 To nDim - 1
sZeile = sZeile & Format(vPunkte(i * nDim + j), "0.000000") & " "
Next j
Debug.Print sZeile
Next i
End If
If swDaten.GetKnotPoints(vKnoten) Then
Debug.Print swDaten.KnotPointsCount & " Knoten, erster " & vKnoten(0) & ", letzter " & vKnoten(UBound(vKnoten))
End If
End SubBemerkungen
Kontrollpunkte und Knoten: Kontrollpunkte bestimmen die Form des Splines. Jeder Punkt des Splines ergibt sich aus den Basisfunktionen der nächsten Kontrollpunkte, der Knotenvektor legt fest, welche davon gelten. Die Zahl der Knoten hängt von der Periodizität ab: offen Kontrollpunkte + Ordnung, geschlossen Kontrollpunkte + 1.
Anlegen: Das Hilfebeispiel „Get Spline's Parameters“ holt mit SketchManager.CreateSplineParamData leere Daten, setzt Dimension, Ordnung, Periodizität und Zahl der Kontrollpunkte, übergibt Kontrollpunkte und Knoten und legt den Spline mit SketchManager.CreateSplinesByEqnParams2 an.
Einheiten: Die Koordinaten der Kontrollpunkte sind wie sonst in der API Meter. Das Hilfebeispiel setzt etwa 0.0254 und 0.0762. Die Knoten liegen zwischen 0 und 1.
Darstellung: Farbe, Linienart, Linienstärke und Layer sind nur lesbar. Layer gibt es nur in Zeichnungen.
Eigenschaften und Methoden
Eigenschaften 12, davon 12 beschrieben
| Name | Beschreibung |
|---|---|
| Color | Liefert die Farbe, mit der der Spline gezeichnet wird. |
| ControlPointsCount | Liest oder setzt die Zahl der Kontrollpunkte des Splines. |
| Dimension | Liest oder setzt die Dimension des Splines, also wie viele Werte jeder Kontrollpunkt hat. |
| KnotPointsCount | Liefert die Zahl der Knoten des Splines. |
| Layer | Liefert die Nummer des Layers, auf dem der Spline liegt. |
| LayerOverride | Liefert, welche Darstellungseigenschaften des Splines von den Vorgaben seines Layers abweichen. |
| LineStyle | Liefert die Linienart, mit der der Spline gezeichnet wird. |
| LineWidth | Liefert die Linienstärke, mit der der Spline gezeichnet wird. |
| Order | Liest oder setzt die Ordnung des Splines, also den Polynomgrad + 1. |
| Periodic | Liest oder setzt, ob der Spline offen oder geschlossen (periodisch) ist. |
| Reserved | Wird nicht benutzt. |
| SegmentCount | Liefert die Zahl der Segmente eines P-Splines. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| GetControlPoints | Liefert die Koordinaten aller Kontrollpunkte des Splines. |
| GetKnotPoints | Liefert den Knotenvektor des Splines. |
| GetSegments | Liefert die Koeffizienten aller Polynomsegmente eines P-Splines. |
| SetControlPoints | Setzt die Koordinaten aller Kontrollpunkte des Splines. |
| SetKnotPoints | Setzt den Knotenvektor des Splines. |
Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetControlPoints). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISplineParamData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.