SolidWorksMakroprogrammierung

Objekt · SldWorks

Curve-Objekt

Steht für eine Kurve im Raum: Gerade, Kreis, Ellipse oder Spline, mit Parametern, Länge und Punkten.

Deklaration Dim x As SldWorks.Curve · in der englischen .NET-Hilfe: ICurve

Beschreibung

Eine Kurve ist die reine Geometrie hinter einer Edge oder einem Skizzenelement. Sie ist oft länger als die Kante, eine Gerade sogar unendlich. Welches Stück zur Kante gehört, liefert Edge.GetCurveParams3 als Parameterbereich von U.

Zugriff

Beispiel

' Gibt Art, Kenngrößen und Länge der Kurve hinter der ausgewählten Kante aus.
' Vorbedingung: In einem Teil ist eine Kante ausgewählt.
' Ergebnis:     Zeilen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swEdge As SldWorks.Edge
    Dim swCurve As SldWorks.Curve
    Dim swParam As SldWorks.CurveParamData
    Dim v As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelEDGES Then
        swApp.SendMsgToUser2 "Bitte zuerst eine Kante auswählen.", swMbWarning, swMbOk
        Exit Sub
    End If
    Set swEdge = swSelMgr.GetSelectedObject6(1, -1)
    Set swCurve = swEdge.GetCurve
    Set swParam = swEdge.GetCurveParams3

    If swCurve.IsLine Then
        v = swCurve.LineParams
        Debug.Print "Gerade, Richtung " & v(3) & " / " & v(4) & " / " & v(5)
    ElseIf swCurve.IsCircle Then
        v = swCurve.CircleParams
        Debug.Print "Kreis, Radius " & v(6) * 1000 & " mm"
    ElseIf swCurve.IsEllipse Then
        v = swCurve.GetEllipseParams
        Debug.Print "Ellipse, Halbachsen " & v(3) * 1000 & " und " & v(7) * 1000 & " mm"
    Else
        Debug.Print "Kurventyp " & swCurve.Identity
    End If
    Debug.Print "Länge der Kante: " & swCurve.GetLength3(swParam.UMinValue, swParam.UMaxValue) * 1000 & " mm"
End Sub

Bemerkungen

Reihenfolge der Prüfung: Curve.IsBcurve liefert auch für Schnittkurven, Ellipsen, getrimmte Kurven und SP-Kurven True. Prüfe darum zuerst auf Gerade, Kreis und Ellipse, wie im Beispiel.

Getrimmte Kurven: Liefert Curve.Identity TRIMMED_TYPE (3009), hängt eine Grundkurve dahinter, die du mit Curve.GetBaseCurve holst. Längen und Koordinaten sind in Metern.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
CircleParamsLiefert Mittelpunkt, Achse und Radius eines Kreises.
LineParamsLiefert einen Punkt und die Richtung einer Geraden.

Methoden 40, davon 31 beschrieben, 9 veraltet

NameBeschreibung
ApplyTransformVerschiebt, dreht oder skaliert eine Kurve mit einer Transformation.
ConvertArcToBcurveLiefert die B-Spline-Daten eines Kreisbogens aus Mittelpunkt, Achse, Anfangs- und Endpunkt.
ConvertLineToBcurveLiefert die B-Spline-Daten einer Strecke zwischen zwei Punkten.
CopyLiefert eine Kopie der Kurve.
CreateSurfaceCurveEin Befehl zu Kurven auf einer Fläche, den die Hilfe nur mit seiner Syntax nennt.
CreateTrimmedCurveveraltet ersetzt durch Curve.CreateTrimmedCurve2
CreateTrimmedCurve2Erzeugt aus einer Kurve das Stück zwischen zwei Punkten.
CreateWireBodyErzeugt aus einer Kurve einen Drahtkörper.
Evaluateveraltet ersetzt durch Curve.Evaluate2
Evaluate2Berechnet Punkt und Ableitungen einer Kurve an einer Stelle U.
ExtentCurveVerlängert eine B-Spline-Kurve am Anfang oder Ende um eine Länge.
FindMinimumRadiusSucht den kleinsten Krümmungsradius einer Kurve in einem Parameterbereich.
GetBaseCurveLiefert die Grundkurve einer getrimmten Kurve.
GetBCurveParamsveraltet ersetzt durch Curve.GetBCurveParams5
GetBCurveParams3veraltet ersetzt durch Curve.GetBCurveParams5
GetBCurveParams4veraltet ersetzt durch Curve.GetBCurveParams5
GetBCurveParams5Liefert die Spline-Daten einer Kurve: Grad, Kontrollpunkte und Knoten, als SplineParamData.
GetClosestPointOnLiefert den Punkt einer Kurve, der einem gegebenen Punkt am nächsten liegt, mit seinem Parameter.
GetEllipseParamsLiefert Mittelpunkt und Halbachsen einer Ellipse.
GetEndParamsLiefert den Parameterbereich einer Kurve und ob sie geschlossen und periodisch ist.
GetLengthveraltet ersetzt durch Curve.GetLength3
GetLength2veraltet ersetzt durch Curve.GetLength3
GetLength3Liefert die Länge einer Kurve zwischen zwei Parametern.
GetPCurveParamsveraltet ersetzt durch Curve.GetPCurveParams2
GetPCurveParams2Liefert die stückweise polynomiale Beschreibung einer Kurve als SplineParamData.
GetSplinePtsBerechnet die Punkte eines Splines aus gepackten Spline-Daten.
GetTessPtsLiefert Punkte entlang einer Kurve zwischen zwei Punkten, als Näherung durch Sehnen.
IdentityLiefert die Art einer Kurve als Zahl aus swCurveTypes_e.
IntersectCurveLiefert die Schnittpunkte zweier begrenzter Kurven.
IsBcurvePrüft, ob eine Kurve als B-Spline vorliegt, was auch für viele andere Kurvenarten gilt.
IsCirclePrüft, ob eine Kurve ein Kreis ist.
IsEllipsePrüft, ob eine Kurve eine Ellipse ist.
IsLinePrüft, ob eine Kurve eine Gerade ist.
IsTrimmedCurvePrüft, ob eine Kurve getrimmt ist, also nur ein Stück einer Grundkurve.
JoinCurvesVerbindet mehrere Kurven zu einer.
MakeBsplineCurveveraltet ersetzt durch Curve.MakeBsplineCurve2
MakeBsplineCurve2Erzeugt aus einer Kurve eine B-Spline-Kurve.
ReverseCurveLiefert eine Kopie der Kurve mit umgekehrter Richtung.
ReverseEvaluateLiefert den Parameter U zu einem Punkt auf der Kurve.
SimplifyBCurveVereinfacht eine B-Spline-Kurve innerhalb einer Toleranz.

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

Siehe auch

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

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