usd exchange samples
OpenUSD
이 샘플은 OpenUSD 변환기 작성에 대한 몇 가지 주요 개념을 보여줍니다. 샘플에서는 OpenUSD 및 OpenUSD Exchange SDK(문서, github)를 사용하여 일관되고 올바른 USD를 작성하는 방법을 보여줍니다.
Asset Validator
createStage
createCameras
createLights
createMaterials
createMesh
createReferences
createSkeleton
createTransforms
setDisplayNames
이 프로젝트에는 "make"와 "g++"가 필요합니다.
터미널을 엽니다.
"make"를 얻으려면 sudo apt install make (Ubuntu/Debian) 또는 yum install make (CentOS/RHEL)를 입력하세요.
"g++"의 경우 sudo apt install g++ (Ubuntu/Debian) 또는 yum install gcc-c++ (CentOS/RHEL)를 입력하세요.
제공된 빌드 스크립트를 사용하여 다른 모든 종속성(예: USD)을 다운로드하고 Makefile을 생성하고 코드를 컴파일하십시오.
./repo.sh 빌드
run.sh 스크립트(예: ./run.sh createStage )를 사용하여 사전 구성된 환경에서 각 프로그램을 실행합니다.
팁: 환경을 직접 관리하려면
<samplesRoot>/_build/linux64-x86_64/releaseLD_LIBRARY_PATH에 추가하세요.
명령줄 인수 도움말을 보려면 --help 사용하세요.
./run.sh createStage --help
python.sh 스크립트(예: ./python.sh source/createStage/createStage.py )를 사용하여 사전 구성된 환경에서 각 프로그램을 실행합니다.
명령줄 인수 도움말을 보려면 --help 사용하세요.
./python.sh 소스/createStage/createStage.py --help
이 프로젝트에는 Microsoft Visual Studio 2019 이상이 필요합니다. C++로 Visual Studio를 다운로드하고 설치하세요.
제공된 빌드 스크립트를 사용하여 모든 종속성(예: USD)을 다운로드하고, 프로젝트를 생성하고, 코드를 컴파일합니다.
.repo.bat 빌드
run.bat 스크립트(예 .run.bat createStage )를 사용하여 사전 구성된 환경에서 각 프로그램을 실행합니다.
명령줄 인수 도움말을 보려면 --help 사용하세요.
.run.bat createStage --help
python.bat 스크립트(예 .python.bat sourcecreateStagecreateStage.py )를 사용하여 사전 구성된 환경에서 각 프로그램을 실행합니다.
명령줄 인수 도움말을 보려면 --help 사용하세요.
.python.bat 소스createStagecreateStage.py --help
VS IDE 내에서 빌드하려면 Visual Studio의 _compiler 폴더에 있는 솔루션을 엽니다. 그런 다음 샘플 C++ 코드를 거기에서 조정, 디버깅, 재구축하는 등의 작업을 수행할 수 있습니다.
참고: 사용자가 OpenUSD Exchange 샘플을
%LOCALAPPDATA%폴더에 설치하는 경우 소스 변경 사항을 선택하는 데 문제가 있기 때문에 Visual Studio는 변경 시 제대로 "빌드"되지 않습니다. 문제를 해결하려면 다음 중 하나를 수행하십시오.
Build아닌 모든 소스 변경으로 프로젝트를RebuildOpenUSD Exchange Samples 폴더를
%LOCALAPPDATA%외부의 다른 폴더에 복사하세요.%LOCALAPPDATA% 외부 폴더에 대한 연결을 만들고 거기에서 솔루션을 엽니다.
mklink /JC:usd-exchange-samples %LOCALAPPDATA%cloned-reposusd-exchange-samples
샘플 저장소는 Repo 도구 프레임워크( repo_man )를 사용하여 premake, packman, 빌드 및 런타임 종속성, 테스트, 형식 지정 및 기타 도구를 구성합니다. Packman은 OpenUSD, Omniverse Asset Validator, OpenUSD Exchange SDK 및 기타 항목과 같은 패키지의 종속성 관리자로 사용됩니다. 샘플은 OpenUSD, OpenUSD Exchange SDK 및 기타 종속성을 포함하고 연결하기 위한 템플릿으로 OpenUSD Exchange SDK의 repo_man, premake 및 packman 도구를 사용합니다. 이는 고객의 애플리케이션에 필요할 수 있는 빌드 및 런타임 구성의 예 역할을 할 수 있습니다. 흥미로운 파일 목록은 다음과 같습니다.
premake5.lua - 샘플의 빌드 구성 파일
prebuild.toml - 런타임 종속성을 복사해야 하는 위치를 지정하기 위해 repo 빌드 도구에서 사용됩니다( repo install_usdex 이미 설치한 것 이상).
_build/target-deps/usd-exchange/release/dev/tools/premake/usdex_build.lua - USD, OpenUSD Exchange SDK 자체 및 기타 라이브러리를 포함하기 위한 OpenUSD Exchange SDK의 사전 제작 빌드 구성 템플릿 파일입니다.
이 파일은 종속성을 가져올 때까지 사용할 수 없습니다.
OpenUSD Exchange SDK 빌드 버전, 기능 또는 버전 선택 및 설치에 대한 자세한 내용은 install_usdex 도구 설명서를 참조하세요.
애플리케이션에서 OpenUSD Exchange SDK 및 OpenUSD를 사용하는 방법에 대한 연습은 OpenUSD Exchange SDK 시작하기 문서를 참조하세요.
나열된 샘플은 다음과 같은 주요 개념에 중점을 두고 있습니다.
USD 열기
USD 카메라
USD 표시 이름
USD 조명
USD 자료
USD 메시
USD 프라임 이름
USD 프림바르
USD 단계
USD 변환
샘플은 순차적으로 실행되도록 고안되었으며 원래 createStage 샘플에서 생성된 USD 단계를 구축합니다. 또한 독립적으로 실행될 수도 있으며 존재 여부에 따라 스테이지를 열거나 생성합니다. 하나의 명령으로 모든 샘플을 순차적으로 실행하려면 빌드 후 명령줄에 다음을 입력합니다.
Linux: ./repo.sh test -f testRunAll -e keep Windows: .repo.bat test -f testRunAll -e keep
그러면 모든 샘플이 순차적으로 실행된 후 C++ 및 Python 생성 단계의 위치가 출력됩니다.
자체 서명된 인증서 문제로 인해 샘플의 스크립트가 실패하는 경우 가능한 해결 방법은 다음과 같습니다.
TLS/SSL 요청에 Windows 인증서 저장소를 사용할 수 있도록 python-certifi-win32를 설치합니다.
toolspackmanpython.bat -m pip install python-certifi-win32 --trusted-host pypi.org --trusted-host files.pythonhosted.org
먼저 기존 GitHub 문제 및 OpenUSD Exchange SDK 토론을 검색하여 비슷한 내용을 보고한 사람이 있는지 확인하세요.
그렇지 않은 경우 버그나 기능 요청을 설명하는 새 GitHub 문제 또는 포럼 주제를 만드세요.
버그의 경우 필요에 따라 오류 데이터 예시를 포함하여 문제를 재현하기 위한 명확한 단계를 제공하세요.
기능의 경우 사용자 스토리와 페르소나 세부정보(예: 이 기능이 누구에게 도움이 되고 어떻게 도움이 되는지)를 제공해 주세요.
기존 문제에 세부 정보를 추가하거나 새 문제를 생성하는 경우 어떤 회사가 영향을 받는지 알려 주시기 바랍니다.
샘플 라이센스는 LICENSE.md에 있습니다.
샘플에서 사용되는 종속성에 대한 타사 라이선스 고지 사항은 OpenUSD Exchange SDK 라이선스 고지 사항에 있습니다.
OpenUSD Docs - 첫 번째 USD 단계 만들기
OpenUSD API 문서
OpenUSD 사용자 문서
NVIDIA OpenUSD 리소스 및 학습
OpenUSD 코드 샘플
NVIDIA OpenUSD 문서
NVIDIA OpenUSD 교환 SDK 문서
