Objekt · SldWorks
RefPlane-Objekt
Eine Referenzebene: ihre Lage im Raum als Transformation, ihre Eckpunkte und ihr umgebender Rahmen.
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:
- RefPlane, das du mit
Feature.GetSpecificFeature2holst: die Ebene selbst mit ihrer Lage, ihren Eckpunkten und ihrem umgebenden Rahmen RefPlaneFeatureData, das du mitFeature.GetDefinitionholst: die Definition, also auf welche Referenzen sich die Ebene mit welchen Bedingungen, Winkeln und Abständen stützt
Die Befehle gibt es seit SOLIDWORKS 2004 SP04 (Transform), 2005 (BoundingBox) und 2009 SP05 (CornerPoints).
Zugriff
Feature.GetSpecificFeature2: beim Feature einer Referenzebene (TypnameRefPlane)FeatureManager.InsertRefPlane: legt eine neue Referenzebene an und liefert sieSketch.GetReferenceEntity: die Ebene, auf der eine Skizze liegt- Bei Features und Verknüpfungen, die eine Ebene verlangen, etwa
SymmetricMateFeatureData.SymmetryPlane,CoincidentMateFeatureData.EntitiesToMateundThreadFeatureData.StartEntity
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| BoundingBox | Liefert den umgebenden Rahmen der Referenzebene als zwei Punkte: oben links und unten rechts. |
| CornerPoints | Liefert die vier Eckpunkte der Referenzebene. |
| Transform | Liefert die Transformation der Referenzebene bezogen auf das Weltkoordinatensystem, daraus bekommst du Ursprung und Normale. |
Methoden 1, davon 0 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| GetRefPlaneParams | veraltet 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.