SolidWorksMakroprogrammierung

Objekt · SldWorks

MathPoint-Objekt

Steht für einen Punkt im Raum, den du verschieben und in andere Koordinatensysteme umrechnen kannst.

Deklaration Dim x As SldWorks.MathPoint · in der englischen .NET-Hilfe: IMathPoint

Beschreibung

Ein MathPoint ist eine Position mit X, Y, Z in Metern. Du brauchst ihn vor allem, um Koordinaten mit einer Transformation (MathTransform) umzurechnen, etwa aus einer Skizze ins Modell oder aus einem Teil in die Baugruppe. Einige Befehle wie Surface.GetProjectedPointOn erwarten oder liefern Punkte in dieser Form.

Zugriff

Beispiel

' Rechnet den Ursprung der ausgewählten Komponente in Baugruppenkoordinaten um.
' Vorbedingung: In einer Baugruppe ist eine Komponente ausgewählt.
' Ergebnis:     Koordinaten im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swComp As SldWorks.Component2
    Dim swMathUtil As SldWorks.MathUtility
    Dim swPunkt As SldWorks.MathPoint
    Dim dPunkt(2) As Double
    Dim vDaten As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    Set swComp = swSelMgr.GetSelectedObjectsComponent4(1, -1)
    If swComp Is Nothing Then Exit Sub

    Set swMathUtil = swApp.GetMathUtility
    Set swPunkt = swMathUtil.CreatePoint(dPunkt)
    Set swPunkt = swPunkt.MultiplyTransform(swComp.Transform2)
    vDaten = swPunkt.ArrayData
    Debug.Print swComp.Name2 & ": Ursprung bei " & _
        vDaten(0) * 1000 & " / " & vDaten(1) * 1000 & " / " & vDaten(2) * 1000 & " mm"
End Sub

Bemerkungen

Alle Rechenbefehle ändern den Punkt nicht, sondern liefern ein neues Objekt. Bei einer Transformation wird ein Punkt gedreht, skaliert und verschoben, ein Vektor (MathVector) dagegen nur gedreht und skaliert.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
ArrayDataLiest oder setzt die Koordinaten eines Punkts.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AddVectorVerschiebt einen Punkt um einen Vektor und liefert den neuen Punkt.
ConvertToVectorMacht aus einem Punkt einen Vektor mit denselben drei Zahlen.
MultiplyTransformRechnet einen Punkt mit einer Transformation in ein anderes Koordinatensystem um.
ScaleMultipliziert die Koordinaten eines Punkts mit einer Zahl und liefert den neuen Punkt.
SubtractLiefert den Vektor zwischen zwei Punkten.
SubtractVectorVerschiebt einen Punkt entgegen einem Vektor und liefert den neuen Punkt.

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

Siehe auch

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

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