SolidWorksMakroprogrammierung

Eigenschaft · RefPlane

Transform-Eigenschaft (RefPlane)

Liefert die Transformation der Referenzebene bezogen auf das Weltkoordinatensystem, daraus bekommst du Ursprung und Normale.

Syntax

Property Transform As MathTransform
Set swXform = swEbene.Transform

Wert

Die Transformation als MathTransform.

Die Eigenschaft ist nur lesbar.

Beispiel

' swApp ist SOLIDWORKS (SldWorks), swEbene eine Referenzebene (RefPlane).
Dim swMathUtil As SldWorks.MathUtility
Dim swXform As SldWorks.MathTransform
Dim swPunkt As SldWorks.MathPoint
Dim swVektor As SldWorks.MathVector
Dim dNull(2) As Double, dZ(2) As Double
Dim vXyz As Variant
Set swMathUtil = swApp.GetMathUtility
Set swXform = swEbene.Transform
dZ(2) = 1
Set swPunkt = swMathUtil.CreatePoint(dNull)
Set swPunkt = swPunkt.MultiplyTransform(swXform)
Set swVektor = swMathUtil.CreateVector(dZ)
Set swVektor = swVektor.MultiplyTransform(swXform)
vXyz = swPunkt.ArrayData
Debug.Print "Ursprung: (" & vXyz(0) * 1000 & ", " & vXyz(1) * 1000 & ", " & vXyz(2) * 1000 & ") mm"
vXyz = swVektor.ArrayData
Debug.Print "Normale:  (" & vXyz(0) & ", " & vXyz(1) & ", " & vXyz(2) & ")"

Bemerkungen

Im Hilfebeispiel „Get the Normal and Origin of a Reference Plane Using Its Transform“ bringt die Transformation eine Ebene aus ihrer Ausgangslage, der Lage der vorderen Ebene (Ursprung im Nullpunkt, Normale in Z-Richtung), in ihre tatsächliche Lage. Den Ursprung bekommst du deshalb, indem du den Punkt (0, 0, 0) transformierst, die Normale aus dem Vektor (0, 0, 1). So macht es das Beispiel hier.

Das Hilfebeispiel „Get Transform of Plane“ gibt dagegen die Einträge von MathTransform.ArrayData direkt aus und nennt als Ursprung die Verschiebung (Einträge 9 bis 11) mit umgekehrtem Vorzeichen. Das passt nicht zum anderen Beispiel, dort ist der Ursprung die Verschiebung selbst. Die Hilfe klärt das nicht. Die Hilfebeispiele rechnen die Längen in Meter.

Die Eigenschaft ersetzt die veraltete Methode GetRefPlaneParams.

Der Weg über den transformierten Punkt (0, 0, 0) liefert den richtigen Ursprung, die Verschiebung ist also ohne Vorzeichenumkehr der Ursprung.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2004 SP04

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

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