SolidWorksMakroprogrammierung

Eigenschaft · DSPBRMaterial

CutoutOpacity-Eigenschaft (DSPBRMaterial)

Liest oder setzt die Ausschnitt-Deckkraft (cut-out opacity) des Materials, von durchsichtig bis deckend.

Syntax

Property CutoutOpacity As Double
swDspbr.CutoutOpacity = 1

Wert

Die Ausschnitt-Deckkraft, von 0,0 (durchsichtig) bis 1,0 (deckend, Vorgabe).

Beispiel

' swDspbr ist ein DSPBR-Material (DSPBRMaterial), etwa aus RenderMaterial.GetDSPBRMaterial.
If swDspbr.CutoutOpacity < 1 Then Debug.Print "Teilweise ausgeschnitten: " & swDspbr.CutoutOpacity

Bemerkungen

Mehr als den Wertebereich sagt die Hilfe nicht. Sie verweist auf die Spezifikation des Enterprise PBR Shading Model unter „Cut-out opacity“. Wie sich der Wert von DSPBRMaterial.Transparency unterscheidet, steht in der API-Hilfe nicht. Vermutlich blendet er Teile der Oberfläche ganz aus, ohne Brechung, etwa mit einer Maske aus DSPBRMaterial.CutoutOpacityTexture.

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::CutoutOpacity in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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