Texture QML Type

3D 장면에서 사용할 텍스처를 정의합니다. 더 보기...

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

속성

• autoOrientation : bool (since 6.2)
• flipU : bool
• flipV : bool
• generateMipmaps : bool
• indexUV : int
• magFilter : enumeration
• mappingMode : enumeration
• minFilter : enumeration
• mipFilter : enumeration
• pivotU : real
• pivotV : real
• positionU : real
• positionV : real
• rotationUV : real
• scaleU : real
• scaleV : real
• source : url
• sourceItem : Item
• textureData : TextureData
• textureProvider : RenderExtension (since 6.7)
• tilingModeDepth : enumeration
• tilingModeHorizontal : enumeration
• tilingModeVertical : enumeration

상세 설명

텍스처는 기술적으로 픽셀 배열(1D, 2D 또는 3D)과 이를 축소 및 확대 필터, 스케일링, UV 변환과 같은 관련 설정을 모두 포함하는 것을 말합니다.

Qt Quick 3D 의 Texture 타입은 2차원 이미지를 나타냅니다. 이 타입은 일반적으로 3차원 지오메트리에 매핑하거나 감싸서, 3D로 효율적으로 모델링할 수 없는 추가적인 디테일을 재현하는 데 사용됩니다. 또한 반사 같은 다른 조명 효과를 재현하는 데에도 사용할 수 있습니다.

Texture 자체는 항상 2D 텍스처를 나타내지만, Texture의 하위 클래스를 통해 다른 종류의 텍스처도 사용할 수 있습니다. 예를 들어, 6개의 면을 가진 큐브 맵 텍스처를 만들려면 CubeMapTexture 유형을 사용합니다.

지오메트리가 렌더링될 때, 메쉬의 정점에 설정된 UV 좌표(텍스처 좌표)를 변환하고 보간하여 표면의 각 위치를 텍스처 내의 해당 위치로 매핑합니다. 활성 머티리얼을 렌더링하는 데 사용되는 프래그먼트 셰이더 프로그램은 일반적으로 주어진 좌표에서 머티리얼의 텍스처를 샘플링하고, 샘플링된 데이터를 조명 계산에 사용합니다.

텍스처 오브젝트는 다음에서 이미지 데이터를 가져올 수 있습니다:

• source 속성을 사용하여 이미지 또는 텍스처 파일,
• sourceItem 속성을 사용하여 Qt Quick Item ,
• 또는 사용자 정의 텍스처 내용을 정의하기 위해 ` textureData ` 속성을 ` TextureData ` 항목의 하위 클래스로 설정하는 방법.

다음 예제는 "madewithqt.png" 이미지를 기본 구 메시에 매핑하고, 구 표면에 이미지가 타일링되도록 UV 좌표를 조정합니다.

Model {
    source: "#Sphere"
    materials: [ PrincipledMaterial {
            baseColorMap: Texture {
                source: "madewithqt.png"
                scaleU: 4.0
                scaleV: 4.0
            }
        }
    ]
}

결과는 다음과 같습니다:

참조: Qt Quick 3D - 절차적 텍스처 예제.

속성 설명서

autoOrientation : bool [since 6.2]

이 속성은 V 텍스처 좌표 반전과 같은 텍스처 변환이 일반적으로 적용되는 텍스처에 대해 해당 변환이 자동으로 적용될지 여부를 결정합니다.

기본적으로 이 속성은 true로 설정되어 있습니다.

source 속성을 통해 .ktx 또는 .pkm 파일에서 로드된 압축 텍스처나, sourceItem 속성을 통해 Qt Quick 장면을 렌더링하여 생성된 텍스처와 같은 특정 유형의 텍스처 데이터는, .png 또는 .jpg와 같은 이미지 파일에서 로드된 텍스처와 비교했을 때 Y축 방향이 다른 경우가 많습니다. 따라서 이러한 텍스처는 소스가 일반 이미지 파일로 설정된 텍스처와 비교했을 때 “거꾸로” 표시됩니다. 이를 해결하기 위해, 해당 조건에 해당하는 모든 텍스처에는 flipV 속성이 true로 설정된 것처럼 암시적인 UV 변환이 적용됩니다. 이를 원하지 않는 경우, 이 속성을 false로 설정하십시오.

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

flipV도 참조하십시오 .

flipU : bool

이 속성은 수평으로 반전된 텍스처 좌표의 사용 여부를 설정합니다.

기본값은 false입니다.

flipV도 참조하십시오 .

flipV : bool

이 속성은 수직으로 반전된 텍스처 좌표의 사용 여부를 설정합니다.

기본값은 false입니다.

flipU도 참조하십시오 .

generateMipmaps : bool

이 속성은 미프맵 레벨을 직접 제공하지 않는 텍스처에 대해 미프맵을 생성할지 여부를 결정합니다. 미프맵과 미프 필터링을 함께 사용하면, 이를 사용하지 않을 때보다 멀리서 텍스처를 볼 때 더 나은 시각적 품질을 얻을 수 있지만, 성능 저하(이미지 초기화 시와 렌더링 중 모두)가 발생할 수 있습니다.

기본적으로 이 속성은 false로 설정되어 있습니다.

mipFilter도 참조하십시오 .

indexUV : int

이 속성은 이 텍스처에서 사용하는 UV 좌표 인덱스를 설정합니다. 현재 QtQuick3D 에서는 2개의 UV 세트(0 또는 1)만 지원하므로, 값은 해당 범위로 제한됩니다.

기본값은 0입니다.

magFilter : enumeration

이 속성은 텍스처가 “확대”될 때, 즉 텍셀이 화면 공간에서 하나 이상의 픽셀을 덮을 때 텍스처가 어떻게 샘플링될지를 결정합니다.

기본값은 ` Texture.Linear`입니다.

minFilter 및 mipFilter도 참조하십시오 .

mappingMode : enumeration

이 속성은 이 텍스처를 샘플링할 때 사용할 매핑 방법을 정의합니다.

minFilter : enumeration

이 속성은 텍스처가 “최소화”되었을 때, 즉 텍셀이 화면 공간에서 1픽셀 미만을 차지할 때 텍스처가 어떻게 샘플링될지를 결정합니다.

기본값은 ` Texture.Linear`입니다.

magFilter 및 mipFilter도 참조하십시오 .

mipFilter : enumeration

이 속성은 텍셀이 1픽셀 미만을 차지할 때 텍스처 밉맵이 어떻게 샘플링될지를 결정합니다.

기본값은 Texture.None 입니다.

minFilter 및 magFilter도 참조하십시오 .

pivotU : real

이 속성은 rotationUV 을 적용할 때 사용되는 피벗 U 위치를 설정합니다.

기본값은 0.0입니다.

rotationUV도 참조하십시오 .

pivotV : real

이 속성은 ‘ rotationUV ’을 적용할 때 사용되는 피벗 V 위치를 설정합니다.

기본값은 0.0입니다.

pivotU 및 rotationUV도 참조하십시오 .

positionU : real

이 속성은 U 좌표 매핑을 왼쪽에서 오른쪽으로 오프셋합니다.

기본값은 0.0입니다.

positionV도 참조하십시오 .

positionV : real

이 속성은 V 좌표 매핑을 아래쪽에서 위쪽으로 오프셋합니다.

기본값은 0.0입니다.

positionU도 참조하십시오 .

rotationUV : real

이 속성은 피벗 지점을 중심으로 텍스처를 회전시킵니다. 이는 오일러 각을 사용하여 정의되며, 양수 값일 경우 시계 방향으로 회전합니다.

기본값은 0.0입니다.

pivotU 및 pivotV도 참조하십시오 .

scaleU : real

이 속성은 메시의 UV 좌표에 매핑할 때 U 텍스처 좌표를 어떻게 확대/축소할지 정의합니다.

수평 타일링을 사용할 때 U 값을 스케일링하면 텍스처가 왼쪽에서 오른쪽으로 몇 번 반복되는지가 결정됩니다.

기본값은 1.0입니다.

tilingModeHorizontal도 참조하십시오 .

scaleV : real

이 속성은 메쉬의 UV 좌표에 매핑할 때 V 텍스처 좌표를 어떻게 확대/축소할지 정의합니다.

수직 타일링을 사용할 때 V 값을 확대/축소하면 텍스처가 아래에서 위로 몇 번 반복되는지가 결정됩니다.

기본값은 1.0입니다.

tilingModeVertical도 참조하십시오 .

source : url

이 속성은 텍스처에서 사용하는 데이터가 포함된 이미지 또는 텍스처 파일의 위치를 나타냅니다.

이 속성은 URL이며, Image.source 와 같이 다른 소스 속성과 동일한 규칙을 따릅니다. Texture의 경우 qrc 및 file 스키마만 지원됩니다. 스키마가 없고 값이 상대 경로인 경우, 해당 경로는 컴포넌트(즉, .qml 파일)의 위치를 기준으로 한 상대 경로로 간주됩니다.

소스 파일은 일반적인 이미지 파일 형식 supported by Qt 이면 무엇이든 사용할 수 있습니다. 또한 Texture는 QtQuick::Image와 동일한 compressed texture file types 을 지원합니다.

sourceItem, textureData, autoOrientation 및 flipV도 참조하십시오 .

sourceItem : Item

이 속성은 텍스처의 소스로 사용될 아이템을 정의합니다. 이 속성을 사용하면 해당 아이템을 오프스크린 레이어로 렌더링함으로써, 모든 2D Qt Quick 콘텐츠를 텍스처 소스로 활용할 수 있습니다.

해당 아이템이 ` texture provider`인 경우, 별도의 텍스처는 사용되지 않습니다.

이 속성이 설정된 경우, ` source `의 값은 무시됩니다. 텍스처는 하나의 메서드를 사용하여 이미지 데이터를 제공해야 하며, `source`, `sourceItem` 또는 ` textureData` 중 하나만 설정해야 합니다.

관련 문서: source, textureData, autoOrientation.

textureData : TextureData

이 속성은 원시 텍스처 데이터의 내용과 속성을 정의하는 ‘ TextureData ’ 컴포넌트에 대한 참조를 보유합니다.

이 속성이 사용될 경우, ` source `의 값은 무시됩니다. `Texture`는 이미지 데이터를 제공하기 위해 하나의 메서드만 사용해야 하며, `source`, ` sourceItem` 또는 `textureData` 중 하나만 설정해야 합니다.

source, sourceItem 및 Qt Quick 3D - 절차적 텍스처 예제도참조하십시오 .

textureProvider : RenderExtension [since 6.7]

이 속성은 이 아이템에서 사용될 QRhiTexture 를 제공하는 RenderExtension 를 포함합니다.

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

TextureProviderExtension, RenderExtension 및 QSSGRenderExtensionHelpers도 참조하십시오 .

tilingModeDepth : enumeration

이 속성은 Z 스케일링 값이 1보다 클 때 텍스처가 매핑되는 방식을 제어합니다.

기본적으로 이 속성은 ` Texture.Repeat`로 설정되어 있습니다.

tilingModeHorizontal : enumeration

U 스케일링 값이 1보다 클 때 텍스처가 매핑되는 방식을 제어합니다.

기본적으로 이 속성은 ' Texture.Repeat'로 설정되어 있습니다.

scaleU도 참조하십시오 .

tilingModeVertical : enumeration

이 속성은 V 스케일링 값이 1보다 클 때 텍스처가 매핑되는 방식을 제어합니다.

기본적으로 이 속성은 ' Texture.Repeat'으로 설정되어 있습니다.

scaleV도 참조하십시오 .