PrincipledMaterial QML Type

Ermöglicht die Definition eines Materials für 3D-Objekte unter Verwendung des Arbeitsablaufs Metall/Rauheit. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• alphaCutoff : real
• alphaMode : enumeration
• attenuationColor : color
• attenuationDistance : real
• baseColor : color
• baseColorChannel : enumeration (since 6.8)
• baseColorMap : Texture
• baseColorSingleChannelEnabled : bool (since 6.8)
• blendMode : enumeration
• clearcoatAmount : real
• clearcoatChannel : enumeration
• clearcoatFresnelBias : real
• clearcoatFresnelPower : real
• clearcoatFresnelScale : real
• clearcoatFresnelScaleBiasEnabled : real
• clearcoatMap : Texture
• clearcoatNormalMap : Texture
• clearcoatNormalStrength : real
• clearcoatRoughnessAmount : real
• clearcoatRoughnessChannel : enumeration
• clearcoatRoughnessMap : Texture
• emissiveChannel : enumeration (since 6.8)
• emissiveFactor : vector3d
• emissiveMap : Texture
• emissiveSingleChannelEnabled : bool (since 6.8)
• fresnelBias : real
• fresnelPower : real
• fresnelScale : real
• fresnelScaleBiasEnabled : real
• heightAmount : real
• heightChannel : enumeration
• heightMap : Texture
• indexOfRefraction : real
• invertOpacityMapValue : real (since 6.8)
• lighting : enumeration
• lineWidth : real
• maxHeightMapSamples : int
• metalness : real
• metalnessChannel : enumeration
• metalnessMap : Texture
• minHeightMapSamples : int
• normalMap : Texture
• normalStrength : real
• occlusionAmount : real
• occlusionChannel : enumeration
• occlusionMap : Texture
• opacity : real
• opacityChannel : enumeration
• opacityMap : Texture
• pointSize : real
• roughness : real
• roughnessChannel : enumeration
• roughnessMap : Texture
• specularAmount : real
• specularChannel : enumeration (since 6.8)
• specularMap : Texture
• specularReflectionMap : Texture
• specularSingleChannelEnabled : bool (since 6.8)
• specularTint : real
• thicknessChannel : enumeration
• thicknessFactor : real
• thicknessMap : Texture
• transmissionChannel : enumeration
• transmissionFactor : real
• transmissionMap : Texture
• vertexColorAlphaMask : enumeration (since 6.8)
• vertexColorBlueMask : enumeration (since 6.8)
• vertexColorGreenMask : enumeration (since 6.8)
• vertexColorRedMask : enumeration (since 6.8)
• vertexColorsEnabled : bool (since 6.5)
• vertexColorsMaskEnabled : bool (since 6.8)

Detaillierte Beschreibung

Bevor ein Modell in einer Szene gerendert werden kann, muss ihm mindestens ein Material zugewiesen werden, das beschreibt, wie das Mesh schattiert werden soll. Das PrincipledMaterial ist ein PBR-Metall/Rauheit-Material, das ein einfach zu verwendendes Material mit einem minimalen Satz von Parametern sein soll. Zusätzlich zu den wenigen Parametern sind alle Eingabewerte streng zwischen 0 und 1 normalisiert und haben sinnvolle Standardwerte, was bedeutet, dass das Material auch ohne Änderung der Werte zum Shadering eines Modells verwendet werden kann. Eine Einführung, wie sich die verschiedenen Eigenschaften des Principled Materials auf die Schattierung eines Modells auswirken, finden Sie im Beispiel Principled Material.

Arbeitsablauf Metall/Rauheit

Das Principled Material ist ein sogenanntes Metall/Rauheit-Material, was im Wesentlichen bedeutet, dass die Hauptmerkmale des Materials durch die Eigenschaften metallness, roughness und base color gesteuert werden.

Metallizität

Die Materialien der realen Welt werden in zwei Hauptkategorien eingeteilt: Metalle und Dielektrika (Nicht-Metalle). Im Prinzipiellen Material wird die Kategorie, zu der ein Material gehört, durch den Wert metalness bestimmt. Wenn der Wert metalness auf 0 gesetzt wird, bedeutet dies, dass das Material ein Dialektikum ist, während alles über 0 als Metall angesehen wird. In der Realität haben Metalle einen metalness Wert von 1, aber Werte zwischen 0 und 1 sind möglich und werden normalerweise für Metalle mit reduziertem Reflexionsgrad verwendet. Um z. B. Korrosion oder Ähnliches auf einem Material darzustellen, sollte der metalness Wert des Materials reduziert werden, um die Eigenschaften eines dielektrischen Materials zu erreichen. Da sich der Wert metalness auf den Reflexionsgrad des Materials auswirkt, könnte es verlockend sein, die Metallizität zur Anpassung des Glanzes zu verwenden, aber überlegen Sie zuerst, welche Art von Material Sie beschreiben möchten. Wenn Sie den Wert metalness erhöhen, um einem dielektrischen Material ein polierteres Aussehen zu verleihen, führt dies zu Eigenschaften, die für ein dielektrisches Material nicht zutreffend sind. Überlegen Sie daher, ob es nicht sinnvoller wäre, stattdessen z. B. den Wert roughness anzupassen.

Rauheit

Die roughness eines Materials beschreibt den Zustand der Oberfläche eines Objekts. Ein niedriger roughness Wert bedeutet, dass das Objekt eine glatte Oberfläche hat und daher stärker reflektiert als ein Material mit einem höheren roughness Wert.

Grundfarbe

Die base color eines Metall-/Rauheitsmaterials enthält sowohl die diffusen als auch die spiegelnden Daten. Wie sehr die Grundfarbe als das eine oder das andere interpretiert wird, hängt in erster Linie vom metalness Wert ab. Beispielsweise wird bei einem Material mit einem Metallwert von 1 der größte Teil der Grundfarbe als spiegelnde Farbe interpretiert, während die diffuse Farbe ein schwarzer Farbton ist. Bei einem Material mit einem Metalness-Wert von 0 wäre das Gegenteil der Fall. Dies ist natürlich etwas vereinfacht, vermittelt aber eine grobe Vorstellung davon, wie die Werte base color und metalness interagieren. Für diejenigen, die mit einem Specular/Glossiness-Workflow vertrauter sind, gibt es hier einen klaren Unterschied, der erwähnenswert ist, nämlich dass die Farbdaten der beiden Materialien nicht direkt kompatibel sind, da in einem Specular/Glossiness material die diffuse und die spiegelnde Farbe aus separaten Eingaben stammen.

Dokumentation der Eigenschaft

alphaCutoff : real

Die Eigenschaft alphaCutoff kann verwendet werden, um den Cutoff-Wert bei der Verwendung von Mask alphaMode festzulegen. Fragmente, bei denen der Alpha-Wert unter den Schwellenwert fällt, werden vollständig transparent dargestellt (0.0 für alle Farbkanäle). Wenn der Alphawert gleich oder größer als der Cutoff-Wert ist, wird die Farbe in keiner Weise beeinflusst.

Der Standardwert ist 0,5.

Siehe auch alphaMode.

alphaMode : enumeration

Diese Eigenschaft gibt an, wie der Alphafarbwert von baseColor und der Alphakanal eines base color map verwendet werden.

Siehe auch alphaCutoff und blendMode.

attenuationColor : color

Diese Eigenschaft definiert die Farbe, in die sich weißes Licht aufgrund von Absorption verwandelt, wenn es die Dämpfungsdistanz erreicht. Der Standardwert ist Qt.White

attenuationDistance : real

Diese Eigenschaft definiert die Dichte des Mediums, angegeben als die durchschnittliche Entfernung, die das Licht im Medium zurücklegt, bevor es mit einem Teilchen interagiert. Der Wert wird im Weltraum angegeben. Der Standardwert ist +infinity.

baseColor : color

Diese Eigenschaft legt die Grundfarbe für das Material fest. Je nach Art des angegebenen Materials (Metall oder Dielektrikum) werden die diffusen und spiegelnden Kanäle entsprechend eingestellt. Ein dielektrisches Material hat zum Beispiel eine diffuse Farbe, die der Grundfarbe entspricht, während die Spiegelfarbe, abhängig von der Spiegelungsmenge, eine helle Spiegelungsfarbe hat. Bei Metallen werden die diffusen und spiegelnden Kanäle aus der Grundfarbe gemischt und haben einen dunklen diffusen Kanal und einen spiegelnden Kanal nahe der Grundfarbe.

Siehe auch baseColorMap und alphaMode.

baseColorChannel : enumeration [since 6.8]

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Wert baseColor von baseColorMap zu lesen. Um einen einzelnen Texturkanal als Farbe zu verwenden, müssen Sie baseColorSingleChannelEnabled aktivieren. Der Standardwert ist Material.R.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

baseColorMap : Texture

Diese Eigenschaft definiert die Textur, die zum Festlegen der Grundfarbe des Materials verwendet wird.

Siehe auch baseColor und alphaMode.

baseColorSingleChannelEnabled : bool [since 6.8]

Wenn diese Eigenschaft aktiviert ist, verwendet das Material den Einzelwert von baseColorChannel aus baseColorMap als RGB-Wert und 1,0 als Alpha-Wert. Der Standardwert ist false.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

blendMode : enumeration

Diese Eigenschaft legt fest, wie die Farben des gerenderten Modells mit denen des dahinter liegenden Modells verschmelzen.

Siehe auch alphaMode und Qt Quick 3D-Architektur.

clearcoatAmount : real

Diese Eigenschaft definiert die Intensität der Klarlackschicht.

Der Standardwert ist 0.0

clearcoatChannel : enumeration

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Wert der Klarlackmenge von clearcoatMap zu lesen. Der Standardwert ist Material.R.

clearcoatFresnelBias : real

Mit dieser Eigenschaft werden Reflexionen bei direktem Blick auf die Oberfläche nach vorne verschoben, während Reflexionen bei Streifwinkeln erhalten bleiben. Um Änderungen am Material vornehmen zu können, müssen Sie clearcoatFresnelScaleBiasEnabled aktivieren. Der Standardwert ist 0.0.

clearcoatFresnelPower : real

Diese Eigenschaft verringert die Reflexionen bei direktem Blick auf die Oberfläche, während die Reflexionen bei Streifwinkeln erhalten bleiben. Der Standardwert ist 5.0.

clearcoatFresnelScale : real

Diese Eigenschaft skaliert Frontalreflexionen (direkter Blick auf die Oberfläche), während Reflexionen, die aus Streifwinkeln gesehen werden, erhalten bleiben. Um Änderungen am Material vornehmen zu können, müssen Sie clearcoatFresnelScaleBiasEnabled aktivieren. Der Standardwert ist 1.0.

clearcoatFresnelScaleBiasEnabled : real

Wenn Sie den Wert auf true setzen, berücksichtigt das Material Clearcoat Fresnel Scale und Clearcoat Fresnel Bias. Der Standardwert ist false.

clearcoatMap : Texture

Diese Eigenschaft definiert eine Textur, die zur Bestimmung der Intensität der Klarlackschicht verwendet wird. Der Wert vonclearcoatAmount wird mit dem aus dieser Textur gelesenen Wert multipliziert.

clearcoatNormalMap : Texture

Diese Eigenschaft definiert eine Textur, mit der die auf die Klarlackschicht angewendete Normalzuordnung bestimmt wird.

clearcoatNormalStrength : real

Diese Eigenschaft steuert den Betrag der simulierten Verschiebung für die clearcoatNormalMap.

clearcoatRoughnessAmount : real

Diese Eigenschaft definiert die Rauheit der Klarlackschicht. Der Standardwert ist 0.0

clearcoatRoughnessChannel : enumeration

Diese Eigenschaft legt den Texturkanal fest, der verwendet wird, um die Rauhigkeit der Klarlacke aus clearcoatRoughnessMap zu lesen. Der Standardwert ist Material.G.

clearcoatRoughnessMap : Texture

Diese Eigenschaft definiert eine Textur, die zur Bestimmung der Rauheit der Klarlackschicht verwendet wird. Der Wert vonclearcoatRoughnessAmount wird mit dem aus dieser Textur gelesenen Wert multipliziert.

emissiveChannel : enumeration [since 6.8]

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Emissionswert von emissiveMap zu lesen. Um einen einzelnen Texturkanal als Farbe zu verwenden, müssen Sie emissiveSingleChannelEnabled aktivieren. Der Standardwert ist Material.R.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

emissiveFactor : vector3d

Diese Eigenschaft bestimmt die Farbe der Selbstbeleuchtung für dieses Material. Wenn eine Emissionskarte eingestellt ist, werden die x-, y- und z-Komponenten als Faktoren (Multiplikatoren) für die R-, G- und B-Kanäle der Textur verwendet. Der Standardwert ist (0, 0, 0) und bedeutet, dass es keinen Emissionsbeitrag gibt.

emissiveMap : Texture

Diese Eigenschaft legt eine RGB-Textur fest, die verwendet wird, um die Intensität der emittierenden Farbe zu bestimmen.

emissiveSingleChannelEnabled : bool [since 6.8]

Wenn diese Eigenschaft aktiviert ist, verwendet das Material den Einzelwert von emissiveChannel aus emissiveMap als RGB-Wert. Der Standardwert ist false.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

fresnelBias : real

Mit dieser Eigenschaft werden Reflexionen bei direktem Blick auf die Oberfläche nach vorne verschoben, während Reflexionen bei Streifwinkeln erhalten bleiben. Um Änderungen am Material vornehmen zu können, müssen Sie fresnelScaleBiasEnabled aktivieren. Der Standardwert ist 0.0.

fresnelPower : real

Diese Eigenschaft verringert die Reflexionen bei direktem Blick auf die Oberfläche, während die Reflexionen bei Streifwinkeln erhalten bleiben. Der Standardwert ist 5.0.

fresnelScale : real

Diese Eigenschaft skaliert Frontalreflexionen (direkter Blick auf die Oberfläche), während Reflexionen, die aus Streifwinkeln gesehen werden, erhalten bleiben. Um Änderungen am Material vornehmen zu können, müssen Sie fresnelScaleBiasEnabled aktivieren. Der Standardwert ist 1.0.

fresnelScaleBiasEnabled : real

Wenn der Wert auf true gesetzt wird, berücksichtigt das Material die Fresnel-Skala und die Fresnel-Verzerrung. Der Standardwert ist false.

heightAmount : real

Diese Eigenschaft enthält den Faktor, der verwendet wird, um die Werte aus der Textur heightMap zu ändern. Der Wert sollte zwischen 0.0 und 1.0 liegen. Der Standardwert ist 0,0, was bedeutet, dass die Höhenverschiebung deaktiviert wird, auch wenn eine Höhenkarte eingestellt ist.

heightChannel : enumeration

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Höhenwert von heightMap zu lesen. Der Standardwert ist Material.R.

heightMap : Texture

Diese Eigenschaft definiert eine Textur, die verwendet wird, um die Höhe zu bestimmen, um die die Textur verschoben wird, wenn sie durch die Verwendung von Parallax Mapping gerendert wird. Es wird erwartet, dass die Werte linear von 0,0 bis 1,0 sind, wobei 0,0 keine Verschiebung und 1,0 die maximale Verschiebung bedeutet.

indexOfRefraction : real

Diese Eigenschaft definiert den Brechungsindex des Materials. Der Standardwert von 1.5 ist der ideale Wert für Materialien wie Kunststoff oder Glas, aber andere Materialien wie Wasser, Asphalt, Saphir oder Diamant erfordern einen angepassten Wert, um realistischer zu wirken. Für realistische Materialien sollte der indexOfRefraction normalerweise zwischen 1.0 und 3.0

Einige Beispiele für gängige Brechungsindizes von Materialien sind:

invertOpacityMapValue : real [since 6.8]

Diese Eigenschaft invertiert den Opazitätswert von opacityMap. Der Standardwert ist false.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

lighting : enumeration

Diese Eigenschaft legt fest, welche Beleuchtungsmethode bei der Erstellung dieses Materials verwendet wird.

Der Standardwert ist PrincipledMaterial.FragmentLighting

Bei der Verwendung von PrincipledMaterial.FragmentLighting wird die diffuse und spiegelnde Beleuchtung für jedes gerenderte Pixel berechnet. Bestimmte Effekte (z. B. eine Fresnel- oder Normal-Map) erfordern PrincipledMaterial.FragmentLighting, um zu funktionieren.

Bei der Verwendung von PrincipledMaterial.NoLighting wird keine Beleuchtung berechnet. Dieser Modus ist (vorhersehbar) sehr schnell und ist recht effektiv, wenn Bildkarten verwendet werden, die nicht durch Beleuchtung schattiert werden müssen. Alle anderen Schattierungseigenschaften mit Ausnahme der baseColor Werte, der Alphawerte und der Vertexfarben werden ignoriert.

lineWidth : real

Diese Eigenschaft bestimmt die Breite der gerenderten Linien, wenn die Geometrie einen primitiven Typ von Linien oder Linienstreifen verwendet. Der Standardwert ist 1.0. Diese Eigenschaft ist nicht relevant, wenn andere Geometrietypen gerendert werden, z. B. Dreiecksnetze.

maxHeightMapSamples : int

Diese Eigenschaft definiert die maximale Anzahl der Samples, die für die Durchführung von Parallex Occlusion Mapping unter Verwendung von heightMap verwendet werden. Der Wert maxHeightMapSamples ist die Anzahl der Samples von heightMap, die verwendet werden, wenn parallel zu einer Oberfläche geschaut wird. Der Standardwert ist 32.

Die tatsächliche Anzahl der Samples, die für jedes Fragment verwendet wird, liegt zwischen minHeightMapSamples und maxHeightMapSamples, abhängig vom Winkel der Kamera relativ zur gerenderten Oberfläche.

metalness : real

Die Eigenschaft Metallizität definiert die Metallizität des Materials. Der Wert ist normalisiert, wobei 0,0 bedeutet, dass das Material ein Dielektrikum (nichtmetallisch) ist und ein Wert von 1,0 bedeutet, dass das Material ein Metall ist.

Der Bereich ist [0.0, 1.0]. Der Standardwert ist 0.

metalnessChannel : enumeration

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Metalness-Wert von metalnessMap zu lesen. Der Standardwert ist Material.B.

metalnessMap : Texture

Diese Eigenschaft legt eine Textur fest, die verwendet wird, um den Metallisierungsgrad für die verschiedenen Teile des Materials festzulegen.

minHeightMapSamples : int

Diese Eigenschaft definiert die minimale Anzahl von Samples, die für die Durchführung von Parallex Occlusion Mapping unter Verwendung von heightMap verwendet werden. Der Wert minHeightMapSamples ist die Anzahl der Samples von heightMap, die verwendet werden, wenn man direkt auf eine Oberfläche schaut (wenn die Kameraansicht senkrecht zum Fragment steht). Der Standardwert ist 8.

Die tatsächliche Anzahl der Samples, die für jedes Fragment verwendet wird, liegt zwischen minHeightMapSamples und maxHeightMapSamples, abhängig vom Winkel der Kamera relativ zur gerenderten Oberfläche.

normalMap : Texture

Diese Eigenschaft definiert ein RGB-Bild, das verwendet wird, um eine feine Geometrieverschiebung über die Oberfläche des Materials zu simulieren. Die RGB-Kanäle zeigen XYZ-Normalabweichungen an.

normalStrength : real

Diese Eigenschaft steuert den Betrag der simulierten Verschiebung für die normalMap.

occlusionAmount : real

Diese Eigenschaft enthält den Faktor, der verwendet wird, um die Werte aus der Textur occlusionMap zu ändern. Der Wert sollte zwischen 0,0 und 1,0 liegen. Der Standardwert ist 1.0

occlusionChannel : enumeration

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Okklusionswert von occlusionMap zu lesen. Der Standardwert ist Material.R.

occlusionMap : Texture

Diese Eigenschaft definiert eine Textur, mit der festgelegt wird, wie viel Licht die verschiedenen Bereiche des Materials erhalten sollen. Es wird erwartet, dass die Werte linear von 0,0 bis 1,0 verlaufen, wobei 0,0 bedeutet, dass keine Beleuchtung erfolgt und 1,0 bedeutet, dass die Wirkung der Beleuchtung unverändert bleibt.

Siehe auch occlusionAmount.

opacity : real

Diese Eigenschaft verringert die Deckkraft nur dieses Materials, unabhängig vom Modell.

opacityChannel : enumeration

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Deckkraftwert von opacityMap zu lesen. Der Standardwert ist Material.A.

opacityMap : Texture

Diese Eigenschaft definiert eine Textur, die verwendet wird, um die Deckkraft für verschiedene Teile des Materials unterschiedlich zu steuern.

pointSize : real

Diese Eigenschaft bestimmt die Größe der gerenderten Punkte, wenn die Geometrie einen primitiven Punkttyp verwendet. Der Standardwert ist 1.0. Diese Eigenschaft ist nicht relevant, wenn andere Geometrietypen gerendert werden, z. B. Dreiecksnetze.

roughness : real

Diese Eigenschaft steuert die Größe der von Lichtern erzeugten Glanzlichter und die Klarheit von Reflexionen im Allgemeinen. Größere Werte erhöhen die Rauheit, machen die Glanzlichter weicher und die Reflexionen unschärfer. Der Bereich ist [0.0, 1.0]. Der Standardwert ist 0.

roughnessChannel : enumeration

Diese Eigenschaft definiert den Texturkanal, mit dem der Rauheitswert von roughnessMap gelesen wird. Der Standardwert ist Material.G.

roughnessMap : Texture

Diese Eigenschaft definiert eine Textur zur Steuerung der spiegelnden Rauheit des Materials.

specularAmount : real

Diese Eigenschaft steuert die Stärke des Glanzes (Glanzlichter und Reflexionen).

Der Bereich ist [0.0, 1.0]. Der Standardwert ist 1.0.

specularChannel : enumeration [since 6.8]

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den spiegelnden Farbwert von specularMap zu lesen. Um einen einzelnen Texturkanal als Farbe zu verwenden, müssen Sie die specularSingleChannelEnabled aktivieren. Der Standardwert ist Material.R.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

specularMap : Texture

Die Eigenschaft definiert eine RGB-Textur zur Modulation der Menge und der Farbe des Glanzes auf der Oberfläche des Materials. Diese Werte werden mit dem Wert specularAmount multipliziert.

specularReflectionMap : Texture

Diese Eigenschaft legt eine Textur fest, die für spiegelnde Highlights auf dem Material verwendet wird.

Dies wird in der Regel verwendet, um ein Environment Mapping durchzuführen: Wenn das Modell gedreht wird, erscheint die Karte, als ob sie von der Umgebung reflektiert wird. Damit dies wie erwartet funktioniert, muss die Textur mappingMode auf Texture.Environment gesetzt werden. Specular Reflection Maps sind eine einfache Möglichkeit, mit relativ geringem Aufwand ein hochwertiges Aussehen zu erzielen.

Siehe auch Texture::mappingMode.

specularSingleChannelEnabled : bool [since 6.8]

Wenn diese Eigenschaft aktiviert ist, verwendet das Material den Einzelwert von specularChannel aus specularMap als RGB-Wert. Der Standardwert ist false.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

specularTint : real

Diese Eigenschaft legt fest, wie viel der Grundfarbe zu den spiegelnden Reflexionen beiträgt.

thicknessChannel : enumeration

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Dickenwert von transmissionMap zu lesen. Der Standardwert ist Material.G.

thicknessFactor : real

Diese Eigenschaft definiert die Dicke des Volumens unter der Oberfläche. Im Gegensatz zu vielen anderen Eigenschaften von PrincipledMaterial ist der in thicknessFactor definierte Wert ein Wert von 0,0 bis +unendlich für die Dicke im Koordinatenraum des Modells. Ein Wert von 0,0 bedeutet, dass das Material dünnwandig ist. Der Standardwert ist 0.0

thicknessMap : Texture

Diese Eigenschaft definiert eine Textur, die zur Bestimmung der Dicke eines Materialvolumens verwendet wird. Der Wert von thicknessFactor wird mit dem aus dieser Textur gelesenen Wert multipliziert.

transmissionChannel : enumeration

Diese Eigenschaft legt den Texturkanal fest, der zum Lesen des Übertragungsprozentsatzes von transmissionMap verwendet wird. Der Standardwert ist Material.R.

transmissionFactor : real

Diese Eigenschaft legt den Prozentsatz des Lichts fest, das durch die Oberfläche des Materials durchgelassen wird. Der Standardwert ist 0.0

transmissionMap : Texture

Diese Eigenschaft definiert eine Textur, die verwendet wird, um den Prozentsatz des Lichts zu bestimmen, das durch die Oberfläche durchgelassen wird. Der Wert von transmissionFactor wird mit dem aus dieser Textur gelesenen Wert multipliziert.

vertexColorAlphaMask : enumeration [since 6.8]

Diese Eigenschaft legt den Alphakanal der Scheitelpunktfarbe fest, der als Spezifizierungsmaske verwendet wird. Der Wert ist eine Bit-weise Kombination von Flags. Der Standardwert ist PrincipledMaterial.NoMask.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

vertexColorBlueMask : enumeration [since 6.8]

Diese Eigenschaft legt den Blaukanal der Scheitelfarbe fest, der als Spezifizierungsmaske verwendet wird. Der Wert ist eine Bit-weise Kombination von Flags. Der Standardwert ist PrincipledMaterial.NoMask.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

vertexColorGreenMask : enumeration [since 6.8]

Diese Eigenschaft legt den Grünkanal der Scheitelfarbe fest, der als Spezifizierungsmaske verwendet wird. Der Wert ist eine Bit-weise Kombination von Flags. Der Standardwert ist PrincipledMaterial.NoMask.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

vertexColorRedMask : enumeration [since 6.8]

Diese Eigenschaft legt den Rotkanal der Scheitelfarbe fest, der als Spezifizierungsmaske verwendet wird. Der Wert ist eine Bit-weise Kombination von Flags. Der Standardwert ist PrincipledMaterial.NoMask.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

vertexColorsEnabled : bool [since 6.5]

Wenn diese Eigenschaft aktiviert ist, verwendet das Material die Scheitelfarben des Netzes. Diese werden mit allen anderen für das Material angegebenen Farben multipliziert. Der Standardwert ist true.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

vertexColorsMaskEnabled : bool [since 6.8]

Wenn diese Eigenschaft aktiviert ist, verwendet das Material Scheitelfarben aus dem Netz als Maske für verschiedene Eigenschaften, z. B. RoughnessAmount, SpecularAmount, ... . Der Standardwert ist false.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.