SolidWorksMakroprogrammierung

Objekt · SldWorks

SplineParamData-Objekt

Die Parameterdaten eines Splines: Dimension, Ordnung, Periodizität, Kontrollpunkte, Knotenvektor und bei P-Splines die Polynomsegmente.

Deklaration Dim x As SldWorks.SplineParamData · in der englischen .NET-Hilfe: ISplineParamData

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

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 Sub

Bemerkungen

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

NameBeschreibung
ColorLiefert die Farbe, mit der der Spline gezeichnet wird.
ControlPointsCountLiest oder setzt die Zahl der Kontrollpunkte des Splines.
DimensionLiest oder setzt die Dimension des Splines, also wie viele Werte jeder Kontrollpunkt hat.
KnotPointsCountLiefert die Zahl der Knoten des Splines.
LayerLiefert die Nummer des Layers, auf dem der Spline liegt.
LayerOverrideLiefert, welche Darstellungseigenschaften des Splines von den Vorgaben seines Layers abweichen.
LineStyleLiefert die Linienart, mit der der Spline gezeichnet wird.
LineWidthLiefert die Linienstärke, mit der der Spline gezeichnet wird.
OrderLiest oder setzt die Ordnung des Splines, also den Polynomgrad + 1.
PeriodicLiest oder setzt, ob der Spline offen oder geschlossen (periodisch) ist.
ReservedWird nicht benutzt.
SegmentCountLiefert die Zahl der Segmente eines P-Splines.

Methoden 5, davon 5 beschrieben

NameBeschreibung
GetControlPointsLiefert die Koordinaten aller Kontrollpunkte des Splines.
GetKnotPointsLiefert den Knotenvektor des Splines.
GetSegmentsLiefert die Koeffizienten aller Polynomsegmente eines P-Splines.
SetControlPointsSetzt die Koordinaten aller Kontrollpunkte des Splines.
SetKnotPointsSetzt 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.