Objekt · SldWorks
MassProperty-Objekt
Älteres, veraltetes Objekt für die Masseneigenschaften eines Teils, einer Baugruppe oder bestimmter Körper; Nachfolger ist MassProperty2.
Beschreibung
MassProperty ist veraltet und durch MassProperty2 ersetzt, das es seit SOLIDWORKS 2020 gibt. Die einzelnen Befehle führt die Hilfe aber ohne diesen Hinweis, und viele ältere Makros und Hilfebeispiele nutzen das Objekt. Es liefert die Masseneigenschaften wie im Dialog „Masseneigenschaften“ und überschreibt sie wie im Dialog „Override Mass Properties“. Es rechnet nur mit Volumenkörpern. Die meisten Befehle gibt es seit SOLIDWORKS 2003 SP02, SetAssignedMassProp und UserAssigned seit SOLIDWORKS 2005, die Befehle zum Überschreiben seit SOLIDWORKS 2013.
Zugriff
ModelDocExtension.CreateMassProperty: die Masseneigenschaften des Dokuments (veraltet)
In neuen Makros holst du stattdessen mit ModelDocExtension.CreateMassProperty2 ein MassProperty2.
Beispiel
' Berechnet Masse, Volumen und Schwerpunkt der Volumenkörper der ausgewählten
' Komponente, wie das Hilfebeispiel „Get Mass Properties of Multibody Assembly Component“.
' Vorbedingung: Eine Baugruppe ist offen, eine Komponente ist ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swComp As SldWorks.Component2
Dim swMass As SldWorks.MassProperty
Dim vKoerper As Variant
Dim vInfo As Variant
Dim vPunkt As Variant
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swComp = swModel.SelectionManager.GetSelectedObjectsComponent4(1, -1)
If swComp Is Nothing Then Exit Sub
Set swMass = swModel.Extension.CreateMassProperty
vKoerper = swComp.GetBodies3(swSolidBody, vInfo)
If Not IsArray(vKoerper) Then Exit Sub
If False = swMass.AddBodies((vKoerper)) Then ' doppelte Klammern wie im Hilfebeispiel
Debug.Print "Körper nicht übernommen"
Exit Sub
End If
vPunkt = swMass.CenterOfMass
Debug.Print "Komponente: " & swComp.Name2
Debug.Print "Masse: " & Format(swMass.Mass, "0.000") & " kg"
Debug.Print "Volumen: " & Format(swMass.Volume * 1000000000#, "0") & " mm³"
Debug.Print "Schwerpunkt: " & Format(vPunkt(0) * 1000#, "0.00") & ", " & _
Format(vPunkt(1) * 1000#, "0.00") & ", " & Format(vPunkt(2) * 1000#, "0.00") & " mm"
End SubBemerkungen
MassProperty oder MassProperty2: MassProperty ist veraltet, in Makros für SOLIDWORKS 2020 und neuer nimmst du MassProperty2. Die Unterschiede:
- Erzeugen: MassProperty mit dem veralteten
ModelDocExtension.CreateMassProperty, MassProperty2 mitModelDocExtension.CreateMassProperty2. - Körper: MassProperty rechnet mit allen Volumenkörpern, außer du gibst mit
MassProperty.AddBodiesbestimmte vor, auch temporäre. MassProperty2 rechnet mit den ausgewählten Körpern oder Komponenten, die Liste änderst du mitMassProperty2.SelectedItems. - Überschreiben: MassProperty überschreibt mit eigenen Methoden, jede mit den Angaben zu den Konfigurationen. MassProperty2 sammelt die Werte in
MassPropertyOverrideOptionsund übernimmt sie mitMassProperty2.SetOverrideOptionsundMassProperty2.Recalculate. - Nur bei MassProperty: AddBodies,
MassProperty.SetAssignedMassPropundMassProperty.UserAssigned. - Nur bei MassProperty2: Genauigkeit (
MassProperty2.AccuracyLevel), ausgeblendete Körper und Komponenten, die Masse der Schweißraupen und das Neuberechnen. - Schreibweise: MassProperty schreibt PrincipleAxesOfInertia und PrincipleMomentsOfInertia, MassProperty2 PrincipalAxesOfInertia und PrincipalMomentsOfInertia.
MassProperty brauchst du noch für Makros, die auch vor SOLIDWORKS 2020 laufen sollen, und für temporäre Körper. Ob MassProperty2 temporäre Körper annimmt, sagt die Hilfe nicht.
Koordinatensystem: Bei ModelDocExtension.CreateMassProperty steht: Das Objekt rechnet die Momente um den Ursprung des Dokuments, solange du mit MassProperty.SetCoordinateSystem kein anderes Koordinatensystem festlegst. Übergibst du mit AddBodies die Körper einer Komponente, beziehen sich die Werte auf den Ursprung der Komponente, nicht der Baugruppe.
Aktuelle Werte: Nach ModelDocExtension.CreateMassProperty liefert das Objekt neu berechnete, aktuelle Werte, auch wenn das Modell einen Neuaufbau bräuchte.
Einheiten: MassProperty.UseSystemUnits ist ohne Zuweisung True, die Werte kommen dann in Meter, Bogenmaß und Kilogramm. Das Programmierhandbuch (Thema „Mass Properties“) nennt dagegen Gramm; geliefert wird aber Kilogramm (0,12 für einen Quader mit 120 g, mit UseSystemUnits = False in einem MMGS-Teil 120). Die Hilfebeispiele geben die Masse in kg aus, Volumen und Oberfläche rechnen sie aus m³ und m² in mm³ und mm² um.
Hilfebeispiele: „Insert Coordinate System at Center of Mass“ zeichnet am Schwerpunkt eine 3D-Skizze mit Linien entlang der Hauptträgheitsachsen und fügt daran ein Koordinatensystem ein. „Get Mass Properties of Multibody Assembly Component“ übergibt AddBodies die Körper einer Komponente mit einem Schnitt-Feature der Baugruppe, das die Masseneigenschaften mit beeinflusst. Die Hilfeseiten der Befehle zum Überschreiben verweisen auf „Get and Override Mass Properties“, das inzwischen MassProperty2 verwendet.
Übergibst du mit MassProperty.AddBodies die Körper einer Komponente, liefert nur MassProperty.Mass einen Wert. Volume, SurfaceArea und CenterOfMass liefern 0, Density einen unendlichen Wert.
Eigenschaften und Methoden
Eigenschaften 12, davon 12 beschrieben
| Name | Beschreibung |
|---|---|
| CenterOfMass | Liefert den Schwerpunkt des Modells oder der mit AddBodies übergebenen Körper. |
| Density | Liefert die Dichte des Modells oder der mit AddBodies übergebenen Körper. |
| Mass | Liefert die Masse des Modells oder der mit AddBodies übergebenen Körper. |
| OverrideCenterOfMass | Liest oder setzt, ob der berechnete Schwerpunkt des Modells überschrieben wird. |
| OverrideMass | Liest oder setzt, ob die berechnete Masse des Modells überschrieben wird. |
| OverrideMomentsOfInertia | Liest oder setzt, ob die berechneten Trägheitsmomente des Modells überschrieben werden. |
| PrincipleAxesOfInertia | Liefert die Richtung einer der drei Hauptträgheitsachsen. |
| PrincipleMomentsOfInertia | Liefert die drei Hauptträgheitsmomente. |
| SurfaceArea | Liefert die Oberfläche des Modells oder der mit AddBodies übergebenen Körper. |
| UserAssigned | Liefert, ob die Masseneigenschaften des Dokuments vom Benutzer vorgegeben oder berechnet sind. |
| UseSystemUnits | Liest oder setzt, ob die Masseneigenschaften in Systemeinheiten oder in den Einheiten des Dokuments geliefert werden. |
| Volume | Liefert das Volumen des Modells oder der mit AddBodies übergebenen Körper. |
Methoden 9, davon 9 beschrieben
| Name | Beschreibung |
|---|---|
| AddBodies | Legt die Körper fest, mit denen die Masseneigenschaften berechnet werden, auch temporäre Körper. |
| GetMomentOfInertia | Liefert die Trägheitsmomente bezogen auf den Schwerpunkt oder auf das Koordinatensystem. |
| SetAssignedMassProp | Gibt Masse und Schwerpunkt des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen vor. |
| SetCoordinateSystem | Legt das Koordinatensystem fest, um das die Masseneigenschaften berechnet werden. |
| SetOverrideCenterOfMassValue | Überschreibt den Schwerpunkt des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen. |
| SetOverrideMassValue | Überschreibt die Masse des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen. |
| SetOverrideMomentsOfInertiaValue | Überschreibt die Trägheitsmomente des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen. |
| SetOverridePrincipleAxesOrientation | Überschreibt die Richtung einer Hauptträgheitsachse des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen. |
| SetOverridePrincipleMomentsOfInertia | Überschreibt die Hauptträgheitsmomente des Modells, das gerade bearbeitet wird, für bestimmte Konfigurationen. |
Nicht aufgeführt sind 11 C++-Varianten (Namen mit I davor, zum Beispiel IAddBodies). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IMassProperty in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.