Objekt · SldWorks
SketchSpline-Objekt
Ein Spline in einer Skizze mit seinen Punkten, Splinegriffen, Anzeigeoptionen und, bei gleichungsgesteuerten Kurven, der Gleichung.
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
SketchManager.CreateSpline3undSketchManager.CreateEquationSpline2: liefern den neuen Spline als SketchSegmentSketch.GetSketchSegmentsundSketchSegment.GetType=swSketchSPLINE, dann einer Variablen vom Typ SketchSpline zuweisenSelectionMgr.GetSelectedObject6: ein ausgewählter Spline, so in den Hilfebeispielen
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CurveDegree | Liest oder setzt den Grad eines Stil-Splines, der eine Bezierkurve ist. |
| CurveType | Liest oder setzt den Kurventyp eines Stil-Splines: Bezierkurve oder B-Spline vom Grad 3, 5 oder 7. |
| DisplayControlPolygon | Liest oder setzt, ob am Spline das Kontrollpolygon angezeigt wird. |
| IsRationalCurve | Liefert, ob der Spline rational ist. |
| IsStyleSpline | Liefert, ob der Spline ein Stil-Spline ist. |
| Proportional | Liest oder setzt, ob sich der Spline beim Ziehen eines Endpunkts proportional ändert. |
| ShowCurvatureCombs | Liest oder setzt, ob am Spline Krümmungskämme angezeigt werden. |
| ShowInflectionPoints | Liest oder setzt, ob am Spline die Wendepunkte angezeigt werden. |
| ShowMinimumRadius | Liest oder setzt, ob am Spline der kleinste Krümmungsradius angezeigt wird. |
| ShowSplineHandles | Liest oder setzt, ob die Splinegriffe angezeigt werden. |
Methoden 21, davon 18 beschrieben, 3 veraltet
| Name | Beschreibung |
|---|---|
| AddCurvatureControl | Fügt dem Spline an einem Punkt einen Krümmungsgriff hinzu. |
| AddTangencyControl | Fügt dem Spline an einem Punkt einen Griff hinzu, mit dem du die Tangente steuerst. |
| DeletePoint | Löscht einen Punkt des Splines. |
| GetControlVertexWeights | Liefert die Gewichte der Kontrollpunkte eines rationalen Splines. |
| GetEquationParameters | veraltet ersetzt durch SketchSpline.GetEquationParameters2 |
| GetEquationParameters2 | Liefert die Gleichung und die übrigen Parameter einer gleichungsgesteuerten Kurve. |
| GetPointCount | Liefert die Zahl der Punkte des Splines. |
| GetPoints | veraltet ersetzt durch SketchSpline.GetPoints2 |
| GetPoints2 | Liefert die Punkte des Splines als Skizzenpunkte. |
| GetSplineHandleCount | Liefert die Zahl der Splinegriffe des Splines. |
| GetSplineHandles | Liefert die Splinegriffe des Splines. |
| InsertPoint | Fügt dem Spline an einer Stelle auf dem Spline einen Punkt hinzu. |
| MakeRational | Macht den Spline rational oder nicht rational. |
| ModifyControlPoint | Setzt neue Koordinaten für einen Kontrollpunkt des Splines. |
| ModifyKnot | Ändert einen inneren Knoten des Splines. |
| RelaxSpline | Glättet einen Spline, der durch Ziehen an einem Punkt des Kontrollpolygons verändert wurde. |
| ResetAllHandles | Setzt alle Splinegriffe des Splines in ihren Ausgangszustand zurück. |
| SetControlVertexWeights | Setzt die Gewichte der Kontrollpunkte eines rationalen Splines. |
| SetEquationParameters | veraltet ersetzt durch SketchSpline.SetEquationParameters2 |
| SetEquationParameters2 | Setzt die Gleichung und die übrigen Parameter einer gleichungsgesteuerten Kurve. |
| Simplify | Verringert 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.