PrincipledMaterial QML Type

Die Eigenschaft alphaCutoff kann verwendet werden, um den Cutoff-Wert bei der Verwendung von Mask alphaMode festzulegen. Fragmente, deren Alphawert unter den Schwellenwert fällt, werden vollständig transparent gerendert (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.

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

Siehe auch alphaCutoff und blendMode.

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

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

Diese Eigenschaft legt die Grundfarbe für das Material fest. Abhängig von der 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.

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.

Diese Eigenschaft definiert die Textur, die verwendet wird, um die Grundfarbe des Materials festzulegen.

Siehe auch baseColor und alphaMode.

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.

Diese Eigenschaft bestimmt, wie die Farben des gerenderten Modells mit denen dahinter übereinstimmen.

Siehe auch alphaMode und Qt Quick 3D-Architektur.

Diese Eigenschaft definiert die Intensität der Klarlackschicht.

Der Standardwert ist 0.0

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

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.

Diese Eigenschaft verringert die frontalen Reflexionen (direkter Blick auf die Oberfläche), während die Reflexionen unter Streifwinkeln beibehalten werden. Der Standardwert ist 5.0.

Mit dieser Eigenschaft werden frontale Reflexionen (direkter Blick auf die Oberfläche) verringert, während Reflexionen unter Streifwinkeln beibehalten werden. Um Änderungen am Material vornehmen zu können, müssen Sie clearcoatFresnelScaleBiasEnabled aktivieren. Der Standardwert ist 1.0.

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

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.

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

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

Mit dieser Eigenschaft wird die Rauheit der Klarlackschicht definiert. Der Standardwert ist 0.0

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

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.

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.

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

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

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.

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.

Diese Eigenschaft verringert die frontalen Reflexionen (direkter Blick auf die Oberfläche), während die Reflexionen unter Streifwinkeln beibehalten werden. Der Standardwert ist 5.0.

Mit dieser Eigenschaft werden frontale Reflexionen (direkter Blick auf die Oberfläche) verringert, während Reflexionen unter Streifwinkeln beibehalten werden. Um Änderungen am Material vornehmen zu können, müssen Sie fresnelScaleBiasEnabled aktivieren. Der Standardwert ist 1.0.

Wenn Sie den Wert auf true setzen, berücksichtigt das Material Fresnel-Skala und Fresnel-Verzerrung. Der Standardwert ist false.

Diese Eigenschaft enthält den Faktor, der verwendet wird, um die Werte aus der heightMap Textur 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.

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

Diese Eigenschaft definiert eine Textur, die verwendet wird, um die Höhe zu bestimmen, um die die Textur beim Rendern durch die Verwendung von Parallax Mapping verschoben 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.

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:

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

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Diese Eigenschaft legt fest, welche Beleuchtungsmethode bei der Erzeugung 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 (wie 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.

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.

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 man parallel zu einer Oberfläche schaut. 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.

Die Eigenschaft metalness definiert den Metallgehalt des Materials. Der Wert ist normalisiert, wobei 0,0 bedeutet, dass das Material ein dielektrisches (nicht-metallisches) Material 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.

Diese Eigenschaft definiert den Texturkanal, der zum Lesen des Metalness-Wertes von metalnessMap verwendet wird. Der Standardwert ist Material.B.

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

Diese Eigenschaft definiert die Mindestanzahl 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 blickt (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.

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.

Diese Eigenschaft steuert das Ausmaß der simulierten Verschiebung für die normalMap.

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

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

Diese Eigenschaft definiert eine Textur, die verwendet wird, um zu bestimmen, 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 der Effekt der Beleuchtung unverändert bleibt.

Siehe auch occlusionAmount.

Diese Eigenschaft verringert die Deckkraft nur dieses Materials, getrennt vom Modell.

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

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

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.

Diese Eigenschaft steuert die Größe des von Lichtern erzeugten Glanzlichts 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.

Diese Eigenschaft definiert den Texturkanal, der zum Lesen des Rauheitswertes von roughnessMap verwendet wird. Der Standardwert ist Material.G.

Diese Eigenschaft definiert eine Textur zur Steuerung der Spiegelungsrauhigkeit des Materials.

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

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

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.

Die Eigenschaft definiert eine RGB-Textur, um die Menge und die Farbe des Glanzes auf der Oberfläche des Materials zu modulieren. Diese Werte werden mit dem specularAmount multipliziert.

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

Dies wird in der Regel verwendet, um eine Umgebungszuordnung vorzunehmen: 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.

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.

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

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

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

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.

Diese Eigenschaft definiert den Texturkanal, der verwendet wird, um den Transmissionsprozentsatz aus transmissionMap zu lesen. Der Standardwert ist Material.R.

Diese Eigenschaft definiert den prozentualen Anteil des Lichts, das durch die Oberfläche des Materials durchgelassen wird. Der Standardwert ist 0.0

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.

Diese Eigenschaft definiert den Alphakanal der Scheitelfarbe, der als Maske für die Spezifizierung 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.

Diese Eigenschaft definiert den Blaukanal der Scheitelfarbe, 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.

Diese Eigenschaft definiert den Grünkanal der Scheitelfarbe, 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.

Diese Eigenschaft definiert den Rotkanal der Scheitelfarbe, 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.

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

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

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

Diese Eigenschaft wurde in Qt 6.8 eingeführt.