Eigenschaft · RefPlane
Transform-Eigenschaft (RefPlane)
Liefert die Transformation der Referenzebene bezogen auf das Weltkoordinatensystem, daraus bekommst du Ursprung und Normale.
Syntax
Property Transform As MathTransformSet swXform = swEbene.TransformWert
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.