SolidWorksMakroprogrammierung

Methode · Modeler

CreateArc-Methode (Modeler)

Erzeugt eine Kreisbogen-Kurve aus Mittelpunkt, Achse, Radius, Anfangs- und Endpunkt.

Syntax

Function CreateArc( _
   ByVal Center As Variant, _
   ByVal Axis As Variant, _
   ByVal Radius As Double, _
   ByVal StartPoint As Variant, _
   ByVal EndPoint As Variant _
) As Object
Set swBogen = swModeler.CreateArc(dMitte, dAchse, dRadius, dAnfang, dEnde)

Parameter

CenterVariantByVal
Double-Array mit X, Y, Z des Mittelpunkts.
AxisVariantByVal
Double-Array mit drei Werten X, Y, Z. Die Hilfe beschreibt ihn nicht näher, vermutlich die Achse (Normale) des Kreises, siehe Bemerkungen.
RadiusDoubleByVal
Der Radius in Metern.
StartPointVariantByVal
Double-Array mit X, Y, Z des Anfangspunkts.
EndPointVariantByVal
Double-Array mit X, Y, Z des Endpunkts.

Rückgabewert

Die Kurve (Curve).

Beispiel

' swModeler ist der Modeler (SldWorks.GetModeler).
Dim swBogen As SldWorks.Curve
Dim dMitte(2) As Double, dAchse(2) As Double, dAnfang(2) As Double, dEnde(2) As Double
dAchse(2) = 1                          ' Z-Achse
dAnfang(0) = 0.02: dEnde(0) = -0.02
Set swBogen = swModeler.CreateArc(dMitte, dAchse, 0.02, dAnfang, dEnde)
Debug.Print "Kreis: " & swBogen.IsCircle
Set swBogen = swBogen.CreateTrimmedCurve2(0.02, 0, 0, -0.02, 0, 0)
If Not swBogen Is Nothing Then Debug.Print "Begrenzt, Art " & swBogen.Identity

Bemerkungen

Bögen aus CreateArc und Geraden aus Modeler.CreateLine musst du mit Curve.CreateTrimmedCurve2 begrenzen, wenn du sie für Surface.CreateTrimmedSheet5 verwendest (die Hilfe nennt noch die ältere Fassung CreateTrimmedSheet4). Das Hilfebeispiel „Create Temporary Extruded Body“ begrenzt jeden Bogen gleich nach dem Erzeugen auf seinen Anfangs- und Endpunkt. Ob CreateArc ohne Begrenzen den ganzen Kreis liefert, sagt die Hilfe nicht.

Was Axis festlegt, sagt die Hilfe nicht. Im Hilfebeispiel ist sie für Bögen in der XY-Ebene (0, 0, −1), und die Bögen laufen um die Enden eines Langlochs herum. Vermutlich läuft der Bogen also nach der Rechte-Hand-Regel um die Achse vom Anfangs- zum Endpunkt.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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