SpecularGlossyMaterial QML Type

스페큘러/광택 워크플로를 사용하여 3D 아이템의 재질을 정의할 수 있습니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• 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)

상세 설명

씬에서 모델을 렌더링하기 전에, 메시에 적용될 셰이딩 방식을 정의하는 머티리얼이 적어도 하나 이상 연결되어 있어야 합니다. SpecularGlossyMaterial은 최소한의 매개변수 세트로 사용하기 쉬운 PBR 스페큘러/광택 머티리얼입니다. 매개변수가 적은 것 외에도, 모든 입력 값은 0과 1 사이로 엄격하게 정규화되어 있으며 합리적인 기본값이 설정되어 있습니다. 즉, 값을 변경하지 않아도 이 머티리얼을 사용하여 모델에 셰이딩을 적용할 수 있습니다. SpecularGlossyMaterial의 다양한 속성이 모델의 셰이딩에 어떤 영향을 미치는지에 대한 소개는, Specular/Glossy 워크플로우를 사용하는 방법을 보여주는 ‘Principled Material’ 예제를 참조하십시오.

대신 메탈릭/러프니스 워크플로를 사용하려면 PrincipledMaterial 를 참조하십시오.

스펙큘러/광택 워크플로

SpecularGlossyMaterial은 스페큘러/광택 유형 워크플로를 사용하여 머티리얼을 생성하는 방법을 제공합니다. 이 머티리얼의 주요 속성은 specular, glossiness, albedo 속성을 통해 제어됩니다.

스페큘러

specularColor 속성은 오브젝트 표면의 스페큘러 양과 색상을 정의합니다. 반사성 머티리얼의 경우, 주된 색상 기여도는 이 속성에서 비롯됩니다.

광택도

재료의 glossiness 는 물체 표면의 상태를 나타냅니다. glossiness 값이 높을수록 물체의 표면이 매끄러워, glossiness 값이 낮은 재료보다 반사율이 더 높아집니다.

알베도

알베도( albedoColor ) 속성은 재료의 확산 색상을 나타내며, 반사율( PrincipledMaterial)의 기본 색상과 달리 알베도에는 재료의 반사율에 대한 정보가 포함되어 있지 않습니다. 즉, 반사성 표면의 경우 알베도의 색상 값을 검은색 계열로 설정해야 하며, 이렇게 해야만 사양색(specular color)이 제대로 반영될 수 있습니다.

속성 설명서

albedoChannel : enumeration [since 6.8]

이 속성은 albedoMap 에서 알베도 색상 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 단일 텍스처 채널을 색상으로 사용하려면 ‘ albedoSingleChannelEnabled ’을 활성화해야 합니다. 기본값은 Material.R 입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

albedoColor : color

이 속성은 머티리얼의 알베도 색상을 설정합니다. 디퓨즈 색상을 검은색 계열로 설정하면 순수한 스페큘러 머티리얼(예: 금속이나 거울)이 생성됩니다.

albedoMap 및 alphaMode도 참조하십시오 .

albedoMap : Texture

이 속성은 머티리얼의 알베도 색상을 설정하는 데 사용되는 텍스처를 정의합니다.

albedo 및 alphaMode도 참조하십시오 .

albedoSingleChannelEnabled : bool [since 6.8]

이 속성이 활성화되면, 머티리얼은 albedoMap 의 ‘ albedoChannel ’에서 반환된 단일 값을 RGB 값으로 사용하고, 알파 값으로는 1.0을 사용합니다. 기본값은 false입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

alphaCutoff : real

alphaCutoff 속성은 Mask alphaMode 를 사용할 때 임계값을 지정하는 데 사용할 수 있습니다. 알파 값이 임계값보다 낮은 프래그먼트는 완전히 투명하게 렌더링됩니다(모든 색상 채널에 대해0.0 ). 알파 값이 임계값과 같거나 더 클 경우, 색상에는 어떠한 영향도 미치지 않습니다.

기본값은 0.5입니다.

alphaMode도 참조하십시오 .

alphaMode : enumeration

이 속성은 albedoColor 의 알파 색상 값과 albedo map 의 알파 채널이 어떻게 사용되는지를 지정합니다.

alphaCutoff 및 blendMode도 참조하십시오 .

attenuationColor : color

이 속성은 백색광이 감쇠 거리에 도달했을 때 흡수로 인해 변하는 색상을 정의합니다. 기본값은 Qt.White

attenuationDistance : real

이 속성은 매질 내의 빛이 입자와 상호작용하기 전까지 이동하는 평균 거리로 정의되는 매질의 밀도를 나타냅니다. 이 값은 월드 공간 기준으로 표시됩니다. 기본값은 +infinity 입니다.

blendMode : enumeration

이 속성은 렌더링된 모델의 색상이 배경의 색상과 어떻게 혼합되는지를 결정합니다.

alphaMode 및 Qt Quick 3D 아키텍처도 참조하십시오 .

clearcoatAmount : real

이 속성은 클리어코트 층의 농도를 정의합니다.

기본값은 0.0

clearcoatChannel : enumeration

이 속성은 clearcoatMap 에서 클리어코트 양 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.R 입니다.

clearcoatFresnelBias : real

이 속성은 사선 각도에서 보이는 반사를 유지하면서 정면 반사(표면을 정면으로 바라볼 때)를 강조합니다. 이 재질에 변경 사항을 적용하려면 ‘ clearcoatFresnelScaleBiasEnabled ’를 활성화해야 합니다. 기본값은 ‘ 0.0 ’입니다.

clearcoatFresnelPower : real

이 속성은 사선 각도에서 보이는 반사는 유지하면서 정면 반사(표면을 정면으로 바라볼 때)를 줄여줍니다. 기본값은 5.0 입니다.

clearcoatFresnelScale : real

이 속성은 표면을 정면에서 바라볼 때 나타나는 정면 반사광의 강도를 조절하는 동시에, 사선 각도에서 보이는 반사광은 그대로 유지합니다. 이 소재에 변경 사항을 적용하려면 ‘ clearcoatFresnelScaleBiasEnabled ’를 활성화해야 합니다. 기본값은 ‘ 1.0 ’입니다.

clearcoatFresnelScaleBiasEnabled : real

이 값을 true로 설정하면 머티리얼이 ‘클리어코트 프레넬 스케일(Clearcoat Fresnel Scale)’과 ‘클리어코트 프레넬 바이어스(Clearcoat Fresnel Bias)’를 반영합니다. 기본값은 ‘ false ’입니다.

clearcoatMap : Texture

이 속성은 클리어코트 층의 농도를 결정하는 데 사용되는 텍스처를 정의합니다. ‘clearcoatAmount ’의 값은 이 텍스처에서 읽은 값과 곱해집니다.

clearcoatNormalMap : Texture

이 속성은 클리어코트 레이어에 적용되는 노멀 매핑을 결정하는 데 사용되는 텍스처를 정의합니다.

clearcoatRoughnessAmount : real

이 속성은 클리어코트 층의 거칠기를 정의합니다. 기본값은 0.0

clearcoatRoughnessChannel : enumeration

이 속성은 clearcoatRoughnessMap 에서 클리어코트의 거칠기 정도를 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.G 입니다.

clearcoatRoughnessMap : Texture

이 속성은 클리어코트 층의 거칠기를 결정하는 데 사용되는 텍스처를 정의합니다. ‘clearcoatRoughnessAmount ’의 값에는 이 텍스처에서 읽은 값이 곱해집니다.

emissiveChannel : enumeration [since 6.8]

이 속성은 emissiveMap 에서 발광 색상 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 단일 텍스처 채널을 색상으로 사용하려면 ‘ emissiveSingleChannelEnabled ’을 활성화해야 합니다. 기본값은 ‘ Material.R ’입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

emissiveFactor : vector3d

이 속성은 해당 머티리얼의 자체 발광 색상을 결정합니다. 발광 맵이 설정된 경우, x, y, z 성분은 각각 텍스처의 R, G, B 채널에 대한 계수(배율)로 사용됩니다. 기본값은 (0, 0, 0)이며, 이는 발광 효과가 전혀 적용되지 않음을 의미합니다.

emissiveMap : Texture

이 속성은 발광 색상의 밝기를 지정하는 데 사용될 RGB 텍스처를 설정합니다.

emissiveSingleChannelEnabled : bool [since 6.8]

이 속성이 활성화되면, 머티리얼은 ‘ emissiveMap ’의 ‘ emissiveChannel ’에서 지정된 단일 값을 RGB 값으로 사용합니다. 기본값은 false입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

fresnelBias : real

이 속성은 사선 각도에서 보이는 반사를 유지하면서 정면 반사(표면을 정면으로 바라볼 때)를 강조합니다. 이 재질에 변경 사항을 적용하려면 ‘ fresnelScaleBiasEnabled ’를 활성화해야 합니다. 기본값은 ‘ 0.0 ’입니다.

fresnelPower : real

이 속성은 직각 반사(표면을 정면으로 바라볼 때)를 줄이면서, 사선 각도에서 보이는 반사는 그대로 유지합니다. 기본값은 5.0 입니다.

fresnelScale : real

이 속성은 표면을 정면에서 바라볼 때 나타나는 정면 반사광의 강도를 조절하는 동시에, 사선 각도에서 보이는 반사광은 그대로 유지합니다. 이 머티리얼에 변경 사항을 적용하려면 ‘ fresnelScaleBiasEnabled ’를 활성화해야 합니다. 기본값은 ‘ 1.0 ’입니다.

fresnelScaleBiasEnabled : real

이 값을 true로 설정하면 머티리얼이 프레넬 스케일(Fresnel Scale)과 프레넬 바이어스(Fresnel Bias)를 반영합니다. 기본값은 false 입니다.

glossiness : real

이 속성은 빛에 의해 생성되는 스페큘러 하이라이트의 크기와 전반적인 반사의 선명도를 제어합니다. 값이 작을수록 표면의 거칠기가 증가하여 스페큘러 하이라이트가 부드러워지고 반사가 흐릿해집니다. 범위는 [0.0, 1.0]입니다. 기본값은 1.0 입니다.

glossinessChannel : enumeration

이 속성은 glossinessMap 에서 광택도 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.A 입니다.

glossinessMap : Texture

이 속성은 머티리얼의 광택도를 제어하는 텍스처를 정의합니다.

heightAmount : real

이 속성에는 ‘ heightMap ’ 텍스처의 값을 조정하는 데 사용되는 배율이 포함되어 있습니다. 값은 0.0에서 1.0 사이여야 합니다. 기본값은 0.0이며, 이는 높이 맵이 설정되어 있더라도 높이 변위가 비활성화된다는 것을 의미합니다.

heightChannel : enumeration

이 속성은 heightMap 에서 높이 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.R 입니다.

heightMap : Texture

이 속성은 패럴랙스 매핑을 통해 렌더링될 때 텍스처가 변위되는 높이를 결정하는 데 사용되는 텍스처를 정의합니다. 값은 0.0에서 1.0 사이의 선형 값이어야 하며, 0.0은 변위가 없음을, 1.0은 최대 변위를 의미합니다.

invertOpacityMapValue : real [since 6.8]

이 속성은 ` opacityMap`의 불투명도 값을 반전시킵니다. 기본값은 ` false`입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

lighting : enumeration

이 속성은 이 머티리얼을 생성할 때 어떤 조명 기법을 사용할지 정의합니다.

기본값은 SpecularGlossyMaterial.FragmentLighting

lineWidth : real

이 속성은 지오메트리가 ‘선’ 또는 ‘선 스트립’ 프라이미티브 유형을 사용할 때 렌더링되는 선의 너비를 결정합니다. 기본값은 1.0입니다. 이 속성은 삼각형 메쉬와 같은 다른 유형의 지오메트리를 렌더링할 때는 적용되지 않습니다.

maxHeightMapSamples : int

이 속성은 ‘ heightMap ’을 사용하여 패럴랙스 오클루전 매핑(Parallex Occlusion Mapping)을 수행하는 데 사용되는 최대 샘플 수를 정의합니다. maxHeightMapSamples 값은 표면을 평행하게 바라볼 때 ‘ heightMap ’의 샘플 중 사용되는 개수를 나타냅니다. 기본값은 32입니다.

각 프래그먼트에 실제로 사용되는 샘플 수는 렌더링되는 표면에 대한 카메라의 각도에 따라 ` minHeightMapSamples `과 `maxHeightMapSamples` 사이에서 결정됩니다.

minHeightMapSamples : int

이 속성은 높이 맵( heightMap)을 사용하여 패럴랙스 오클루전 매핑(Parallex Occlusion Mapping)을 수행하는 데 사용되는 최소 샘플 수를 정의합니다. minHeightMapSamples 값은 표면을 정면으로 바라볼 때(카메라 시선이 프래그먼트에 수직일 때) 높이 맵( heightMap )의 샘플 중 사용되는 수를 나타냅니다. 기본값은 8입니다.

각 프래그먼트에 실제로 사용되는 샘플 수는 렌더링되는 표면에 대한 카메라의 각도에 따라 `minHeightMapSamples`와 ` maxHeightMapSamples ` 사이의 값이 됩니다.

normalMap : Texture

이 속성은 머티리얼 표면 전반에 걸쳐 미세한 지오메트리 변위를 시뮬레이션하는 데 사용되는 RGB 이미지를 정의합니다. RGB 채널은 X, Y, Z 방향의 법선 편차를 나타냅니다.

normalStrength : real

이 속성은 ‘ normalMap ’에 대한 시뮬레이션 변위량을 제어합니다.

occlusionAmount : real

이 속성은 ‘ occlusionMap ’ 텍스처의 값을 조정하는 데 사용되는 배율을 포함합니다. 값은 0.0에서 1.0 사이여야 합니다. 기본값은 1.0입니다.

occlusionChannel : enumeration

이 속성은 occlusionMap 에서 오클루전 값을 읽어오는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.R 입니다.

occlusionMap : Texture

이 속성은 머티리얼의 각 영역이 받는 간접광의 양을 결정하는 데 사용되는 텍스처를 정의합니다. 값은 0.0에서 1.0 사이의 선형 값이어야 하며, 0.0은 간접광이 전혀 없음을, 1.0은 간접광의 효과가 변경되지 않음을 의미합니다.

occlusionAmount도 참조하십시오 .

opacity : real

이 속성은 모델과는 별도로, 오직 이 머티리얼의 불투명도만 낮춥니다.

opacityChannel : enumeration

이 속성은 opacityMap 에서 불투명도 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.A 입니다.

opacityMap : Texture

이 속성은 머티리얼의 각 부분에 따라 불투명도를 다르게 제어하는 데 사용되는 텍스처를 정의합니다.

pointSize : real

이 속성은 지오메트리가 ‘점’ 원시형을 사용할 때 렌더링되는 점의 크기를 결정합니다. 기본값은 1.0입니다. 이 속성은 삼각형 메쉬와 같은 다른 유형의 지오메트리를 렌더링할 때는 적용되지 않습니다.

specularChannel : enumeration [since 6.8]

이 속성은 ‘ specularMap ’에서 스페큘러 색상 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 단일 텍스처 채널을 색상으로 사용하려면 ‘ specularSingleChannelEnabled ’를 활성화해야 합니다. 기본값은 ‘ Material.R ’입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

specularColor : color

이 속성은 스페큘러 RGB 색상을 정의합니다. 알파 값이 지정된 경우 무시됩니다.

기본값은 Qt.White

specularMap : Texture

이 속성은 머티리얼의 각 부분에 대한 스페큘러 색상을 설정하는 데 사용될 텍스처를 지정합니다. RGB 채널만 사용됩니다.

specularSingleChannelEnabled : bool [since 6.8]

이 속성이 활성화되면, 머티리얼은 ‘ specularMap ’의 ‘ specularChannel ’에 지정된 단일 값을 RGB 값으로 사용합니다. 기본값은 false입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

thicknessChannel : enumeration

이 속성은 transmissionMap 에서 두께 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.G 입니다.

thicknessFactor : real

이 속성은 표면 아래에 있는 부피의 두께를 정의합니다. ` SpecularGlossyMaterial`의 다른 많은 속성과는 달리, `thicknessFactor`에 정의된 값은 모델 좌표계에서 두께를 나타내는 0.0부터 +무한대까지의 값입니다. 0.0은 재료가 얇은 벽을 가지고 있음을 의미합니다. 기본값은 0.0

thicknessMap : Texture

이 속성은 머티리얼 볼륨의 두께를 정의하는 데 사용되는 텍스처를 지정합니다. ‘ thicknessFactor ’의 값에는 이 텍스처에서 읽은 값이 곱해집니다.

transmissionChannel : enumeration

이 속성은 transmissionMap 에서 투과율을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.R 입니다.

transmissionFactor : real

이 속성은 재료 표면을 통과하는 빛의 비율을 백분율로 나타냅니다. 기본값은 0.0

transmissionMap : Texture

이 속성은 표면을 통과하는 빛의 비율을 결정하는 데 사용되는 텍스처를 정의합니다. ‘ transmissionFactor ’의 값은 이 텍스처에서 읽은 값과 곱해집니다.

vertexColorAlphaMask : enumeration [since 6.8]

이 속성은 지정된 마스크로 사용되는 정점 색상의 알파 채널을 정의합니다. 이 값은 플래그들의 비트 단위 조합입니다. 기본값은 SpecularGlossyMaterial.NoMask 입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

vertexColorBlueMask : enumeration [since 6.8]

이 속성은 지정된 마스크로 사용되는 정점 색상의 파란색 채널을 정의합니다. 이 값은 플래그들의 비트 단위 조합입니다. 기본값은 SpecularGlossyMaterial.NoMask 입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

vertexColorGreenMask : enumeration [since 6.8]

이 속성은 지정된 마스크로 사용되는 정점 색상의 녹색 채널을 정의합니다. 이 값은 플래그들의 비트별 조합입니다. 기본값은 SpecularGlossyMaterial.NoMask 입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

vertexColorRedMask : enumeration [since 6.8]

이 속성은 지정된 마스크로 사용되는 정점 색상의 빨간색 채널을 정의합니다. 값은 플래그의 비트 단위 조합입니다. 기본값은 SpecularGlossyMaterial.NoMask 입니다.

이 속성은 Qt 6.8에서 도입되었습니다.

vertexColorsEnabled : bool [since 6.5]

이 속성이 활성화되면, 머티리얼은 메시의 버텍스 색상을 사용합니다. 이 색상들은 머티리얼에 지정된 다른 색상들과 곱해집니다. 기본값은 true입니다.

이 속성은 Qt 6.5에서 도입되었습니다.

vertexColorsMaskEnabled : bool [since 6.8]

이 속성이 활성화되면, 머티리얼은 메쉬의 버텍스 컬러를 광택도(Glossiness), 오클루전 양(OcclusionAmount) 등 다양한 속성의 마스크로 사용합니다. 기본값은 false입니다.

이 속성은 Qt 6.8에서 도입되었습니다.