SolidWorksMakroprogrammierung

Methode · Modeler

ImprintingFaces-Methode (Modeler)

Prägt Werkzeugflächen auf Zielflächen eines anderen Körpers und liefert die Kanten und Eckpunkte dazu.

Syntax

Function ImprintingFaces( _
   ByVal TargetFaceArray As Variant, _
   ByVal ToolFaceArray As Variant, _
   ByVal Options As Long, _
   ByRef TargetEdges As Variant, _
   ByRef ToolEdges As Variant, _
   ByRef TargetVertices As Variant, _
   ByRef ToolVertices As Variant _
) As Boolean
bOk = swModeler.ImprintingFaces(vZielFlaechen, vWerkzeugFlaechen, swImprintingFacesOnTool, vZielKanten, vWerkzeugKanten, vZielEcken, vWerkzeugEcken)

Parameter

TargetFaceArrayVariantByVal
Array mit Flächen (Face2) des Zielkörpers.
ToolFaceArrayVariantByVal
Array mit Flächen (Face2) des Werkzeugkörpers.
OptionsLongByVal
Optionen aus swImprintingFacesOpts_e, mit Or verknüpft: swImprintingFacesOnTool (1), swImprintingFacesOnOverlapping (2), swImprintingFacesOnExtendFace (4). Die Hilfe beschreibt sie nur mit ihrem Namen.
TargetEdgesVariantByRef · Rückgabe
Gibt ein Array mit Kanten (Edge) des Zielkörpers zurück.
ToolEdgesVariantByRef · Rückgabe
Gibt ein Array mit Kanten des Werkzeugkörpers zurück.
TargetVerticesVariantByRef · Rückgabe
Gibt ein Array mit Eckpunkten (Vertex) des Zielkörpers zurück.
ToolVerticesVariantByRef · Rückgabe
Gibt ein Array mit Eckpunkten des Werkzeugkörpers zurück.

Rückgabewert

True, wenn die Operation geklappt hat, sonst False.

Beispiel

' swModeler ist der Modeler (SldWorks.GetModeler). swZiel und swWerkzeug sind zwei Körper (Body2),
' die sich schneiden, etwa temporäre Körper aus Modeler.CreateBodyFromBox3.
Dim vZielKanten As Variant, vWerkzeugKanten As Variant
Dim vZielEcken As Variant, vWerkzeugEcken As Variant
If swModeler.ImprintingFaces(swZiel.GetFaces, swWerkzeug.GetFaces, swImprintingFacesOnTool, _
        vZielKanten, vWerkzeugKanten, vZielEcken, vWerkzeugEcken) Then
    If IsArray(vZielKanten) Then Debug.Print UBound(vZielKanten) + 1 & " Kanten am Zielkörper"
End If

Bemerkungen

Ziel- und Werkzeugflächen müssen zu verschiedenen Körpern gehören und sich schneiden. Ob die zurückgegebenen Kanten und Eckpunkte nur die neu geprägten sind, sagt die Hilfe nicht, und sie hat kein Beispiel. Ob der Befehl die Körper selbst ändert und deshalb nur mit temporären Körpern geht, sagt sie ebenfalls nicht. Arbeite im Zweifel mit Kopien aus Body2.Copy2.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001

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

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