DefaultMaterial QML Type

Ermöglicht die Definition eines Materials für 3D-Elemente unter Verwendung des Spiegelungs-/Glanz-Workflows. Mehr...

Dieser Typ ist seit QtQuick3D 6.4 veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• blendMode : enumeration
• bumpAmount : real
• bumpMap : Texture
• diffuseColor : color
• diffuseLightWrap : real
• diffuseMap : Texture
• emissiveFactor : vector3d
• emissiveMap : Texture
• fresnelPower : real
• indexOfRefraction : real
• lighting : enumeration
• lineWidth : real
• normalMap : Texture
• opacity : real
• opacityChannel : enumeration
• opacityMap : Texture
• pointSize : real
• roughnessChannel : enumeration
• roughnessMap : Texture
• specularAmount : real
• specularMap : Texture
• specularModel : enumeration
• specularReflectionMap : Texture
• specularRoughness : real
• specularTint : color
• translucencyChannel : enumeration
• translucencyMap : Texture
• translucentFalloff : real
• vertexColorsEnabled : bool

Ausführliche Beschreibung

Verwenden Sie stattdessen lieber die PrincipledMaterial oder SpecularGlossyMaterial.

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 DefaultMaterial ist ein einfach zu verwendendes Material, mit dem Sie Ihr Material mithilfe eines Arbeitsablaufs vom Typ Spiegelung/Glanz beschreiben können. Das Material hat eine sinnvolle Voreinstellung und kann zum Schattieren eines Modells verwendet werden, ohne dass irgendwelche Eigenschaften geändert werden müssen.

Arbeitsablauf für Spiegelung/Glätte

Das Standardmaterial bietet eine Möglichkeit, Materialien mit einem Arbeitsablauf vom Typ Spiegelung/Glanz zu erstellen. Die Haupteigenschaften des Materials werden über die Eigenschaften specular, roughness und diffuse color gesteuert.

Spiegelnd

Die specular reflectivity beschreibt den Anteil und die Farbe des Glanzes auf der Oberfläche eines Objekts. Bei reflektierenden Materialien trägt diese Eigenschaft am meisten zur Farbe bei.

Glanz (Rauhigkeit)

Der Glanz einer Oberfläche hängt davon ab, wie glatt oder unregelmäßig die Oberfläche ist. Eine glatte Oberfläche hat eine intensivere Lichtreflexion als eine raue Oberfläche, auf der die Lichtreflexion stärker verteilt ist. Im Standardmaterial wird der Glanz des Materials über die Eigenschaft roughness gesteuert.

Diffuse Farbe

Die Eigenschaft diffuse color beschreibt die Grundfarbe des Materials, und anders als die Grundfarbe von PrincipledMaterial enthält die diffuse Farbe keine Informationen über den Reflexionsgrad des Materials. Bei spiegelnden Oberflächen sollte die diffuse Farbe jedoch auf einen schwarzen Farbton gesetzt werden, da dann die spiegelnde Farbe einen Beitrag leisten kann.

Dokumentation der Eigenschaft

blendMode : enumeration

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

Siehe auch Qt Quick 3D-Architektur.

bumpAmount : real

Diese Eigenschaft steuert das Ausmaß der simulierten Verschiebung für bumpMap oder normalMap. Der Standardwert ist 0 und deaktiviert den Bump-Effekt. Der Bereich ist [0, 1].

bumpMap : Texture

Diese Eigenschaft definiert eine Graustufentextur, um eine feine Geometrieverschiebung über die Oberfläche des Materials zu simulieren. Hellere Pixel zeigen erhabene Regionen an. Die Stärke des Effekts wird durch die Eigenschaft bumpAmount gesteuert.

diffuseColor : color

Diese Eigenschaft bestimmt die diffuse Farbe (Albedo) für das Material. Wenn Sie die diffuse Farbe auf einen schwarzen Farbton einstellen, wird ein rein spiegelndes Material erzeugt (z. B. Metalle oder Spiegel).

diffuseLightWrap : real

Diese Eigenschaft bestimmt den Umfang der Lichtumhüllung für die Transluzenzkarte. Bei einem Wert von 0 wird das Licht überhaupt nicht umhüllt, bei einem Wert von 1 wird das Licht rund um das Objekt umhüllt.

diffuseMap : Texture

Diese Eigenschaft definiert eine Textur, die auf das Material angewendet wird. Wenn Sie Textur mit Transparenz verwenden, wird auch der Alphakanal als Deckkraftkarte angewendet.

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.

Siehe auch emissiveFactor.

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 0, wodurch der Fresnel-Effekt deaktiviert wird.

indexOfRefraction : real

Diese Eigenschaft steuert, welche Winkel der Reflexionen von fresnelPower betroffen sind. Die Vorgabe ist 1.45. Der Wert muss größer oder gleich 1.0 sein.

lighting : enumeration

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

Der Standardwert ist DefaultMaterial.FragmentLighting

Bei Verwendung von DefaultMaterial.FragmentLighting werden diffuse und spiegelnde Beleuchtung für jedes gerenderte Pixel berechnet. Bestimmte Effekte (z. B. Fresnel- oder Bump-Map) erfordern DefaultMaterial.FragmentLighting, um zu funktionieren.

Bei der Verwendung von DefaultMaterial.NoLighting wird keine Beleuchtung berechnet. Dieser Modus ist (vorhersehbar) sehr schnell und sehr effektiv, wenn Bildkarten verwendet werden, die nicht durch Beleuchtung schattiert werden müssen.

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.

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. Das Ausmaß des Effekts wird durch die Eigenschaft bumpAmount gesteuert.

opacity : real

Diese Eigenschaft verringert die Deckkraft nur dieses Materials, unabhängig vom Modell. Die Voreinstellung ist 1.0. Der Bereich ist [0.0, 1.0].

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.

roughnessChannel : enumeration

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

roughnessMap : Texture

Diese Eigenschaft definiert eine Textur zur Steuerung der spiegelnden Rauheit des Materials. Wenn die Textur mehrere Kanäle (RGBA) enthält, kann der richtige Kanal über die Eigenschaft roughnessChannel festgelegt werden.

specularAmount : real

Diese Eigenschaft steuert die Stärke des Glanzes (Glanzlichter und Reflexionen). Der Standardwert ist 0 und deaktiviert den Glanzgrad. Der Bereich ist [0.0, 1.0].

specularMap : Texture

Diese 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.

specularModel : enumeration

Diese Eigenschaft legt fest, welche Funktionen zur Berechnung von Glanzlichtern für Lichter in der Szene verwendet werden.

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.

specularRoughness : 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.

specularTint : color

Diese Eigenschaft definiert eine Farbe, mit der die spiegelnden Reflexionen angepasst werden. Verwenden Sie Weiß für keinen Effekt

translucencyChannel : enumeration

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

translucencyMap : Texture

Diese Eigenschaft definiert eine Graustufentextur, die steuert, wie viel Licht von hinten durch das Material dringen kann.

translucentFalloff : real

Diese Eigenschaft definiert den Grad der Abweichung für die Durchsichtigkeit basierend auf dem Winkel der Normalen des Objekts zur Lichtquelle.

vertexColorsEnabled : bool

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