SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.MathTransform · in der englischen .NET-Hilfe: IMathTransform

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

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 Sub

Bemerkungen

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

NameBeschreibung
ArrayDataLiest oder setzt die 16 Zahlen einer Transformation: Drehung, Verschiebung und Maßstab.

Methoden 5, davon 4 beschrieben, 1 veraltet

NameBeschreibung
GetDataveraltet ersetzt durch MathTransform.GetData2
GetData2Liefert Achsen, Verschiebung und Maßstab einer Transformation als Vektoren.
InverseLiefert die Umkehrung einer Transformation, also den Rückweg.
MultiplyVerknüpft zwei Transformationen zu einer, die beide hintereinander ausführt.
SetDataSetzt 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.