qt_add_lightprobe_images

HDRI 맵 파일을 KTX 파일로 베이크하여 Qt 리소스로 추가합니다.

이 명령은 Qt6 패키지의 Quick3D 컴포넌트에 정의되어 있으며, 다음과 같이 로드할 수 있습니다:

find_package(Qt6 REQUIRED COMPONENTS Quick3D)

이 명령은 Qt 6.2에 도입되었습니다.

개요

qt_add_lightprobe_images(target resource_name
                    [PREFIX prefix]
                    [BASE base]
                    FILES file1.hdr, file2.hdr ..
                    [OUTPUTS file1.ktx, file2.ktx ..]
)

버전 없는 명령을 사용할 수 없는 경우 qt6_add_lightprobe_images() 을 대신 사용합니다. 이 명령은 이 명령과 동일한 인수 집합을 지원합니다.

설명

이 명령을 사용하여 FILES 아래에 나열된 .hdr 파일을 .ktx 파일로 베이크합니다. 파일은 바이너리 또는 라이브러리 target 에 포함됩니다.

FILES 로컬 HDRI 맵 파일의 경로를 나열해야 합니다. 각 파일에는 접미사 .hdr 또는 .exr 이 있어야 합니다. 이러한 파일은 빌드 시 발삼 에셋 임포트 툴을 사용하여 .ktx 파일로 변환됩니다.

기본적으로 .ktx 파일은 동일한 기본 이름과 상대 경로로 대상 바이너리의 임베디드 Qt 리소스에 표시됩니다. 런타임에 상대 경로에서 공통 디렉터리를 제거하려면 BASE 을 사용합니다. 즉, FILES 아래의 모든 파일 경로가 공통 디렉터리 maps/ 을 가리키는 경우 BASE maps/ 을 사용하여 Qt 리소스 시스템에서 해당 디렉터리를 숨길 수 있습니다. 비슷한 맥락에서 PREFIX 을 사용하여 Qt 리소스 시스템에 공통 접두사 디렉터리를 추가할 수 있습니다.

BASE 및 PREFIX 을 사용하면 Qt 리소스 시스템에서 .ktx 파일의 공통 상대 경로를 변경할 수 있지만, OUTPUTS 을 사용하면 파일 이름을 포함한 .ktx 파일의 전체 경로를 제어할 수 있습니다. OUTPUTS 을 사용하는 경우 경로의 수는 FILES 으로의 경로 수와 일치해야 합니다.

예제

다음은 빌드 시점에 라이트프로브 맵을 자동 생성하여 :/maps/OpenfootageNET_garage-1024.ktx 아래에 있는 실행 파일에 포함합니다:

qt_add_lightprobe_images(principledmaterial "ibl_assets"
    PREFIX
         "/"
    FILES
        "maps/OpenfootageNET_garage-1024.hdr"
)

주의

여러 리소스를 추가하는 경우 resource_name 은 최종 타겟에 연결된 모든 리소스에서 고유해야 합니다.

이는 특히 정적 빌드에 영향을 줍니다. 다른 정적 라이브러리에 있는 동일한 리소스 이름이 소비 대상에서 충돌할 수 있습니다.