Methode · Modeler
GetBodyOutline2-Methode (Modeler)
Liefert die Kurven, die in einer Blickrichtung den Umriss von Körpern bilden.
Syntax
Function GetBodyOutline2( _
ByVal BodyList As Variant, _
ByVal Direction As MathVector, _
ByVal Tolerance As Double, _
ByVal ProjectOnPlane As Boolean, _
ByRef Curves As Variant, _
ByRef TopolEntities As Variant, _
ByRef Outline As Variant _
) As LongnKurven = swModeler.GetBodyOutline2(vKoerper, swRichtung, 0.00001, True, vKurven, vElemente, vUmriss)Parameter
BodyListVariantByVal- Array mit den Körpern (
Body2). DirectionMathVectorByVal- Die Blickrichtung als
MathVector. ToleranceDoubleByVal- Die Toleranz. Die Vorgabe von Parasolid ist
0.00001. ProjectOnPlaneBooleanByValTrueprojiziert die Kurven auf eine Ebene,Falsenicht. Siehe Bemerkungen.CurvesVariantByRef · Rückgabe- Gibt die begrenzten 3D-Kurven (
Curve) des Umrisses zurück. TopolEntitiesVariantByRef · Rückgabe- Gibt je Kurve das topologische Element zum Umriss zurück, eine Kante (
Edge) oder eine Fläche (Face2), siehe Bemerkungen. OutlineVariantByRef · Rückgabe- Gibt ganze Zahlen zurück, die angeben, zu welchem Umriss jede Kurve gehört.
Rückgabewert
Die Anzahl der Kurven des Umrisses.
Beispiel
' swModeler ist der Modeler (SldWorks.GetModeler), swPart ein Teil (PartDoc) mit Volumenkörpern.
Dim swRichtung As SldWorks.MathVector
Dim swElement As Object
Dim vKoerper As Variant, vKurven As Variant, vElemente As Variant, vUmriss As Variant
Dim dRichtung(2) As Double
Dim n As Long, i As Long
vKoerper = swPart.GetBodies2(swSolidBody, True)
dRichtung(2) = -1
Set swRichtung = Application.SldWorks.GetMathUtility.CreateVector(dRichtung)
n = swModeler.GetBodyOutline2(vKoerper, swRichtung, 0.00001, False, vKurven, vElemente, vUmriss)
For i = 0 To n - 1
Set swElement = vElemente(i)
If TypeOf swElement Is SldWorks.Edge Then
Debug.Print "Umriss " & vUmriss(i) & ", Kurve " & i & ": Kante"
Else
Debug.Print "Umriss " & vUmriss(i) & ", Kurve " & i & ": Silhouette einer Fläche"
End If
Next iBemerkungen
Die Kurven ergeben beim Darstellen nicht immer einen geschlossenen Umriss. Um die Lücken zu schließen, rufst du den Befehl mit ProjectOnPlane = True auf und gleichst danach die Endpunkte benachbarter Kurven selbst an. So macht es das Hilfebeispiel „Get Body Outline“: Es holt Anfang und Ende jeder Kurve mit Curve.GetEndParams, setzt jeden Endpunkt auf die Mitte zum Nachbarn und zeichnet die Strecken in eine 3D-Skizze.
Das Hilfebeispiel „Get Curves that Form Outline of Bodies“ schaut mit (0, 0, −1) in Richtung der Vorderansicht, gruppiert die Kurven nach Outline und wertet TopolEntities aus: Eine Kante steht für eine echte Kante, eine Fläche für eine Silhouettenkante. Das Beispiel oben macht es genauso. Eine Einheit für die Toleranz nennt die Hilfe nicht, vermutlich Meter.
Für einen Volumenkörper liefert der Befehl wie im Beispiel aufgerufen 0 Kurven.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2012
Englisches Original: IModeler::GetBodyOutline2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.