SolidWorksMakroprogrammierung

Eigenschaft · DSPBRMaterial

AttenuationColor-Eigenschaft (DSPBRMaterial)

Liest oder setzt die Farbe, zu der Licht im Inneren des Materials abgeschwächt wird.

Syntax

Property AttenuationColor As Long
swDspbr.AttenuationColor = RGB(0, 150, 80)

Wert

Die Farbe der Abschwächung als COLORREF-Wert (Long), in VBA etwa mit RGB.

Beispiel

' swDspbr ist ein DSPBR-Material (DSPBRMaterial), etwa aus RenderMaterial.GetDSPBRMaterial.
swDspbr.Transparency = 1
swDspbr.ThinWalled = 0                                     ' Volumen
swDspbr.AttenuationColor = RGB(0, 150, 80)
swDspbr.AttenuationDistance = 20                           ' Einheit nicht dokumentiert

Bemerkungen

Die Hilfe nennt nur die Farbe der Abschwächung (attenuation color) und verweist auf die Spezifikation des Enterprise PBR Shading Model. Die Farbe ist ein COLORREF in Dezimalschreibweise. Vermutlich wirkt sie nur bei transparenten Volumenkörpern, also wenn DSPBRMaterial.ThinWalled 0 ist. Den Weg im Material legst du mit DSPBRMaterial.AttenuationDistance fest.

In SOLIDWORKS 2024 nicht prüfbar: Die Typbibliothek kennt DSPBRMaterial noch nicht, schon Dim swDspbr As SldWorks.DSPBRMaterial brach beim Kompilieren ab („Benutzerdefinierter Typ nicht definiert“). Das Objekt gibt es erst ab SOLIDWORKS 2026.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2026

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

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