SpecularGlossyMaterial QML Type

Permet de définir un matériau pour des objets 3D en utilisant le flux de travail spéculaire/brillant. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• albedoChannel : enumeration (since 6.8)
• albedoColor : color
• albedoMap : Texture
• albedoSingleChannelEnabled : bool (since 6.8)
• alphaCutoff : real
• alphaMode : enumeration
• attenuationColor : color
• attenuationDistance : real
• blendMode : enumeration
• clearcoatAmount : real
• clearcoatChannel : enumeration
• clearcoatFresnelBias : real
• clearcoatFresnelPower : real
• clearcoatFresnelScale : real
• clearcoatFresnelScaleBiasEnabled : real
• clearcoatMap : Texture
• clearcoatNormalMap : Texture
• 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
• glossiness : real
• glossinessChannel : enumeration
• glossinessMap : Texture
• heightAmount : real
• heightChannel : enumeration
• heightMap : Texture
• invertOpacityMapValue : real (since 6.8)
• lighting : enumeration
• lineWidth : real
• maxHeightMapSamples : int
• minHeightMapSamples : int
• normalMap : Texture
• normalStrength : real
• occlusionAmount : real
• occlusionChannel : enumeration
• occlusionMap : Texture
• opacity : real
• opacityChannel : enumeration
• opacityMap : Texture
• pointSize : real
• specularChannel : enumeration (since 6.8)
• specularColor : color
• specularMap : Texture
• specularSingleChannelEnabled : bool (since 6.8)
• 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)

Description détaillée

Avant qu'un modèle puisse être rendu dans une scène, il doit être associé à au moins un matériau décrivant la manière dont le maillage doit être ombré. Le matériau SpecularGlossyMaterial est un matériau PBR spéculaire/brillant qui vise à être un matériau facile à utiliser avec un ensemble minimal de paramètres. En plus d'avoir peu de paramètres, toutes les valeurs d'entrée sont strictement normalisées entre 0 et 1 et ont des valeurs par défaut raisonnables, ce qui signifie que même sans changer aucune valeur, le matériau peut être utilisé pour ombrer un modèle. Pour savoir comment les différentes propriétés du matériau SpecularGlossyMaterial affectent l'ombrage d'un modèle, consultez l'exemple Principled Material qui fournit un mode d'utilisation du flux de travail Specular/Glossy.

Pour utiliser le flux de travail métallique/brillant, vous pouvez également utiliser PrincipledMaterial.

Flux de travail spéculaire/brillant

Le matériau SpecularGlossyMaterial permet de créer des matériaux à l'aide d'un flux de travail de type spéculaire/brillant. Les principales propriétés du matériau sont contrôlées par les propriétés specular, glossiness, et albedo.

Spéculaire

La propriété specularColor décrit la quantité et la couleur spéculaire de la surface d'un objet. Pour les matériaux réfléchissants, la principale contribution à la couleur provient de cette propriété.

Brillance

La propriété glossiness d'un matériau décrit l'état de la surface d'un objet. Une valeur élevée de glossiness signifie que l'objet a une surface lisse et qu'il est donc plus réfléchissant qu'un matériau dont la valeur de glossiness est plus faible.

Albédo

La propriété albedoColor décrit la couleur diffuse du matériau et, contrairement à la couleur de base de PrincipledMaterial, l'albédo ne contient aucune information sur la réflectance du matériau. Cela signifie que pour les surfaces réfléchissantes, la valeur de la couleur de l'albédo doit être réglée sur une teinte noire, car cela permettra à la couleur spéculaire de contribuer.

Documentation sur les propriétés

albedoChannel : enumeration [since 6.8]

Cette propriété définit le canal de texture utilisé pour lire la valeur de la couleur de l'albédo à partir de albedoMap. Pour utiliser un seul canal de texture comme couleur, vous devez activer le canal albedoSingleChannelEnabled. La valeur par défaut est Material.R.

Cette propriété a été introduite dans Qt 6.8.

albedoColor : color

Cette propriété définit la couleur d'albédo du matériau. En réglant la couleur diffuse sur une teinte noire, on obtient un matériau purement spéculaire (par exemple, des métaux ou des miroirs).

Voir également albedoMap et alphaMode.

albedoMap : Texture

Cette propriété définit la texture utilisée pour définir la couleur d'albédo du matériau.

Voir également albedo et alphaMode.

albedoSingleChannelEnabled : bool [since 6.8]

Lorsque cette propriété est activée, le matériau utilise la valeur unique de albedoChannel à partir de albedoMap comme valeur RVB et utilise 1.0 comme valeur alpha. La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.8.

alphaCutoff : real

La propriété alphaCutoff peut être utilisée pour spécifier la valeur de coupure lors de l'utilisation de Mask alphaMode. Les fragments dont la valeur alpha est inférieure au seuil seront rendus totalement transparents (0.0 pour tous les canaux de couleur). Lorsque la valeur alpha est égale ou supérieure à la valeur de coupure, la couleur n'est en aucun cas affectée.

La valeur par défaut est 0,5.

Voir également alphaMode.

alphaMode : enumeration

Cette propriété spécifie comment la valeur de la couleur alpha de albedoColor et le canal alpha de albedo map sont utilisés.

Voir également alphaCutoff et blendMode.

attenuationColor : color

Cette propriété définit la couleur que les lumières blanches prennent en raison de l'absorption lorsqu'elles atteignent la distance d'atténuation. La valeur par défaut est Qt.White

attenuationDistance : real

Cette propriété définit la densité du milieu, c'est-à-dire la distance moyenne parcourue par la lumière dans le milieu avant d'interagir avec une particule. La valeur est donnée dans l'espace mondial. La valeur par défaut est +infinity.

blendMode : enumeration

Cette propriété détermine comment les couleurs du modèle rendu se mélangent avec celles qui se trouvent derrière lui.

Voir également alphaMode et Qt Quick Architecture 3D.

clearcoatAmount : real

Cette propriété définit l'intensité de la couche de vernis.

La valeur par défaut est 0.0

clearcoatChannel : enumeration

Cette propriété définit le canal de texture utilisé pour lire la valeur de la quantité de vernis à partir de clearcoatMap. La valeur par défaut est Material.R.

clearcoatFresnelBias : real

Cette propriété permet de repousser les réflexions frontales (en regardant directement la surface) tout en conservant les réflexions observées à des angles rasants. Pour pouvoir modifier le matériau, vous devez activer clearcoatFresnelScaleBiasEnabled. La valeur par défaut est 0.0.

clearcoatFresnelPower : real

Cette propriété diminue les réflexions frontales (en regardant directement la surface) tout en conservant les réflexions observées à des angles rasants. La valeur par défaut est 5.0.

clearcoatFresnelScale : real

Cette propriété met à l'échelle les réflexions frontales (en regardant directement la surface) tout en conservant les réflexions observées à des angles rasants. Pour pouvoir modifier le matériau, vous devez activer clearcoatFresnelScaleBiasEnabled. La valeur par défaut est 1.0.

clearcoatFresnelScaleBiasEnabled : real

En fixant la valeur à true, le matériau prendra en compte l'échelle de Fresnel de la couche claire et le biais de Fresnel de la couche claire. La valeur par défaut est false.

clearcoatMap : Texture

Cette propriété définit une texture utilisée pour déterminer l'intensité de la couche de vernis. La valeur declearcoatAmount sera multipliée par la valeur lue dans cette texture.

clearcoatNormalMap : Texture

Cette propriété définit une texture utilisée pour déterminer la cartographie normale appliquée à la couche de vernis.

clearcoatRoughnessAmount : real

Cette propriété définit la rugosité de la couche de vernis. La valeur par défaut est 0.0

clearcoatRoughnessChannel : enumeration

Cette propriété définit le canal de texture utilisé pour lire la rugosité du vernis sur clearcoatRoughnessMap. La valeur par défaut est Material.G.

clearcoatRoughnessMap : Texture

Cette propriété définit une texture utilisée pour déterminer la rugosité de la couche de vernis. La valeur declearcoatRoughnessAmount sera multipliée par la valeur lue dans cette texture.

emissiveChannel : enumeration [since 6.8]

Cette propriété définit le canal de texture utilisé pour lire la valeur de la couleur émissive à partir de emissiveMap. Pour utiliser un seul canal de texture comme couleur, vous devez activer la propriété emissiveSingleChannelEnabled. La valeur par défaut est Material.R.

Cette propriété a été introduite dans Qt 6.8.

emissiveFactor : vector3d

Cette propriété détermine la couleur de l'auto-illumination pour ce matériau. Si une carte émissive est définie, les composantes x, y et z sont utilisées comme facteurs (multiplicateurs) pour les canaux R, G et B de la texture, respectivement. La valeur par défaut est (0, 0, 0), ce qui signifie qu'il n'y a pas de contribution émissive du tout.

emissiveMap : Texture

Cette propriété définit une texture RVB à utiliser pour spécifier l'intensité de la couleur émissive.

emissiveSingleChannelEnabled : bool [since 6.8]

Lorsque cette propriété est activée, le matériau utilise la valeur unique de emissiveChannel à partir de emissiveMap comme valeur RVB. La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.8.

fresnelBias : real

Cette propriété permet de repousser les réflexions frontales (en regardant directement la surface) tout en conservant les réflexions observées à des angles rasants. Pour pouvoir modifier le matériau, vous devez activer fresnelScaleBiasEnabled. La valeur par défaut est 0.0.

fresnelPower : real

Cette propriété diminue les réflexions frontales (en regardant directement la surface) tout en conservant les réflexions observées à des angles rasants. La valeur par défaut est 5.0.

fresnelScale : real

Cette propriété met à l'échelle les réflexions frontales (en regardant directement la surface) tout en conservant les réflexions observées à des angles rasants. Pour pouvoir modifier le matériau, vous devez activer fresnelScaleBiasEnabled. La valeur par défaut est 1.0.

fresnelScaleBiasEnabled : real

En fixant la valeur à true, le matériau prendra en compte l'échelle de Fresnel et le biais de Fresnel. La valeur par défaut est false.

glossiness : real

Cette propriété contrôle la taille des reflets spéculaires générés par les lumières et la clarté des reflets en général. Des valeurs plus petites augmentent la rugosité, adoucissent les reflets spéculaires et rendent les reflets plus flous. La plage de valeurs est [0.0, 1.0]. La valeur par défaut est 1.0.

glossinessChannel : enumeration

Cette propriété définit le canal de texture utilisé pour lire la valeur de brillance sur glossinessMap. La valeur par défaut est Material.A.

glossinessMap : Texture

Cette propriété définit une texture permettant de contrôler la brillance du matériau.

heightAmount : real

Cette propriété contient le facteur utilisé pour modifier les valeurs de la texture heightMap. La valeur doit être comprise entre 0.0 et 1.0. La valeur par défaut est 0.0, ce qui signifie que le déplacement en hauteur sera désactivé, même si une carte de hauteur est définie.

heightChannel : enumeration

Cette propriété définit le canal de texture utilisé pour lire la valeur de hauteur sur heightMap. La valeur par défaut est Material.R.

heightMap : Texture

Cette propriété définit une texture utilisée pour déterminer la hauteur à laquelle la texture sera déplacée lors du rendu grâce à l'utilisation de la cartographie parallaxe. Les valeurs sont censées être linéaires de 0,0 à 1,0, où 0,0 signifie aucun déplacement et 1,0 signifie un déplacement maximal.

invertOpacityMapValue : real [since 6.8]

Cette propriété inverse la valeur d'opacité de l'image opacityMap. La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.8.

lighting : enumeration

Cette propriété définit la méthode d'éclairage utilisée lors de la création de ce matériau.

La valeur par défaut est SpecularGlossyMaterial.FragmentLighting

lineWidth : real

Cette propriété détermine la largeur des lignes rendues, lorsque la géométrie utilise un type primitif de lignes ou de bandes de lignes. La valeur par défaut est 1.0. Cette propriété n'est pas pertinente pour le rendu d'autres types de géométrie, tels que les maillages triangulaires.

maxHeightMapSamples : int

Cette propriété définit le nombre maximum d'échantillons utilisés pour effectuer la cartographie d'occlusion parallexe à l'aide de heightMap. La valeur maxHeightMapSamples est le nombre d'échantillons de heightMap utilisés lorsque l'on regarde parallèlement à une surface. La valeur par défaut est 32.

Le nombre réel d'échantillons utilisés pour chaque fragment sera compris entre minHeightMapSamples et maxHeightMapSamples en fonction de l'angle de la caméra par rapport à la surface rendue.

minHeightMapSamples : int

Cette propriété définit le nombre minimum d'échantillons utilisés pour effectuer la cartographie d'occlusion parallexe à l'aide de heightMap. La valeur minHeightMapSamples correspond au nombre d'échantillons de heightMap utilisés lorsque l'on regarde directement une surface (lorsque la vue de la caméra est perpendiculaire au fragment). La valeur par défaut est 8.

Le nombre réel d'échantillons utilisés pour chaque fragment sera compris entre minHeightMapSamples et maxHeightMapSamples en fonction de l'angle de la caméra par rapport à la surface rendue.

normalMap : Texture

Cette propriété définit une image RVB utilisée pour simuler un déplacement géométrique fin à la surface du matériau. Les canaux RVB indiquent les écarts normaux XYZ.

normalStrength : real

Cette propriété contrôle la quantité de déplacement simulé pour le site normalMap.

occlusionAmount : real

Cette propriété contient le facteur utilisé pour modifier les valeurs de la texture occlusionMap. La valeur doit être comprise entre 0,0 et 1,0. La valeur par défaut est 1.0

occlusionChannel : enumeration

Cette propriété définit le canal de texture utilisé pour lire la valeur d'occlusion sur occlusionMap. La valeur par défaut est Material.R.

occlusionMap : Texture

Cette propriété définit une texture utilisée pour déterminer la quantité de lumière indirecte que les différentes zones du matériau doivent recevoir. Les valeurs sont censées être linéaires de 0,0 à 1,0, où 0,0 signifie qu'il n'y a pas d'éclairage indirect et 1,0 signifie que l'effet de l'éclairage indirect est laissé inchangé.

Voir également occlusionAmount.

opacity : real

Cette propriété réduit l'opacité de ce seul matériau, indépendamment du modèle.

opacityChannel : enumeration

Cette propriété définit le canal de texture utilisé pour lire la valeur d'opacité sur opacityMap. La valeur par défaut est Material.A.

opacityMap : Texture

Cette propriété définit une texture utilisée pour contrôler l'opacité différemment selon les parties du matériau.

pointSize : real

Cette propriété détermine la taille des points rendus, lorsque la géométrie utilise un type primitif de points. La valeur par défaut est 1.0. Cette propriété n'est pas pertinente pour le rendu d'autres types de géométrie, tels que les maillages triangulaires.

specularChannel : enumeration [since 6.8]

Cette propriété définit le canal de texture utilisé pour lire la valeur de la couleur spéculaire à partir de specularMap. Pour utiliser un seul canal de texture comme couleur, vous devez activer la propriété specularSingleChannelEnabled. La valeur par défaut est Material.R.

Cette propriété a été introduite dans Qt 6.8.

specularColor : color

Cette propriété définit la couleur RVB spéculaire. Si une valeur alpha est fournie, elle sera ignorée.

La valeur par défaut est Qt.White

specularMap : Texture

Cette propriété définit une texture à utiliser pour définir la couleur spéculaire des différentes parties du matériau. Seuls les canaux RVB sont utilisés.

specularSingleChannelEnabled : bool [since 6.8]

Lorsque cette propriété est activée, le matériau utilise la valeur unique de specularChannel à partir de specularMap comme valeur RVB. La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.8.

thicknessChannel : enumeration

Cette propriété définit le canal de texture utilisé pour lire la quantité d'épaisseur à partir de transmissionMap. La valeur par défaut est Material.G.

thicknessFactor : real

Cette propriété définit l'épaisseur du volume sous la surface. Contrairement à de nombreuses autres propriétés de SpecularGlossyMaterial, la valeur définie dans thicknessFactor est une valeur comprise entre 0,0 et +infini pour l'épaisseur dans l'espace de coordonnées du modèle. Une valeur de 0,0 signifie que le matériau est à parois minces. La valeur par défaut est 0.0

thicknessMap : Texture

Cette propriété définit une texture utilisée pour définir l'épaisseur d'un volume de matériau. La valeur de thicknessFactor sera multipliée par la valeur lue dans cette texture.

transmissionChannel : enumeration

Cette propriété définit le canal de texture utilisé pour lire le pourcentage de transmission sur transmissionMap. La valeur par défaut est Material.R.

transmissionFactor : real

Cette propriété définit le pourcentage de lumière transmise à travers la surface du matériau. La valeur par défaut est 0.0

transmissionMap : Texture

Cette propriété définit une texture utilisée pour déterminer le pourcentage de lumière transmise à travers la surface. La valeur de transmissionFactor sera multipliée par la valeur lue dans cette texture.

vertexColorAlphaMask : enumeration [since 6.8]

Cette propriété définit le canal alpha de la couleur du sommet utilisé comme masque de spécification. La valeur est une combinaison bit à bit de drapeaux. La valeur par défaut est SpecularGlossyMaterial.NoMask.

Cette propriété a été introduite dans Qt 6.8.

vertexColorBlueMask : enumeration [since 6.8]

Cette propriété définit le canal bleu de la couleur du vertex utilisé comme masque de spécification. La valeur est une combinaison bit à bit de drapeaux. La valeur par défaut est SpecularGlossyMaterial.NoMask.

Cette propriété a été introduite dans Qt 6.8.

vertexColorGreenMask : enumeration [since 6.8]

Cette propriété définit le canal vert de la couleur du vertex utilisé comme masque de spécification. La valeur est une combinaison bit à bit de drapeaux. La valeur par défaut est SpecularGlossyMaterial.NoMask.

Cette propriété a été introduite dans Qt 6.8.

vertexColorRedMask : enumeration [since 6.8]

Cette propriété définit le canal rouge de la couleur du vertex utilisé comme masque de spécification. La valeur est une combinaison bit à bit de drapeaux. La valeur par défaut est SpecularGlossyMaterial.NoMask.

Cette propriété a été introduite dans Qt 6.8.

vertexColorsEnabled : bool [since 6.5]

Lorsque cette propriété est activée, le matériau utilise les couleurs des vertex du maillage. Celles-ci seront multipliées par toutes les autres couleurs spécifiées pour le matériau. La valeur par défaut est true.

Cette propriété a été introduite dans Qt 6.5.

vertexColorsMaskEnabled : bool [since 6.8]

Lorsque cette propriété est activée, le matériau utilise les couleurs des vertex du maillage comme masque de diverses propriétés, par exemple Glossiness, OcclusionAmount, ... . La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.8.