SolidWorksMakroprogrammierung

Objekt · SldWorks

MathUtility-Objekt

Erzeugt die Rechenobjekte von SOLIDWORKS: Punkte, Vektoren und Transformationen.

Deklaration Dim x As SldWorks.MathUtility · in der englischen .NET-Hilfe: IMathUtility

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

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 Sub

Bemerkungen

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

NameBeschreibung
ComposeTransformBaut eine Transformation aus drei Achsen, einer Verschiebung und einem Maßstab.
CreatePointErzeugt einen Punkt (MathPoint) aus drei Koordinaten.
CreateTransformErzeugt eine Transformation (MathTransform) aus 16 Zahlen.
CreateTransformRotateAxisErzeugt eine Transformation, die um eine Achse durch einen Punkt dreht.
CreateVectorErzeugt 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.