Objekt · SldWorks
MassProperty2-Objekt
Die Masseneigenschaften eines Teils, einer Baugruppe oder ausgewählter Körper und Komponenten: Masse, Volumen, Oberfläche, Dichte, Schwerpunkt und Trägheitsmomente, auf Wunsch überschrieben.
Beschreibung
MassProperty2 gibt Zugriff auf die einzelnen Masseneigenschaften, wie sie im Dialog „Masseneigenschaften“ stehen. Du erzeugst das Objekt mit ModelDocExtension.CreateMassProperty2. Im Teil rechnet es mit den vorher ausgewählten Körpern, in der Baugruppe mit den ausgewählten Komponenten. Ohne Auswahl rechnet es wie im Hilfebeispiel mit dem ganzen Modell. Die Befehle gibt es seit SOLIDWORKS 2020. MassProperty2 ersetzt das ältere MassProperty, die Unterschiede stehen in den Bemerkungen.
Zugriff
ModelDocExtension.CreateMassProperty2: die Masseneigenschaften des Teils oder der Baugruppe oder der vorher ausgewählten Körper oder Komponenten
Beispiel
' Gibt Masse, Volumen, Oberfläche, Dichte, Schwerpunkt, Hauptträgheitsmomente und
' Trägheitsmomente des aktiven Teils oder der Baugruppe aus, ausgeblendete Körper
' und Komponenten eingeschlossen.
' Vorbedingung: Ein Teil mit Volumenkörper oder eine Baugruppe ist offen.
' Ergebnis: Die Werte stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swMass As SldWorks.MassProperty2
Dim vPunkt As Variant
Dim vHaupt As Variant
Dim vMoment As Variant
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType = swDocDRAWING Then Exit Sub
swModel.ClearSelection2 True ' ohne Auswahl gilt das ganze Modell
Set swMass = swModel.Extension.CreateMassProperty2
If swMass Is Nothing Then
Debug.Print "Keine Masseneigenschaften verfügbar."
Exit Sub
End If
swMass.AccuracyLevel = swMassPropertyAccuracyLevel_Higher
swMass.IncludeHiddenBodiesOrComponents = True
swMass.Recalculate ' nach IncludeHiddenBodiesOrComponents nötig
vPunkt = swMass.CenterOfMass
vHaupt = swMass.PrincipalMomentsOfInertia
vMoment = swMass.GetMomentOfInertia(swMassPropertyMomentAboutCenterOfMass)
Debug.Print "Masse: " & Format(swMass.Mass, "0.000") & " kg"
Debug.Print "Volumen: " & Format(swMass.Volume * 1000000#, "0.00") & " cm³"
Debug.Print "Oberfläche: " & Format(swMass.SurfaceArea * 10000#, "0.00") & " cm²"
Debug.Print "Dichte: " & Format(swMass.Density, "0.0") & " kg/m³"
Debug.Print "Schwerpunkt: " & Format(vPunkt(0) * 1000#, "0.00") & ", " & _
Format(vPunkt(1) * 1000#, "0.00") & ", " & Format(vPunkt(2) * 1000#, "0.00") & " mm"
Debug.Print "Px, Py, Pz: " & vHaupt(0) & ", " & vHaupt(1) & ", " & vHaupt(2) & " kg·m²"
Debug.Print "Lxx, Lyy, Lzz am Schwerpunkt: " & vMoment(0) & ", " & vMoment(4) & ", " & vMoment(8) & " kg·m²"
End SubBemerkungen
MassProperty2 oder MassProperty: Das ältere MassProperty ist veraltet und durch MassProperty2 ersetzt. In Makros für SOLIDWORKS 2020 und neuer nimmst du deshalb MassProperty2. Die Unterschiede:
- Erzeugen: MassProperty2 mit
ModelDocExtension.CreateMassProperty2, MassProperty mit dem veraltetenModelDocExtension.CreateMassProperty. - Körper: MassProperty2 rechnet mit den ausgewählten Körpern oder Komponenten, die Liste änderst du mit
MassProperty2.SelectedItems. MassProperty rechnet mit allen Volumenkörpern, außer du gibst mit seiner Methode AddBodies bestimmte Körper vor, auch temporäre. - Überschreiben: MassProperty2 sammelt die Werte in
MassPropertyOverrideOptionsund übernimmt sie mitMassProperty2.SetOverrideOptionsundMassProperty2.Recalculate. MassProperty überschreibt mit eigenen Methoden, jede mit den Angaben zu den Konfigurationen. - Nur bei MassProperty2: Genauigkeit, ausgeblendete Körper und Komponenten, die Masse der Schweißraupen und das Neuberechnen.
- Nur bei MassProperty: AddBodies sowie SetAssignedMassProp und UserAssigned, die ältere Art, Masse und Schwerpunkt vorzugeben.
- Schreibweise: MassProperty2 schreibt PrincipalAxesOfInertia und PrincipalMomentsOfInertia, MassProperty schreibt PrincipleAxesOfInertia und PrincipleMomentsOfInertia.
MassProperty brauchst du noch für Makros, die auch in Versionen vor SOLIDWORKS 2020 laufen sollen. Ob MassProperty2.SelectedItems wie AddBodies temporäre Körper annimmt, sagt die Hilfe nicht.
Neu berechnen: Rufe MassProperty2.Recalculate auf, nachdem du Werte überschrieben oder MassProperty2.IncludeHiddenBodiesOrComponents geändert hast. Erst danach liefern MassProperty2.Mass, MassProperty2.CenterOfMass und die übrigen Eigenschaften die neuen Werte.
Einheiten: Ohne Zuweisung ist MassProperty2.UseSystemUnits True. Dann kommen die Werte in Systemeinheiten (Meter, Bogenmaß, Kilogramm), also Masse in kg, Längen in m, die Oberfläche in m², das Volumen in m³, die Dichte in kg/m³ und Trägheitsmomente in kg·m². Mit False gelten die Einheiten des Dokuments.
Körper in Baugruppen: Bei ModelDocExtension.CreateMassProperty2 steht: In einer Baugruppe lassen sich keine einzelnen Körper aus Mehrkörperteilen auswählen, nur Komponenten. Einen einzelnen Körper rechnest du mit Body2.GetMassProperties und einer Dichte, die du vorgibst.
Hilfebeispiel: „Get and Override Mass Properties“ öffnet die Baugruppe 98food processor.sldasm und überschreibt mit MassPropertyOverrideOptions Masse und Trägheitsmomente. Mit UseSystemUnits = False gibt es die Werte in den Einheiten des Dokuments aus, übergibt dann die Überschreibungen mit SetOverrideOptions und gibt die Werte nach Recalculate noch einmal aus.
Eigenschaften und Methoden
Eigenschaften 13, davon 13 beschrieben
| Name | Beschreibung |
|---|---|
| AccuracyLevel | Liest oder setzt die Genauigkeit, mit der die Masseneigenschaften berechnet werden. |
| CenterOfMass | Liefert den Schwerpunkt der ausgewählten Körper oder Komponenten. |
| Density | Liefert die Dichte der ausgewählten Körper oder Komponenten. |
| IncludeHiddenBodiesOrComponents | Liest oder setzt, ob ausgeblendete Körper und Komponenten in die Masseneigenschaften einfließen. |
| Mass | Liefert die Masse der ausgewählten Körper oder Komponenten. |
| PrincipalAxesOfInertia | Liefert die Richtung einer der drei Hauptträgheitsachsen. |
| PrincipalMomentsOfInertia | Liefert die drei Hauptträgheitsmomente. |
| SelectedItems | Liest oder setzt die Körper (im Teil) oder Komponenten (in der Baugruppe), deren Masseneigenschaften berechnet werden. |
| ShowWeldBeadMass | Liest oder setzt, ob die Masse der Schweißraupen berechnet wird. |
| SurfaceArea | Liefert die Oberfläche der ausgewählten Körper oder Komponenten. |
| UseSystemUnits | Liest oder setzt, ob die Masseneigenschaften in Systemeinheiten oder in den Einheiten des Dokuments geliefert werden. |
| Volume | Liefert das Volumen der ausgewählten Körper oder Komponenten. |
| WeldBeadMass | Liefert die Masse der Schweißraupen. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| GetMomentOfInertia | Liefert die Trägheitsmomente der ausgewählten Körper oder Komponenten, bezogen auf den Schwerpunkt oder auf das Koordinatensystem. |
| GetOverrideOptions | Liefert die Überschreibungen der Masseneigenschaften für die ausgewählten Körper oder Komponenten. |
| Recalculate | Berechnet die Masseneigenschaften der ausgewählten Körper oder Komponenten neu. |
| SetCoordinateSystem | Legt das Koordinatensystem fest, in dem die Masseneigenschaften berechnet werden. |
| SetOverrideOptions | Übernimmt die Überschreibungen der Masseneigenschaften für die ausgewählten Körper oder Komponenten in bestimmten Konfigurationen. |
Siehe auch
Englisches Original: IMassProperty2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.