Eigenschaft · MateEntity2
EntityParams-Eigenschaft (MateEntity2)
Liefert Punkt, Richtung und Radien eines Verknüpfungselements als Array mit acht Werten, im Koordinatensystem der Baugruppe.
Syntax
Property EntityParams As VariantvPar = swMateEnt.EntityParamsWert
Ein Array aus Double-Werten in dieser Reihenfolge:
0bis2: ein Punkt (X, Y, Z)3bis5: ein Vektor (I, J, K)6: erster Radius7: zweiter Radius
Welche Werte belegt sind, hängt von der Geometrie ab:
- Punkt: nur der Punkt
- Gerade: ein Punkt auf der Geraden, der Vektor ist ihre Richtung
- Ebene: ein Punkt auf der Ebene, der Vektor ist ihre Normale
- Zylinder: ein Punkt auf der Achse, der Vektor ist die Achse, dazu der erste Radius
- Kegel: ein Punkt auf der Achse, der Vektor ist die Achse, dazu beide Radien
Beispiel
' swMateEnt ist ein Element einer Verknüpfung (MateEntity2), etwa aus Mate2.MateEntity.
' Das Element sollte eine Zylinderfläche sein, etwa bei einer konzentrischen Verknüpfung.
Dim vPar As Variant
vPar = swMateEnt.EntityParams
Debug.Print "Punkt auf der Achse in mm: " & vPar(0) * 1000 & " / " & vPar(1) * 1000 & " / " & vPar(2) * 1000
Debug.Print "Achsrichtung: " & vPar(3) & " / " & vPar(4) & " / " & vPar(5)
Debug.Print "Radius in mm: " & vPar(6) * 1000Bemerkungen
Koordinatensystem: Alle Werte gelten im Koordinatensystem der Baugruppe, in der die Verknüpfung liegt. Liegt sie in einer Unterbaugruppe, ist das deren System, nicht das der obersten Baugruppe. Umrechnen kannst du dann mit Component2.Transform2 der Unterbaugruppe und MathPoint.MultiplyTransform.
Einheit: Die Hilfe nennt keine Einheit. In ihren Beispielen werden Punkt und Radien mit 1000 malgenommen und als Millimeter ausgegeben. Die Werte sind also in Metern: Radius 0,01 für einen Zylinder Ø 20 mm.
Immer acht Werte: Die Hilfe beschreibt das Array stets mit acht Stellen, und ihr Beispiel „Get Mate Definition“ prüft UBound = 7. Was in den Stellen steht, die für die Geometrie nicht belegt sind, sagt die Hilfe nicht. Ob der Vektor die Länge 1 hat und was die zwei Radien beim Kegel genau sind, ebenfalls nicht.
Welche Geometrie? Die Tabelle der Hilfe unterscheidet nach den Werten aus swMateEntityTypes_e. Kein aktueller Befehl liefert diese Werte. Die Art des Elements bekommst du über MateEntity2.ReferenceType2 (Fläche, Kante usw.). Ob eine Fläche eben, zylindrisch oder kegelig ist, prüfst du am Element selbst, etwa mit Face2.GetSurface und Surface.IsPlane, Surface.IsCylinder oder Surface.IsCone.
Die Eigenschaft ist nur lesbar.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2004
Englisches Original: IMateEntity2::EntityParams in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.