SolidWorksMakroprogrammierung

Objekt · SldWorks

MathVector-Objekt

Steht für einen Vektor, also eine Richtung mit Länge, mit Befehlen für Skalar- und Kreuzprodukt.

Deklaration Dim x As SldWorks.MathVector · in der englischen .NET-Hilfe: IMathVector

Beschreibung

Ein MathVector ist eine Richtung mit Länge, zum Beispiel eine Flächennormale oder eine Achse. Anders als ein Punkt (MathPoint) wird ein Vektor bei einer Transformation nur gedreht, nicht verschoben.

Zugriff

Beispiel

' Rechnet den Winkel zwischen den Normalen der beiden ausgewählten ebenen Flächen.
' Vorbedingung: In einem Teil sind zwei ebene Flächen ausgewählt.
' Ergebnis:     Winkel im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swMathUtil As SldWorks.MathUtility
    Dim swN1 As SldWorks.MathVector, swN2 As SldWorks.MathVector
    Dim dSkalar As Double, dSinus As Double

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectCount2(-1) < 2 Then Exit Sub
    Set swMathUtil = swApp.GetMathUtility

    Set swN1 = swMathUtil.CreateVector(swSelMgr.GetSelectedObject6(1, -1).Normal).Normalise
    Set swN2 = swMathUtil.CreateVector(swSelMgr.GetSelectedObject6(2, -1).Normal).Normalise
    dSkalar = swN1.Dot(swN2)
    dSinus = swN1.Cross(swN2).GetLength
    ' Atn2-Ersatz: Winkel aus Sinus und Kosinus
    If dSkalar > 0 Then
        Debug.Print Format(Atn(dSinus / dSkalar) * 180 / PI, "0.00") & "°"
    ElseIf dSkalar < 0 Then
        Debug.Print Format((PI + Atn(dSinus / dSkalar)) * 180 / PI, "0.00") & "°"
    Else
        Debug.Print "90°"
    End If
End Sub

Bemerkungen

Alle Rechenbefehle ändern den Vektor nicht, sondern liefern ein neues Objekt. Face2.Normal liefert die Normale einer ebenen Fläche als Array, deshalb erzeugt das Beispiel daraus erst mit MathUtility.CreateVector einen MathVector. Den Winkel aus Skalar- und Kreuzprodukt zu rechnen ist auch bei fast parallelen Flächen genau. VBA kennt dafür kein Acos und kein Atan2.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
ArrayDataLiest oder setzt die drei Komponenten eines Vektors.

Methoden 9, davon 9 beschrieben

NameBeschreibung
AddAddiert zwei Vektoren und liefert das Ergebnis als neuen Vektor.
ConvertToPointMacht aus einem Vektor einen Punkt mit denselben drei Zahlen.
CrossLiefert das Kreuzprodukt zweier Vektoren, einen Vektor senkrecht auf beiden.
DotLiefert das Skalarprodukt zweier Vektoren.
GetLengthLiefert die Länge eines Vektors.
MultiplyTransformRechnet einen Vektor mit einer Transformation in ein anderes Koordinatensystem um.
NormaliseLiefert den Einheitsvektor, also denselben Vektor mit Länge 1.
ScaleMultipliziert einen Vektor mit einer Zahl und liefert das Ergebnis als neuen Vektor.
SubtractZieht einen Vektor von einem anderen ab und liefert das Ergebnis als neuen Vektor.

Nicht aufgeführt sind 8 C++-Varianten (Namen mit I davor, zum Beispiel IAdd). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

Englisches Original: IMathVector in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.