SolidWorksMakroprogrammierung

Methode · Modeler

CreateLoftBody2-Methode (Modeler)

Erzeugt einen Ausformungskörper (Loft) aus Profilskizzen, Leitkurven und Mittellinie als temporären Körper.

Syntax

Function CreateLoftBody2( _
   ByVal PModDoc As ModelDoc2, _
   ByVal Profile As Variant, _
   ByVal GuideCurve As Variant, _
   ByVal Centerline As Object, _
   ByVal IsThinBody As Boolean, _
   ByVal ThinType As Long, _
   ByVal Thickness1 As Double, _
   ByVal Thickness2 As Double, _
   ByVal FeatureScope As Boolean, _
   ByVal IsBlendClosed As Boolean, _
   ByVal KeepTangency As Boolean, _
   ByVal ForceNonRational As Boolean, _
   ByVal IsSolidBody As Boolean, _
   ByVal TessTolFactor As Double, _
   ByVal StartTangentLength As Double, _
   ByVal EndTangentLength As Double, _
   ByVal StartTangentDir As Boolean, _
   ByVal EndTangentDir As Boolean, _
   ByVal StartMatchingType As Long, _
   ByVal EndMatchingType As Long, _
   ByVal Merge As Boolean _
) As Body2
Set swKoerper = swModeler.CreateLoftBody2(swModel, vProfile, vFuehrungen, Nothing, False, 0, 0, 0, True, False, True, False, True, 1, 1, 1, True, True, 1, 1, False)

Parameter

PModDocModelDoc2ByVal
Das Dokument (ModelDoc2), in dem der Körper entsteht.
ProfileVariantByVal
Array mit den Profilskizzen. Im Hilfebeispiel sind das die Skizzen als Feature.
GuideCurveVariantByVal
Array mit den Leitkurven. Im Hilfebeispiel eine 3D-Spline-Kurve als Feature.
CenterlineObjectByVal
Die Skizze mit der Mittellinie oder Nothing.
IsThinBodyBooleanByVal
True für einen Dünnwand-Körper, False nicht.
ThinTypeLongByVal
Art der Dünnwand: 0 eine Richtung, 1 eine Richtung umgekehrt, 2 mittig, 3 zwei Richtungen. Die Werte passen zu swThinWallType_e.
Thickness1DoubleByVal
Dicke in der ersten Richtung bei Dünnwand, vermutlich in Metern.
Thickness2DoubleByVal
Dicke in der zweiten Richtung bei Dünnwand.
FeatureScopeBooleanByVal
True: Der Körper wirkt nur auf ausgewählte Körper, False: auf alle.
IsBlendClosedBooleanByVal
True für eine geschlossene Ausformung, False für eine offene. Bei True und weniger als drei Profilen müssen die Leitkurven geschlossen sein.
KeepTangencyBooleanByVal
True: Sind die Profilkurven tangential, werden auch die entstehenden Flächen tangential. False nicht. SOLIDWORKS erhält dabei ebene und zylindrische Flächen, wenn die Profile so geformt sind.
ForceNonRationalBooleanByVal
True erzwingt eine nicht rationale Fläche, False nicht.
IsSolidBodyBooleanByVal
True liefert einen Volumenkörper, False einen Flächenkörper.
TessTolFactorDoubleByVal
Faktor für die Zahl der Zwischenschnitte bei einer Ausformung mit Mittellinie. 1.0 ist die Vorgabe, größere Werte erzeugen mehr Zwischenschnitte.
StartTangentLengthDoubleByVal
Tangentenlänge am Anfang.
EndTangentLengthDoubleByVal
Tangentenlänge am Ende.
StartTangentDirBooleanByVal
True die eine Richtung, False die Gegenrichtung, am Anfang.
EndTangentDirBooleanByVal
True die eine Richtung, False die Gegenrichtung, am Ende.
StartMatchingTypeLongByVal
Tangentialität am Anfangsprofil: 0 keine, 1 tangential zur Normalen des Profils, 2 tangential zu einem gewählten Vektor, 3 tangential zu allen angrenzenden Flächen.
EndMatchingTypeLongByVal
Tangentialität am Endprofil, Werte wie bei StartMatchingType.
MergeBooleanByVal
True vereinigt die Ergebnisse in einem Mehrkörperteil, False nicht.

Rückgabewert

Der Ausformungskörper (Body2).

Beispiel

' swModeler ist der Modeler (SldWorks.GetModeler), swModel das Teil (ModelDoc2).
' swProfil1 und swProfil2 sind geschlossene Profilskizzen, swFuehrung eine Leitkurve, je als Feature.
Dim swProfile(1) As SldWorks.Feature, swFuehrungen(0) As SldWorks.Feature
Dim swKoerper As SldWorks.Body2
Set swProfile(0) = swProfil1
Set swProfile(1) = swProfil2
Set swFuehrungen(0) = swFuehrung
Set swKoerper = swModeler.CreateLoftBody2(swModel, swProfile, swFuehrungen, Nothing, False, 0, 0, 0, _
    True, False, True, False, True, 1, 1, 1, True, True, 1, 1, False)
If Not swKoerper Is Nothing Then Debug.Print "Temporär: " & swKoerper.IsTemporaryBody

Bemerkungen

Leitkurven und Mittellinie sind freiwillig. Leitkurven sind aber besser, vor allem wenn du die Profile im FeatureManager auswählst. Die Profile übergibst du in der Reihenfolge, in der die Ausformung laufen soll. Für einen Volumenkörper müssen sie geschlossen sein. Du kannst beliebig viele Profile übergeben, bei nur einem Profil müssen die Leitkurven geschlossen sein. Als Richtung für die Tangentialität zu einem Vektor eignen sich gerade Kanten, Skizzenlinien, Achsen, Ebenen und ebene Flächen.

Das Hilfebeispiel „Create Loft Body“ legt zwei Kreisskizzen und eine 3D-Spline-Kurve an, holt sie über die Auswahl als Feature und zeigt den Körper mit Body2.Display3 an. Mit Body2.IsTemporaryBody prüft es, ob der Körper temporär ist, und listet die Features auf, um zu zeigen, dass keine Ausformung als Feature entstanden ist. Das Hilfebeispiel „Create Loft Surface Body and Change Into Feature“ erzeugt mit IsSolidBody = False einen Flächenkörper und macht daraus mit PartDoc.CreateSurfaceFeatureFromBody ein Feature.

Die Werte für ThinType und die Tangentialität nennt die Hilfe nur als Zahlen. Sie passen zu swThinWallType_e und zu den ersten vier Werten von swTangencyType_e. Ob du die Konstanten hier verwenden kannst, sagt die Hilfe nicht. Einheiten für Dicken und Tangentenlängen nennt sie nicht, vermutlich Meter.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2010

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

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