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 접미사를 가져야 합니다. 이 파일들은 빌드 시 Balsam Asset Import Tool을 사용하여 .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 는 최종 타깃에 링크된 모든 리소스에서 고유해야 합니다.

이는 특히 정적 빌드에 영향을 미칩니다. 정적 빌드의 경우, 서로 다른 정적 라이브러리에서 동일한 리소스 이름을 사용하면 이를 사용하는 타깃에서 충돌이 발생합니다.