프로젝트 소개

## 개요 이 저장소는 OpenGL, Vulkan 및 기타 GPU API에서 사용되는 경량 텍스처 컨테이너 형식인 KTX(Khronos Texture)의 공식 Khronos 저장소입니다. KTX 파일은 텍스처 로딩에 필요한 모든 매개변수를 저장하며, 단일 파일에 단순한 기본 레벨 2D 텍스처부터 밉맵이 있는 큐브맵 배열 텍스처까지 담을 수 있습니다. ## 소프트웨어 구성 - **libktx** — KTX 파일을 읽고 쓰며, 이를 통해 OpenGL, OpenGL ES 및 Vulkan 텍스처를 생성하기 위한 소형 C 라이브러리입니다. - **libktx.js / libktx.wasm** — JavaScript 래퍼가 포함된 libktx의 WebAssembly 빌드입니다. - **msc_basis_transcoder.js / .wasm** — JavaScript로 작성된 KTX 파서를 위해 설계된 Basis Universal 형식용 WebAssembly 트랜스코더와 JavaScript 래퍼입니다. - **libktx.jar 및 libktx-jni** — Java 래퍼 및 네이티브 인터페이스 라이브러리입니다. - **pyktx** — Python 래퍼입니다. - **ktx** — KTX2 파일 관리를 위한 범용 명령줄 도구로, compare, convert, create, deflate, extract, encode, transcode, info, validate 및 help 하위 명령을 제공합니다. ## 텍스처 형식 포함된 텍스처는 Basis Universal 형식, OpenGL 계열 및 Vulkan API와 확장에서 지원하는 블록 압축 형식, 또는 비압축 단일 평면 형식일 수 있습니다. Basis Universal은 현재 LZ/ETC1S(블록 압축 및 슈퍼압축)와 UASTC(블록 압축 형식)를 지원합니다. LZ/ETC1S 이외의 형식은 Zstd 및 ZLIB로 슈퍼압축할 수 있습니다. ## 배포 및 문서 도구, 라이브러리 및 개발 헤더의 바이너리 패키지는 프로젝트의 Releases 페이지에 게시되며, JavaScript 래퍼와 .wasm 바이너리를 포함한 패키지도 함께 제공됩니다. API 및 도구 사용법을 다루는 Doxygen 생성 문서는 온라인에서 확인할 수 있습니다. 데스크톱 릴리스 설치 프로그램에는 여러 구성 요소가 포함되어 있으며, 기본적으로 ktx 도구와 런타임 libktx만 설치되고 Development 헤더 및 Java Wrapper와 같은 다른 구성 요소는 설치 프로그램의 Customize 옵션을 통해 선택할 수 있습니다. ## 저장소 참고 사항 클론 후 저장소를 완전히 체크아웃하려면 Git LFS(버전 1.1 이상)가 설치되어 있어야 합니다. 최초 체크아웃 시 Git LFS가 없었다면 이후 `git lfs checkout`을 실행하십시오. ktx 명령줄 도구의 적합성 테스트는 별도의 KTX-Software-CTS 저장소에 있으며, 이는 git 서브모듈로 포함되어 있지만 라이브러리나 도구를 빌드하는 데 기본적으로 필요하지는 않습니다. 일부 파일은 Unix 계열 셸 및 Windows PowerShell용 install-gitconfig 스크립트와 smudge_date 스크립트를 통해 구성된 smudge/clean 필터를 사용하여 `$Date$` 키워드 확장을 사용합니다. 도우미 스크립트로는 빌드 디렉터리, .git, external 및 tests/cts를 건너뛰면서 소스를 검색하는 `scripts/gk`와 KTX2 파일에 대한 git diff 드라이버로 `ktx compare`를 사용할 수 있게 하는 래퍼인 `scripts/ktx-compare-git`이 있습니다. 지원은 GitHub Discussions를 통해 처리되며, 문제는 GitHub 이슈를 통해 보고됩니다. 기여, 라이선스 및 빌드 정보는 CONTRIBUTING, LICENSE 및 BUILDING 파일에 문서화되어 있습니다.