PrincipledMaterial QML Type

알파 컷오프 프로퍼티는 Mask alphaMode 을 사용할 때 컷오프 값을 지정하는 데 사용할 수 있습니다. 알파 값이 임계값 아래로 떨어지는 조각은 완전히 투명하게 렌더링됩니다(모든 컬러 채널의 경우0.0 ). 알파 값이 컷오프 값보다 크거나 같으면 색상에 어떤 영향도 미치지 않습니다.

기본값은 0.5입니다.

alphaMode 를참조하세요 .

이 속성은 baseColor 의 알파 색상 값과 base color map 의 알파 채널이 사용되는 방식을 지정합니다.

alphaCutoff 및 blendMode 을참조하세요 .

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

이 프로퍼티는 빛이 파티클과 상호작용하기 전에 미디엄에서 이동하는 평균 거리로 주어진 미디엄의 밀도를 정의합니다. 이 값은 월드 스페이스에서 지정됩니다. 기본값은 +infinity 입니다.

이 프로퍼티는 머티리얼의 기본 색을 설정합니다. 지정된 머티리얼 유형(금속 또는 유전체)에 따라 디퓨즈 및 스페큘러 채널이 적절하게 설정됩니다. 예를 들어 유전체 재질은 기본 색상과 동일한 디퓨즈 색상을 가지며, 스페큘러 양에 따라 밝은 스페큘러 색상을 갖습니다. 금속의 경우 확산 채널과 스페큘러 채널이 기본 색상에서 혼합되어 어두운 확산 채널과 기본 색상에 가까운 스페큘러 채널을 갖습니다.

baseColorMap 및 alphaMode 을참조하십시오 .

이 프로퍼티는 baseColorMap 에서 baseColor 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 단일 텍스처 채널을 색상으로 사용하려면 baseColorSingleChannelEnabled 을 활성화해야 합니다. 기본값은 Material.R 입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 머티리얼의 기본 색을 설정하는 데 사용되는 텍스처를 정의합니다.

baseColor 및 alphaMode 을참조하십시오 .

이 속성을 활성화하면 머티리얼은 baseColorMap 에서 baseColorChannel 의 단일 값을 RGB 값으로 사용하고 알파 값으로 1.0을 사용합니다. 기본값은 false입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 렌더링된 모델의 색상이 그 뒤에 있는 색상과 블렌딩되는 방식을 결정합니다.

alphaMode 및 Qt Quick 3D 아키텍처를참조하세요 .

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

기본값은 0.0

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

이 프로퍼티는 스쳐가는 각도에서 보이는 반사를 유지하면서 정면 반사(표면을 직접 바라보는)를 앞으로 밀어냅니다. 머티리얼에 변경 사항을 적용하려면 clearcoatFresnelScaleBiasEnabled 을 활성화해야 합니다. 기본값은 0.0 입니다.

이 속성은 스치는 각도에서 보이는 반사를 유지하면서 정면 반사(표면을 직접 바라보는)를 줄입니다. 기본값은 5.0 입니다.

이 프로퍼티는 스치는 각도에서 보이는 반사를 유지하면서 정면 반사(표면을 직접 바라보는)의 크기를 조정합니다. 머티리얼에 변경 사항을 적용하려면 clearcoatFresnelScaleBiasEnabled 을 활성화해야 합니다. 기본값은 1.0 입니다.

값을 true로 설정하면 머티리얼이 Clearcoat 프레넬 스케일 및 Clearcoat 프레넬 바이어스를 고려합니다. 기본값은 false 입니다.

이 프로퍼티는 클리어코트 레이어의 강도를 결정하는 데 사용되는 텍스처를 정의합니다. clearcoatAmount 값에는 이 텍스처에서 읽은 값이 곱해집니다.

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

이 프로퍼티는 clearcoatNormalMap 에 대한 시뮬레이션된 변위의 양을 제어합니다.

이 프로퍼티는 클리어코트 레이어의 러프니스를 정의합니다. 기본값은 0.0

이 프로퍼티는 clearcoatRoughnessMap 에서 클리어코트 러프니스 양을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.G 입니다.

이 프로퍼티는 클리어코트 레이어의 러프니스를 결정하는 데 사용되는 텍스처를 정의합니다. clearcoatRoughnessAmount 값에 이 텍스처에서 읽은 값을 곱합니다.

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

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 이 머티리얼의 자체 조명 색을 결정합니다. 이미시브 맵이 설정된 경우 x, y 및 z 컴포넌트는 각각 텍스처의 R, G 및 B 채널에 대한 인수(승수)로 사용됩니다. 기본값은 (0, 0, 0)이며 이미시브 기여도가 전혀 없음을 의미합니다.

이 프로퍼티는 이미시브 컬러의 강도를 지정하는 데 사용할 RGB 텍스처를 설정합니다.

이 프로퍼티가 활성화되면 머티리얼은 emissiveMap 의 단일 값인 emissiveChannel 을 RGB 값으로 사용합니다. 기본값은 false입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 스쳐가는 각도에서 보이는 반사를 유지하면서 정면 반사(표면을 직접 바라보는)를 앞으로 밀어냅니다. 머티리얼에 변경 사항을 적용하려면 fresnelScaleBiasEnabled 을 활성화해야 합니다. 기본값은 0.0 입니다.

이 속성은 스치는 각도에서 보이는 반사를 유지하면서 정면 반사(표면을 직접 바라보는)를 줄입니다. 기본값은 5.0 입니다.

이 프로퍼티는 스치는 각도에서 보이는 반사를 유지하면서 정면 반사(표면을 직접 바라보는)의 크기를 조정합니다. 머티리얼에 변경 사항을 적용하려면 fresnelScaleBiasEnabled 을 활성화해야 합니다. 기본값은 1.0 입니다.

값을 true로 설정하면 머티리얼이 프레넬 스케일 및 프레넬 바이어스를 고려합니다. 기본값은 false 입니다.

이 프로퍼티에는 heightMap 텍스처의 값을 수정하는 데 사용되는 계수가 포함되어 있습니다. 값은 0.0에서 1.0 사이여야 합니다. 기본값은 0.0으로, 높이 맵이 설정되어 있어도 높이 변위가 비활성화됩니다.

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

이 프로퍼티는 패럴랙스 매핑을 사용하여 렌더링할 때 텍스처가 변위될 높이를 결정하는 데 사용되는 텍스처를 정의합니다. 값은 0.0에서 1.0 사이의 선형 값으로 예상되며, 0.0은 변위 없음, 1.0은 최대 변위를 의미합니다.

이 속성은 머티리얼의 굴절률을 정의합니다. 기본값 1.5 은 플라스틱이나 유리와 같은 재질에 이상적인 값이지만 물, 아스팔트, 사파이어 또는 다이아몬드와 같은 다른 재질은 보다 사실적으로 보이도록 값을 조정해야 합니다. 사실적인 머티리얼의 경우 인덱스 오브 리프랙션은 일반적으로 1.0 과 3.0

다음은 일반적인 머티리얼의 굴절률의 몇 가지 예입니다:

이 프로퍼티는 opacityMap 의 불투명도 값을 반전시킵니다. 기본값은 false 입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 이 머티리얼을 생성할 때 사용되는 조명 방법을 정의합니다.

기본값은 다음과 같습니다. PrincipledMaterial.FragmentLighting

PrincipledMaterial.FragmentLighting 을 사용하는 경우 렌더링된 각 픽셀에 대해 디퓨즈 및 스페큘러 조명이 계산됩니다. 특정 효과(예: 프레넬 또는 노멀 맵)가 작동하려면 PrincipledMaterial.FragmentLighting 이 필요합니다.

PrincipledMaterial.NoLighting 를 사용하는 경우 조명이 계산되지 않습니다. 이 모드는 (예상대로) 매우 빠르며 조명으로 음영 처리할 필요가 없는 이미지 맵을 사용할 때 매우 효과적입니다. baseColor 값, 알파 값 및 버텍스 색을 제외한 다른 모든 음영 속성은 무시됩니다.

이 속성은 지오메트리가 기본 유형의 선 또는 선 스트립을 사용하는 경우 렌더링되는 선의 너비를 결정합니다. 기본값은 1.0입니다. 이 속성은 삼각형 메쉬와 같은 다른 유형의 지오메트리를 렌더링할 때는 관련이 없습니다.

이 프로퍼티는 heightMap 를 사용하여 패럴렉스 오클루전 매핑을 수행하는 데 사용되는 최대 샘플 수를 정의합니다. 최대 높이맵샘플 값은 표면과 평행하게 볼 때 사용되는 heightMap 의 샘플 수입니다. 기본값은 32입니다.

각 조각에 사용되는 실제 샘플 수는 렌더링되는 표면을 기준으로 한 카메라 각도에 따라 minHeightMapSamples 와 maxHeightMapSamples 사이가 됩니다.

금속성 프로퍼티는 머티리얼의 금속성을 정의합니다. 이 값은 정규화되며 0.0은 재료가 유전체 (비금속) 재료임을 의미하고 1.0은 재료가 금속임을 의미합니다.

범위는 [0.0, 1.0]입니다. 기본값은 0입니다.

이 프로퍼티는 metalnessMap 에서 금속성 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.B 입니다.

이 프로퍼티는 머티리얼의 여러 부분에 대한 금속성 양을 설정하는 데 사용할 텍스처를 설정합니다.

이 프로퍼티는 heightMap 을 사용하여 패럴렉스 오클루전 매핑을 수행하는 데 사용되는 최소 샘플 수를 정의합니다. minHeightMapSamples 값은 표면을 직접 볼 때(카메라 뷰가 조각에 수직인 경우) 사용되는 heightMap 의 샘플 수입니다. 기본값은 8입니다.

각 조각에 사용되는 실제 샘플 수는 렌더링되는 표면에 대한 카메라의 각도에 따라 minHeightMapSamples와 maxHeightMapSamples 사이가 됩니다.

이 프로퍼티는 머티리얼 표면의 미세한 지오메트리 변위를 시뮬레이션하는 데 사용되는 RGB 이미지를 정의합니다. RGB 채널은 XYZ 노멀 편차를 나타냅니다.

이 프로퍼티는 normalMap 에 대한 시뮬레이션된 변위의 양을 제어합니다.

이 프로퍼티에는 occlusionMap 텍스처의 값을 수정하는 데 사용되는 계수가 포함되어 있습니다. 값은 0.0에서 1.0 사이여야 합니다. 기본값은 1.0입니다.

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

이 프로퍼티는 머티리얼의 여러 영역이 받아야 하는 빛의 양을 결정하는 데 사용되는 텍스처를 정의합니다. 값은 0.0에서 1.0 사이의 선형 값으로 예상되며, 0.0은 조명 없음, 1.0은 조명 효과가 변경되지 않음을 의미합니다.

occlusionAmount 를참조하세요 .

이 프로퍼티는 모델과 별도로 이 머티리얼의 불투명도만 떨어뜨립니다.

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

이 프로퍼티는 머티리얼의 여러 부분에 대해 불투명도를 다르게 제어하는 데 사용되는 텍스처를 정의합니다.

이 속성은 지오메트리가 프리미티브 유형의 점을 사용하는 경우 렌더링되는 점의 크기를 결정합니다. 기본값은 1.0입니다. 이 속성은 삼각형 메쉬와 같은 다른 유형의 지오메트리를 렌더링할 때는 관련이 없습니다.

이 프로퍼티는 조명에서 생성되는 스페큘러 하이라이트의 크기와 일반적으로 반사의 선명도를 제어합니다. 값이 클수록 러프니스가 증가하여 스페큘러 하이라이트가 부드러워지고 반사가 흐려집니다. 범위는 [0.0, 1.0]입니다. 기본값은 0입니다.

이 프로퍼티는 roughnessMap 에서 러프니스 값을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.G 입니다.

이 프로퍼티는 머티리얼의 스페큘러 러프니스를 제어하는 텍스처를 정의합니다.

이 프로퍼티는 스페큘러(하이라이트 및 반사)의 강도를 제어합니다.

범위는 [0.0, 1.0]입니다. 기본값은 1.0 입니다.

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

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 RGB 텍스처를 정의하여 머티리얼 표면의 스페큘러 양과 색을 조절합니다. 이 값은 specularAmount 을 곱합니다.

이 프로퍼티는 머티리얼의 스페큘러 하이라이트에 사용되는 텍스처를 설정합니다.

일반적으로 환경 매핑을 수행하는 데 사용되며, 모델을 회전하면 맵이 환경에서 반사되는 것처럼 나타납니다. 이것이 예상대로 작동하려면 텍스처의 mappingMode 를 Texture.Environment로 설정해야 합니다. 스페큘러 리플렉션 맵은 비교적 저렴한 비용으로 고품질의 모양을 쉽게 추가할 수 있는 방법입니다.

Texture::mappingMode 을참조하십시오 .

이 프로퍼티를 활성화하면 머티리얼은 specularMap 의 단일 값인 specularChannel 을 RGB 값으로 사용합니다. 기본값은 false입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 스페큘러 리플렉션에 기여하는 베이스 컬러의 양을 정의합니다.

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

이 프로퍼티는 표면 아래 볼륨의 두께를 정의합니다. PrincipledMaterial 의 다른 많은 프로퍼티와 달리 두께 팩터에 정의된 값은 모델 좌표 공간에서 두께에 대해 0.0에서 + 무한대까지의 값입니다. 값이 0.0이면 머티리얼의 벽이 얇다는 뜻입니다. 기본값은 0.0

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

이 프로퍼티는 transmissionMap 에서 전송 비율을 읽는 데 사용되는 텍스처 채널을 정의합니다. 기본값은 Material.R 입니다.

이 프로퍼티는 머티리얼의 표면을 통해 투과되는 빛의 비율을 정의합니다. 기본값은 다음과 같습니다. 0.0

이 프로퍼티는 표면을 통해 투과되는 빛의 비율을 결정하는 데 사용되는 텍스처를 정의합니다. transmissionFactor 값에 이 텍스처에서 읽은 값을 곱합니다.

이 프로퍼티는 지정 마스크로 사용되는 버텍스 컬러 알파 채널을 정의합니다. 값은 비트 단위의 플래그 조합입니다. 기본값은 PrincipledMaterial.NoMask 입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 지정 마스크로 사용되는 버텍스 컬러 블루 채널을 정의합니다. 값은 비트 단위의 플래그 조합입니다. 기본값은 PrincipledMaterial.NoMask 입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 지정 마스크로 사용되는 버텍스 컬러 녹색 채널을 정의합니다. 값은 비트 단위의 플래그 조합입니다. 기본값은 PrincipledMaterial.NoMask 입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티는 지정 마스크로 사용되는 버텍스 컬러 레드 채널을 정의합니다. 값은 비트 단위의 플래그 조합입니다. 기본값은 PrincipledMaterial.NoMask 입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

이 프로퍼티가 활성화되면 머티리얼은 메시의 버텍스 컬러를 사용합니다. 여기에는 머티리얼에 지정된 다른 색이 곱해집니다. 기본값은 참입니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.

이 프로퍼티를 활성화하면 머티리얼은 메시의 버텍스 컬러를 다양한 프로퍼티(예: 러프니스 양, 스페큘러 양, ...)의 마스크로 사용합니다. 기본값은 false입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.