QMetalRoughMaterial Class

class Qt3DExtras::QMetalRoughMaterial

QMetalRoughMaterial은 PBR 조명의 기본 구현을 제공합니다. 더 보기...

Header: #include <QMetalRoughMaterial>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
QML에서: MetalRoughMaterial
상속합니다: Qt3DRender::QMaterial
상태: Deprecated

속성

공용 기능

QMetalRoughMaterial(Qt3DCore::QNode *parent = nullptr)
virtual ~QMetalRoughMaterial()
QVariant ambientOcclusion() const
QVariant baseColor() const
QVariant metalness() const
QVariant normal() const
QVariant roughness() const
float textureScale() const

공용 슬롯

void setAmbientOcclusion(const QVariant &ambientOcclusion)
void setBaseColor(const QVariant &baseColor)
void setMetalness(const QVariant &metalness)
void setNormal(const QVariant &normal)
void setRoughness(const QVariant &roughness)
void setTextureScale(float textureScale)

신호

void ambientOcclusionChanged(const QVariant &ambientOcclusion)
void baseColorChanged(const QVariant &baseColor)
void metalnessChanged(const QVariant &metalness)
void normalChanged(const QVariant &normal)
void roughnessChanged(const QVariant &roughness)
void textureScaleChanged(float textureScale)

상세 설명

이 머티리얼은 단일 렌더 패스 방식의 이펙트를 사용하며 조각별 라이팅을 수행합니다. OpenGL 3 및 OpenGL ES 3용 기법이 제공됩니다.

프로퍼티 문서

ambientOcclusion : QVariant

머티리얼의 현재 앰비언트 오클루전 맵 텍스처를 보유합니다. 텍스처만 가능하며, 그렇지 않으면 무시됩니다. 기본적으로 이 맵은 설정되지 않습니다.

함수 액세스:

QVariant ambientOcclusion() const
void setAmbientOcclusion(const QVariant &ambientOcclusion)

알림 신호:

void ambientOcclusionChanged(const QVariant &ambientOcclusion)

baseColor : QVariant

머티리얼의 현재 기본 색을 보유합니다. 일반 색상 값이나 텍스처가 될 수 있습니다. 기본적으로 이 프로퍼티의 값은 "회색"입니다.

함수에 액세스합니다:

QVariant baseColor() const
void setBaseColor(const QVariant &baseColor)

알림 신호:

void baseColorChanged(const QVariant &baseColor)

metalness : QVariant

머티리얼의 현재 금속성 수준을 0(순수 유전체, 기본값)에서 1(순수 금속성) 사이의 값으로 유지합니다. 이 값은 일반 균일 값 또는 텍스처가 될 수 있습니다. 기본적으로 이 프로퍼티의 값은 0입니다.

함수에 액세스합니다:

QVariant metalness() const
void setMetalness(const QVariant &metalness)

알림 신호:

void metalnessChanged(const QVariant &metalness)

normal : QVariant

머티리얼의 현재 노멀 맵 텍스처를 보유합니다. 텍스처만 가능하며, 그렇지 않으면 무시됩니다. 기본적으로 이 맵은 설정되지 않습니다.

함수 액세스:

QVariant normal() const
void setNormal(const QVariant &normal)

알림 신호:

void normalChanged(const QVariant &normal)

roughness : QVariant

머티리얼의 현재 러프니스 레벨을 보유합니다. 이 값은 일반 균일 값 또는 텍스처일 수 있습니다. 기본적으로 이 프로퍼티의 값은 0입니다.

함수에 액세스합니다:

QVariant roughness() const
void setRoughness(const QVariant &roughness)

알림 신호:

void roughnessChanged(const QVariant &roughness)

textureScale : float

현재 텍스처 스케일을 유지합니다. 렌더링 시 텍스처 좌표에 배율로 적용됩니다. 기본값은 1.0입니다.

QTextureWrapMode::Repeat와 함께 사용할 경우, textureScale은 표면 전체에 텍스처를 타일링하는 간단한 방법을 제공합니다. 예를 들어, 텍스처 스케일이 4.0 인 경우 16(4x4) 타일이 생성됩니다.

함수에 액세스합니다:

float textureScale() const
void setTextureScale(float textureScale)

알림 신호:

void textureScaleChanged(float textureScale)

멤버 함수 문서

[explicit] QMetalRoughMaterial::QMetalRoughMaterial(Qt3DCore::QNode *parent = nullptr)

부모 오브젝트가 있는 새 QMetalRoughMaterial 인스턴스 parent 를 생성합니다.

[virtual noexcept] QMetalRoughMaterial::~QMetalRoughMaterial()

QMetalRoughMaterial 인스턴스를 삭제합니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.