Objekt · SldWorks
MathTransform-Objekt
Steht für eine Transformation: Drehung, Verschiebung und Maßstab, mit der du Punkte und Vektoren von einem Koordinatensystem in ein anderes umrechnest.
Beschreibung
Eine Transformation beschreibt, wie ein Koordinatensystem gegenüber einem anderen liegt. Typisch: Wo sitzt eine Komponente in der Baugruppe, oder wie liegt eine Skizze im Raum. Mit ihr rechnest du Punkte (MathPoint) und Richtungen (MathVector) um, mit MathPoint.MultiplyTransform und MathVector.MultiplyTransform.
Zugriff
Component2.Transform2: Lage einer Komponente in der BaugruppeSketch.ModelToSketchTransform: vom Modell in eine SkizzeModelDocExtension.GetCoordinateSystemTransformByName: Lage eines KoordinatensystemsMathUtility.CreateTransform: eine neue Transformation aus 16 Zahlen
Beispiel
' Rechnet den ersten Punkt der ausgewählten Skizze in Modellkoordinaten um.
' Vorbedingung: In einem Teil ist eine Skizze mit mindestens einem Skizzenpunkt ausgewählt.
' Ergebnis: Koordinaten im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeat As SldWorks.Feature
Dim swSketch As SldWorks.Sketch
Dim swMathUtil As SldWorks.MathUtility
Dim swXform As SldWorks.MathTransform
Dim swPunkt As SldWorks.MathPoint
Dim swSkPunkt As SldWorks.SketchPoint
Dim vPunkte As Variant, vErgebnis As Variant
Dim dPunkt(2) As Double
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swFeat = swModel.SelectionManager.GetSelectedObject6(1, -1)
If swFeat Is Nothing Then Exit Sub
Set swSketch = swFeat.GetSpecificFeature2
vPunkte = swSketch.GetSketchPoints2
If IsEmpty(vPunkte) Then Exit Sub
Set swSkPunkt = vPunkte(0)
' Skizze -> Modell ist die Umkehrung von Modell -> Skizze
Set swXform = swSketch.ModelToSketchTransform.Inverse
Set swMathUtil = swApp.GetMathUtility
dPunkt(0) = swSkPunkt.X: dPunkt(1) = swSkPunkt.Y: dPunkt(2) = swSkPunkt.Z
Set swPunkt = swMathUtil.CreatePoint(dPunkt)
Set swPunkt = swPunkt.MultiplyTransform(swXform)
vErgebnis = swPunkt.ArrayData
Debug.Print "Modell: " & vErgebnis(0) * 1000 & " / " & vErgebnis(1) * 1000 & " / " & vErgebnis(2) * 1000 & " mm"
End SubBemerkungen
Die 16 Zahlen von MathTransform.ArrayData: Index 0 bis 8 ist die Drehmatrix (3 × 3), Index 9 bis 11 die Verschiebung in Metern, Index 12 der Maßstab. Index 13 bis 15 werden nicht benutzt.
Neue Objekte: Alle Rechenbefehle ändern die Transformation nicht, sondern liefern ein neues Objekt. Neue Transformationen, Punkte und Vektoren erzeugst du mit MathUtility, das du über SldWorks.GetMathUtility bekommst.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| ArrayData | Liest oder setzt die 16 Zahlen einer Transformation: Drehung, Verschiebung und Maßstab. |
Methoden 5, davon 4 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| GetData | veraltet ersetzt durch MathTransform.GetData2 |
| GetData2 | Liefert Achsen, Verschiebung und Maßstab einer Transformation als Vektoren. |
| Inverse | Liefert die Umkehrung einer Transformation, also den Rückweg. |
| Multiply | Verknüpft zwei Transformationen zu einer, die beide hintereinander ausführt. |
| SetData | Setzt Achsen, Verschiebung und Maßstab einer Transformation aus Vektoren. |
Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IArrayData). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IMathTransform in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.