SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchSpline-Objekt

Ein Spline in einer Skizze mit seinen Punkten, Splinegriffen, Anzeigeoptionen und, bei gleichungsgesteuerten Kurven, der Gleichung.

Deklaration Dim x As SldWorks.SketchSpline · in der englischen .NET-Hilfe: ISketchSpline

Beschreibung

SketchSpline gibt Zugriff auf gezeichnete Splines. Ein Spline ist zugleich ein SketchSegment und ein SketchSpline. Was alle Skizzenelemente gemeinsam haben, liegt auf SketchSegment, was nur Splines haben, liegt hier. Die meisten Befehle gibt es seit SOLIDWORKS 2007.

Zugriff

Beispiel

' Gibt die Punkte und Splinegriffe des ausgewählten Splines aus und blendet die Griffe ein.
' Vorbedingung: Ein Teil mit einer Skizze ist offen, ein Spline der Skizze ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Splinegriffe sind sichtbar.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swSpline As SldWorks.SketchSpline
    Dim swPunkt As SldWorks.SketchPoint
    Dim swGriff As SldWorks.SplineHandle
    Dim vPunkte As Variant
    Dim vGriffe As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.SketchSpline Then Exit Sub
    Set swSpline = swSel

    Debug.Print IIf(swSpline.IsStyleSpline, "Stil-Spline", "Spline") & ", rational: " & swSpline.IsRationalCurve
    vPunkte = swSpline.GetPoints2
    If IsArray(vPunkte) Then
        For i = 0 To UBound(vPunkte)
            Set swPunkt = vPunkte(i)
            Debug.Print "Punkt " & i & ": " & Format(swPunkt.X * 1000, "0.00") & " / " & _
                        Format(swPunkt.Y * 1000, "0.00") & " mm"
        Next i
    End If
    vGriffe = swSpline.GetSplineHandles
    If IsArray(vGriffe) Then
        For i = 0 To UBound(vGriffe)
            Set swGriff = vGriffe(i)
            Debug.Print "Griff an Punkt " & swGriff.SplinePointNumber & ", Krümmung " & swGriff.Curvature
        Next i
    End If

    swSpline.ShowSplineHandles = True
    swModel.WindowRedraw
End Sub

Bemerkungen

Form ändern: Nach SketchSpline.ModifyControlPoint und SketchSpline.ModifyKnot rufst du ModelDoc2.ForceRebuild3 auf. Kontrollpunkte und Knoten liest du vorher über SplineParamData, das Curve.GetBCurveParams5 für die Kurve aus SketchSegment.GetCurve liefert. SketchSpline.Simplify braucht eine Skizze im Bearbeitungsmodus und einen vorher ausgewählten Spline.

Anzeige: Nach SketchSpline.ShowSplineHandles rufst du ModelDoc2.WindowRedraw auf. Für SketchSpline.DisplayControlPolygon verweist die Hilfe zusätzlich auf die Systemoption swSketchShowSplineControlPolygon.

Veraltet: GetPoints, GetEquationParameters und SetEquationParameters sind durch SketchSpline.GetPoints2, SketchSpline.GetEquationParameters2 und SketchSpline.SetEquationParameters2 ersetzt. Das Hilfebeispiel „Create Equation-driven Curve“ nutzt noch die veralteten Befehle.

Einheiten: Koordinaten sind Meter; die Hilfebeispiele rechnen mit 1000 in Millimeter um. Winkel der Gleichungskurven sind Bogenmaß.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
CurveDegreeLiest oder setzt den Grad eines Stil-Splines, der eine Bezierkurve ist.
CurveTypeLiest oder setzt den Kurventyp eines Stil-Splines: Bezierkurve oder B-Spline vom Grad 3, 5 oder 7.
DisplayControlPolygonLiest oder setzt, ob am Spline das Kontrollpolygon angezeigt wird.
IsRationalCurveLiefert, ob der Spline rational ist.
IsStyleSplineLiefert, ob der Spline ein Stil-Spline ist.
ProportionalLiest oder setzt, ob sich der Spline beim Ziehen eines Endpunkts proportional ändert.
ShowCurvatureCombsLiest oder setzt, ob am Spline Krümmungskämme angezeigt werden.
ShowInflectionPointsLiest oder setzt, ob am Spline die Wendepunkte angezeigt werden.
ShowMinimumRadiusLiest oder setzt, ob am Spline der kleinste Krümmungsradius angezeigt wird.
ShowSplineHandlesLiest oder setzt, ob die Splinegriffe angezeigt werden.

Methoden 21, davon 18 beschrieben, 3 veraltet

NameBeschreibung
AddCurvatureControlFügt dem Spline an einem Punkt einen Krümmungsgriff hinzu.
AddTangencyControlFügt dem Spline an einem Punkt einen Griff hinzu, mit dem du die Tangente steuerst.
DeletePointLöscht einen Punkt des Splines.
GetControlVertexWeightsLiefert die Gewichte der Kontrollpunkte eines rationalen Splines.
GetEquationParametersveraltet ersetzt durch SketchSpline.GetEquationParameters2
GetEquationParameters2Liefert die Gleichung und die übrigen Parameter einer gleichungsgesteuerten Kurve.
GetPointCountLiefert die Zahl der Punkte des Splines.
GetPointsveraltet ersetzt durch SketchSpline.GetPoints2
GetPoints2Liefert die Punkte des Splines als Skizzenpunkte.
GetSplineHandleCountLiefert die Zahl der Splinegriffe des Splines.
GetSplineHandlesLiefert die Splinegriffe des Splines.
InsertPointFügt dem Spline an einer Stelle auf dem Spline einen Punkt hinzu.
MakeRationalMacht den Spline rational oder nicht rational.
ModifyControlPointSetzt neue Koordinaten für einen Kontrollpunkt des Splines.
ModifyKnotÄndert einen inneren Knoten des Splines.
RelaxSplineGlättet einen Spline, der durch Ziehen an einem Punkt des Kontrollpolygons verändert wurde.
ResetAllHandlesSetzt alle Splinegriffe des Splines in ihren Ausgangszustand zurück.
SetControlVertexWeightsSetzt die Gewichte der Kontrollpunkte eines rationalen Splines.
SetEquationParametersveraltet ersetzt durch SketchSpline.SetEquationParameters2
SetEquationParameters2Setzt die Gleichung und die übrigen Parameter einer gleichungsgesteuerten Kurve.
SimplifyVerringert die Zahl der Punkte des Splines, damit Modelle mit komplexen Splines schneller werden.

Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IEnumPoints). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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