Objekt · SldWorks
MathUtility-Objekt
Erzeugt die Rechenobjekte von SOLIDWORKS: Punkte, Vektoren und Transformationen.
Beschreibung
MathUtility ist die Fabrik für die Rechenobjekte der API. Neue Punkte (MathPoint), Vektoren (MathVector) und Transformationen (MathTransform) erzeugst du nur hier. Rechnen tust du dann mit den Befehlen dieser Objekte, etwa MathPoint.MultiplyTransform oder MathVector.Cross.
Zugriff
SldWorks.GetMathUtility: das einzige MathUtility-Objekt der Sitzung
Beispiel
' Dreht den Punkt (100 / 0 / 0) mm um 90 Grad um die Z-Achse durch den Ursprung.
' Vorbedingung: SOLIDWORKS läuft, ein Dokument ist nicht nötig.
' Ergebnis: Koordinaten im Direktfenster (Strg+G), etwa 0 / 100 / 0 mm.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swMathUtil As SldWorks.MathUtility
Dim swUrsprung As SldWorks.MathPoint
Dim swPunkt As SldWorks.MathPoint
Dim swAchse As SldWorks.MathVector
Dim swDrehung As SldWorks.MathTransform
Dim dNull(2) As Double, dPunkt(2) As Double, dAchse(2) As Double
Dim vErgebnis As Variant
Const PI As Double = 3.14159265358979
Set swApp = Application.SldWorks
Set swMathUtil = swApp.GetMathUtility
dPunkt(0) = 0.1
dAchse(2) = 1
Set swUrsprung = swMathUtil.CreatePoint(dNull)
Set swPunkt = swMathUtil.CreatePoint(dPunkt)
Set swAchse = swMathUtil.CreateVector(dAchse)
Set swDrehung = swMathUtil.CreateTransformRotateAxis(swUrsprung, swAchse, PI / 2)
Set swPunkt = swPunkt.MultiplyTransform(swDrehung)
vErgebnis = swPunkt.ArrayData
Debug.Print Format(vErgebnis(0) * 1000, "0.000") & " / " & _
Format(vErgebnis(1) * 1000, "0.000") & " / " & Format(vErgebnis(2) * 1000, "0.000") & " mm"
End SubBemerkungen
Alle Längen sind in Metern. Die Erzeugungsbefehle erwarten ein Double-Array, kein Variant-Array mit gemischten Werten. Ein Array Dim d(2) As Double hat genau die drei Werte X, Y, Z.
Dass Angle in MathUtility.CreateTransformRotateAxis im Bogenmaß gilt, sagt die Hilfe nicht ausdrücklich. Das Beispiel geht davon aus, wie überall in der API.
Eigenschaften und Methoden
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| ComposeTransform | Baut eine Transformation aus drei Achsen, einer Verschiebung und einem Maßstab. |
| CreatePoint | Erzeugt einen Punkt (MathPoint) aus drei Koordinaten. |
| CreateTransform | Erzeugt eine Transformation (MathTransform) aus 16 Zahlen. |
| CreateTransformRotateAxis | Erzeugt eine Transformation, die um eine Achse durch einen Punkt dreht. |
| CreateVector | Erzeugt einen Vektor (MathVector) aus drei Komponenten. |
Nicht aufgeführt sind 4 C++-Varianten (Namen mit I davor, zum Beispiel ICreatePoint). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IMathUtility in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.