SolidWorksMakroprogrammierung

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 Long
nKurven = 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.
ProjectOnPlaneBooleanByVal
True projiziert die Kurven auf eine Ebene, False nicht. 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 i

Bemerkungen

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.