Qt Quick 3D Physics 쿠킹
메시를 충돌 형상으로 사용할 때는 효율적인 충돌 감지를 위해 해당 메시를 처리하여 특정 데이터 형식으로 변환해야 합니다. 이를 '쿠킹(cooking)'이라고 합니다. 사용 전에 쿠킹 처리가 필요한 형상 유형은 총 세 가지로, 각각 ConvexMeshShape, TriangleMeshShape 및 HeightFieldShape 입니다. 이러한 형상 중 하나를 사용할 경우, 시뮬레이션의 첫 번째 프레임에서 쿠킹이 자동으로 수행됩니다. 이 쿠킹 과정은 상당한 성능 저하를 초래할 수 있으므로, 로딩 시간을 단축하기 위해 메시를 미리 쿠킹하여 직접 불러올 수 있습니다. 이를 수행하는 방법으로는 캐시 디렉터리를 사용하거나 쿠커 도구를 사용하는 두 가지가 있습니다.
캐시 디렉터리
캐시 디렉터리를 사용하려면 QT_PHYSICS_CACHE_PATH 환경 변수를 원하는 디렉터리로 설정하십시오. 애플리케이션을 처음 실행할 때 사용된 모든 메시가 쿠킹되어 이 디렉터리에 저장됩니다. 이후 애플리케이션을 실행할 때는 메시를 새로 쿠킹하지 않고 디스크에서 미리 쿠킹된 메시를 읽어옵니다.
경고: 캐시디렉터리의 파일은 로드되기 전에 유효성 검증을 거치지 않습니다. 형식이 잘못되었거나 신뢰할 수 없는 캐시 파일을 로드하면 보안상의 문제가 발생할 수 있습니다. 애플리케이션 개발자는 QT_PHYSICS_CACHE_PATH 환경 변수를 다른 사용자나 프로세스가 쓰기 권한을 가진 디렉터리로 지정하기 전에 이러한 점을 신중하게 고려해야 합니다.
Cooker 도구
다른 방법으로는 cooker 도구를 사용하는 것입니다. 도구를 빌드한 후, 메쉬나 높이 필드 이미지를 입력 인수로 지정하여 도구를 호출하기만 하면 됩니다:
cooker input.mesh또는
cooker input.png입력이 메쉬인 경우 두 개의 파일이 생성됩니다:
input.cooked.triinput.cooked.cvx
하나는 쿠킹 처리된 삼각형 메쉬이고, 다른 하나는 쿠킹 처리된 볼록 메쉬입니다. 이 파일들은 TriangleMeshShape::source 및 ConvexMeshShape::source 의 소스로 간단히 사용할 수 있으며, 메쉬는 별도의 쿠킹 과정 없이 바로 로드됩니다. 마찬가지로, 입력이 이미지 파일인 경우 input.cooked.hf 라는 높이 필드가 생성되며, 이 파일은 HeightFieldShape::source 속성에서 참조하여 로드할 수 있습니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.