Model QML Type

이 프로퍼티가 유효하고 활성화된 BakedLightmap 객체로 설정되면 모델은 조명을 베이킹할 때 생성된 라이트맵을 가져오고, 라이트맵은 영구적으로 저장됩니다. 렌더링할 때 모델은 연결된 라이트맵을 로드하여 사용합니다. 기본값은 null입니다.

라이트맵을 베이크하는 방법에 대한 자세한 내용은 Lightmapper 문서를 참조하세요.

이 속성은 베이킹할 때와 라이트맵을 사용할 때 모두 관련이 있습니다. 베이킹 실행과 생성된 데이터를 사용하는 후속 실행 간에 일관된 상태가 필수적입니다. 예를 들어 라이트맵 키를 변경하면 이전에 생성된 데이터를 로드할 수 없게 됩니다. 예외적으로 enabled 를 사용하여 베이킹 실행 외부에서 라이트맵 사용을 동적으로 전환할 수 있지만 렌더링된 결과는 씬의 조명 bakeMode 설정에 따라 달라질 수 있다는 점에 유의하세요.

usedInBakedLighting 및 Lightmapper 을참조하세요 .

모델의 바운드는 모델 주변의 바운딩 볼륨의 범위를 나타냅니다.

이 프로퍼티가 true 로 설정되면 모델은 반사 프로브에 의해 렌더링되며 리플렉션에서 볼 수 있습니다.

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

이 프로퍼티가 true 인 경우 이 모델의 지오메트리는 섀도 맵에 렌더링할 때 사용되며 베이크된 조명에서도 그림자를 생성합니다.

기본값은 true 입니다.

모델의 깊이 바이어스를 보유합니다. 오브젝트를 정렬할 때 카메라로부터의 오브젝트 거리에 뎁스 바이어스가 추가됩니다. 이 값을 사용하면 프레임마다 다른 순서로 렌더링될 수 있는 서로 가까운 오브젝트 간의 렌더링 순서를 강제할 수 있습니다. 음수 값은 정렬 값을 카메라에 더 가깝게 이동시키고 양수 값은 카메라에서 더 멀리 이동시킵니다.

모델에 대한 사용자 지정 지오메트리를 지정합니다. 사용자 지정 지오메트리를 사용하는 경우 Model::source 은 비어 있어야 합니다.

이 속성은 인스턴스의 좌표계의 원점을 정의합니다.

자세한 설명은 개요 문서를 참조하세요.

instancing 및 Instancing 을참조하세요 .

이 속성을 설정하면 모델이 정상적으로 렌더링되지 않습니다. 대신 인스턴스 테이블에 정의된 대로 모델의 여러 인스턴스가 렌더링됩니다.

Instancing도 참조하세요 .

이 모델의 인스턴스가 표시되는 카메라로부터의 최대 거리를 정의합니다. 세부 수준 구현에 사용됩니다.

이 모델의 인스턴스가 표시되는 카메라로부터의 최소 거리를 정의합니다. 세부 수준 구현에 사용됩니다.

이 프로퍼티에는 스켈레탈 애니메이션에 사용되는 역 바인드 포즈 매트릭스 목록이 포함되어 있습니다. 각 inverseBindPose 행렬은 처음에 사용되는 skeleton 에서 해당 Joint::index 의 글로벌 트랜스폼의 역을 의미합니다.

Joint::index도 참조하세요 .

이 속성은 자동 레벨 오브 디테일 메시가 사용되기 전에 렌더링할 때 모델의 크기를 변경합니다. 생성된 각 레벨 오브 디테일 메시에는 각 레벨이 표시되어야 하는 이상적인 크기 값이 포함되어 있으며, 이는 렌더링된 씬에서 해당 메시가 차지하는 비율입니다. 화면에서 몇 픽셀만 표현하는 모델에는 전체 지오메트리가 올바르게 보이지 않으므로 이 경우 더 낮은 레벨 오브 디테일 메시가 대신 사용됩니다. 이 값은 이상적인 값에 대한 편향된 값으로, 1.0 보다 작은 값은 더 낮은 세부 수준으로 전환하기 전에 렌더링 크기를 더 작게 해야 합니다. 1.0 이상의 값은 더 낮은 세부 수준이 더 빨리 사용되도록 합니다. 0.0 값은 세부 수준 사용을 완전히 비활성화합니다.

기본값은 다음과 같습니다. 1.0

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

Camera::levelOfDetailBias 를참조하십시오 .

이 모델의 라이트맵의 대략적인 크기를 정의합니다. 기본값은 1024로, 1024x1024를 기본 크기로 나타냅니다. 라이트맵 텍스처의 실제 크기는 메쉬에 따라 다를 수 있으며, 종종 더 클 수 있습니다.

더 단순하고 작은 메시의 경우 또는 더 큰 라이트맵을 사용할 필요가 없다고 판단되는 경우 512 또는 256과 같이 더 작은 값으로 설정할 수 있습니다.

최소값은 128입니다.

이 설정은 영구적으로 저장된 라이트맵과 중간 부분 라이트맵 모두에 적용됩니다. 라이트맵을 베이킹할 때 usedInBakedLighting 을 활성화한 모든 모델은 경로 추적 장면의 일부가 됩니다. 따라서 모든 모델은 라이트맵 UV 언래핑을 수행하고 직접 조명을 계산하는 데 필요한 래스터화 단계를 수행한 다음 씬의 간접광 반사를 고려할 수 있어야 합니다. 그러나 라이트맵에 기여만 하고 저장하지 않는 모델의 경우 기본값으로 충분한 경우가 많습니다. 미세 조정은 생성된 라이트맵을 저장한 다음 사용하는 모델에 더 적합합니다.

이 속성은 라이트맵을 베이킹할 때만 관련이 있습니다. 이후 렌더링 중에 생성된 라이트맵을 사용할 때는 아무런 영향을 미치지 않습니다.

에셋 임포트 시(예: 발삼 툴을 통해) 미리 생성된 라이트맵 UV 데이터가 있는 모델은 라이트맵 UV 언래핑 및 라이트맵 크기 힌트 평가가 이미 수행되었으므로 이 프로퍼티를 무시하고 라이트맵 베이킹 중에 다시 수행하지 않습니다.

이 프로퍼티에는 제공된 지오메트리를 렌더링하는 데 사용되는 머티리얼 목록이 포함되어 있습니다. 무엇이든 렌더링하려면 머티리얼이 하나 이상 있어야 합니다. 일반적으로 소스 지오메트리에 포함된 각 서브 메시마다 하나의 머티리얼이 있어야 합니다.

Qt Quick 3D - 서브 메시 예시를참조하십시오 .

이 속성에는 제공된 지오메트리를 렌더링하는 데 사용되는 MorphTarget의 목록이 포함되어 있습니다. 메시에는 모프 타깃의 위치, 노멀, 탄젠트, 바이노멀, 텍스처 좌표, 버텍스 컬러 중 하나 이상의 속성이 있어야 합니다.

MorphTarget 를참조하세요 .

이 속성은 모델을 선택할 수 있는지 여부를 제어합니다. 모델을 선택할 수 있게 하려면 이 속성을 true 로 설정합니다. 모델은 기본적으로 선택할 수 없습니다.

View3D::pick도 참조하세요 .

이 속성을 true 으로 설정하면 모델의 머티리얼이 반사 프로브에서 반사 기여도를 가져옵니다. 모델이 동시에 두 개 이상의 반사 프로브 안에 있는 경우 가장 가까운 반사 프로브가 고려됩니다.

이 프로퍼티를 true 으로 설정하면 모델의 머티리얼은 그림자를 드리우는 조명의 그림자 기여도를 고려합니다.

기본값은 true 입니다.

모델의 스켈레톤을 포함합니다. 스켈레톤은 스키닝을 위해 inverseBindPoses 와 함께 사용됩니다.

Model::inverseBindPoses 및 Qt Quick 3D - 간단한 스키닝 예시도참조하세요 .

모델의 스켈레톤을 포함합니다. 스켈레톤은 스키닝에 사용됩니다.

또한 참조 Qt Quick 3D - Simple Skinning Example.

이 속성은 이 모델의 지오메트리가 포함된 메시 파일 또는 Mesh format and built-in primitives 에 설명된 대로 아래에 나열된 기본 제공 프리미티브 메시 중 하나의 위치를 정의합니다.

• "#Rectangle"
• "#Sphere"
• "#Cube"
• "#Cone"
• "#Cylinder"

이 속성을 true 으로 설정하면 모델은 그림자나 간접광을 드리우는 등의 형태로 라이트맵과 같은 베이크된 조명에 기여합니다. 이 설정은 모델의 라이트맵 생성 제어와는 독립적이며, 이를 위해서는 bakedLightmap 을 사용합니다.

기본값은 false 입니다.

라이트맵을 베이크하는 방법에 대한 자세한 내용은 Lightmapper 문서를 참조하세요.

이 속성은 라이트맵을 베이크할 때만 관련이 있습니다. 이후 렌더링 중에 생성된 라이트맵을 사용할 때는 아무런 영향을 미치지 않습니다.

Light::bakeMode, bakedLightmap, Lightmapper 및 라이트맵과 전역 조명을참조하세요 .