SolidWorksMakroprogrammierung

Objekt · SldWorks

RefPlane-Objekt

Eine Referenzebene: ihre Lage im Raum als Transformation, ihre Eckpunkte und ihr umgebender Rahmen.

Deklaration Dim x As SldWorks.RefPlane · in der englischen .NET-Hilfe: IRefPlane

Beschreibung

RefPlane gibt Zugriff auf Referenzebenen. Eine Referenzebene ist eine Ebene im FeatureManager, etwa eine der drei Standardebenen (vorne, oben, rechts) oder eine Ebene, die du im Abstand, im Winkel oder durch Punkte angelegt hast. Auf ihr liegen Skizzen, und viele Features und Verknüpfungen nehmen sie als Bezug, etwa Spiegelungen, Muster und Verknüpfungen.

Zum Feature einer Referenzebene gibt es zwei Objekte:

Die Befehle gibt es seit SOLIDWORKS 2004 SP04 (Transform), 2005 (BoundingBox) und 2009 SP05 (CornerPoints).

Zugriff

Beispiel

' Geht alle Features des aktiven Modells durch und gibt für jede Referenzebene
' ihren Ursprung in Millimeter und ihre Normale aus.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen.
' Ergebnis:     Die Ebenen stehen im Direktfenster, das Modell bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swMathUtil As SldWorks.MathUtility
    Dim swFeat As SldWorks.Feature
    Dim swEbene As SldWorks.RefPlane
    Dim swXform As SldWorks.MathTransform
    Dim swPunkt As SldWorks.MathPoint
    Dim swVektor As SldWorks.MathVector
    Dim dNull(2) As Double
    Dim dZ(2) As Double
    Dim vP As Variant
    Dim vN As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swMathUtil = swApp.GetMathUtility
    dZ(2) = 1

    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        If swFeat.GetTypeName2 = "RefPlane" Then
            Set swEbene = swFeat.GetSpecificFeature2
            Set swXform = swEbene.Transform
            Set swPunkt = swMathUtil.CreatePoint(dNull)
            Set swPunkt = swPunkt.MultiplyTransform(swXform)
            Set swVektor = swMathUtil.CreateVector(dZ)
            Set swVektor = swVektor.MultiplyTransform(swXform)
            vP = swPunkt.ArrayData
            vN = swVektor.ArrayData
            Debug.Print swFeat.Name & ": Ursprung (" & Format(vP(0) * 1000, "0.00") & ", " & _
                Format(vP(1) * 1000, "0.00") & ", " & Format(vP(2) * 1000, "0.00") & ") mm, Normale (" & _
                Format(vN(0), "0.000") & ", " & Format(vN(1), "0.000") & ", " & Format(vN(2), "0.000") & ")"
        End If
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Typname: Referenzebenen haben nach Feature.GetTypeName2 den Typnamen RefPlane. Für die drei Standardebenen gilt derselbe, dazu passt die Art swRefPlaneSWStandard aus swRefPlaneType_e. Für diesen Typnamen nennt die Hilfe RefPlane und RefPlaneFeatureData, je nachdem, ob du Feature.GetSpecificFeature2 oder Feature.GetDefinition aufrufst. Auch der Typname LiveSection liefert ein RefPlane.

Ursprung und Normale: Im Hilfebeispiel „Get the Normal and Origin of a Reference Plane Using Its Transform“ bringt RefPlane.Transform eine Ebene aus der Lage der vorderen Ebene in ihre tatsächliche Lage. Den Ursprung bekommst du deshalb aus dem Punkt (0, 0, 0), die Normale aus dem Vektor (0, 0, 1), beide mit MathPoint.MultiplyTransform und MathVector.MultiplyTransform umgerechnet. So macht es das Beispiel.

Ausgewählte Ebene: Die Hilfebeispiele wählen die Ebene mit ModelDocExtension.SelectByID2 und der Art PLANE aus, weisen das ausgewählte Objekt einer Variablen vom Typ Feature zu und rufen dann GetSpecificFeature2 auf. Die Namen der Standardebenen hängen von der Sprache der Vorlage ab.

Anlegen und Anzeigen: Neue Referenzebenen legst du mit FeatureManager.InsertRefPlane an. Die Anzeige der Referenzebenen schaltest du mit ModelDoc2.ViewDispRefplanes um.

Veraltet: GetRefPlaneParams ist durch RefPlane.Transform ersetzt.

Einheiten: Die Hilfebeispiele rechnen die Koordinaten mit * 1000 in Millimeter um, also Meter.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
BoundingBoxLiefert den umgebenden Rahmen der Referenzebene als zwei Punkte: oben links und unten rechts.
CornerPointsLiefert die vier Eckpunkte der Referenzebene.
TransformLiefert die Transformation der Referenzebene bezogen auf das Weltkoordinatensystem, daraus bekommst du Ursprung und Normale.

Methoden 1, davon 0 beschrieben, 1 veraltet

NameBeschreibung
GetRefPlaneParamsveraltet ersetzt durch RefPlane.Transform

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

Siehe auch

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

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