AbrirUSD

Descrição da cena universal

A Descrição Universal de Cena (USD) é um sistema eficiente e escalonável para criação, leitura e streaming de descrição de cena com amostragem de tempo para intercâmbio entre aplicativos gráficos.

Para mais detalhes, visite o site aqui.

Status de construção

	Linux	Windows	macOS
desenvolvedor
liberar

Documentação Adicional

• Documentação do usuário e tutoriais
• Documentação da API
• Configuração de compilação avançada

Obtendo ajuda

Precisa de ajuda para entender certos conceitos em dólares americanos? Consulte Obtendo ajuda com USD ou visite nosso fórum.

Se você estiver enfrentando problemas não documentados com o software, registre um bug. Se você precisar relatar um problema de segurança com o software, revise a Política de Segurança.

Plataformas suportadas

USD é desenvolvido principalmente em plataformas Linux (CentOS 7), mas é construído, testado e compatível com macOS e Windows.

Também é possível construir bibliotecas USD que podem ser incorporadas em aplicativos iOS e visionOS.

Consulte VERSIONS.md para versões testadas explicitamente.

Dependências

Obrigatório:

• Compilador C/C++
• CMake
• Intel a ser definida

Consulte Biblioteca de terceiros e versões de aplicativos para obter informações sobre versão.

Dependências adicionais são necessárias para os componentes a seguir. Esses componentes podem ser desabilitados em tempo de construção. Para obter mais detalhes, consulte Configuração avançada de compilação.

Imagens e imagens em dólares americanos

Obrigatório:

• OpenSubdiv

Opcional:

• OpenEXR
• OpenImageIO
• OpenColorIO
• OSL (OpenShadingLanguage)
• Ptex

Ligações Python

Obrigatório:

• Pitão

USDview

Obrigatório:

• Ligações Python
• PySide6 ou PySide2
• PyOpenGL

Obtendo e construindo o código

A maneira mais simples de construir USD é executar o script build_usd.py fornecido. Este script baixará as dependências necessárias e as construirá e instalará junto com o USD em um determinado diretório.

Siga as instruções abaixo para executar o script com seu comportamento padrão, que criará as bibliotecas principais do USD, o Imaging e os componentes do USD Imaging. Para obter mais opções e documentação, execute o script com o parâmetro --help .

Consulte Configuração de compilação avançada para obter exemplos e documentação adicional para executar o cmake diretamente.

1. Pré-requisitos de instalação (consulte Dependências para versões necessárias)

• Obrigatório:
  • Compilador C++:
    • gcc
    • Código X
    • MicrosoftVisual Studio
  • CMake
• Opcional (pode ser ignorado passando --no-python como argumento para build_usd.py )
  • Python (necessário para ligações e testes)
  • PyOpenGL (obrigatório para usdview)
  • PySide6 ou PySide2 (obrigatório para usdview)

2. Baixe o código-fonte em USD

Você pode baixar arquivos de código-fonte do GitHub ou usar git para clonar o repositório.

 > git clone https://github.com/PixarAnimationStudios/OpenUSD
Cloning into 'OpenUSD'...

3. Execute o script

Execute o script build_usd.py para compilar e instalar o USD. Observe que o script de construção é estruturado com uma compilação fora do código-fonte em mente - instalando uma compilação no
diretório onde o repositório foi clonado não foi testado.

Linux:

Por exemplo, o seguinte irá baixar, construir e instalar as dependências do USD e, em seguida, construir e instalar o USD em /path/to/my_usd_install_dir .

 > python OpenUSD/build_scripts/build_usd.py /path/to/my_usd_install_dir

macOS:

Em um terminal, execute xcode-select para garantir que as ferramentas de desenvolvedor de linha de comando estejam instaladas. Em seguida, execute o script.

Por exemplo, o seguinte irá baixar, construir e instalar as dependências do USD e, em seguida, construir e instalar o USD em /path/to/my_usd_install_dir .

 > python OpenUSD/build_scripts/build_usd.py /path/to/my_usd_install_dir

iOS e visionOS:

Ao compilar a partir de um sistema macOS, você pode fazer compilação cruzada para plataformas baseadas em iOS.

As compilações de compilação cruzada são restritas à construção de bibliotecas que podem ser incorporadas em aplicativos criados para a plataforma de destino. Pode ser útil usar uma compilação monolítica ao incorporar o USD (consulte Configuração avançada de compilação).

Essas compilações não oferecem suporte a ligações Python ou ferramentas de linha de comando.

Por exemplo, o seguinte irá baixar, construir e instalar as dependências do USD e, em seguida, construir e instalar o USD para iOS em /path/to/my_usd_install_dir .

 > python OpenUSD/build_scripts/build_usd.py --build-target iOS --build-monolithic /path/to/my_usd_install_dir

Ou para visionOS:

 > python OpenUSD/build_scripts/build_usd.py --build-target visionOS --build-monolithic /path/to/my_usd_install_dir

Windows:

Inicie o "prompt de comando das ferramentas nativas x64" para sua versão do Visual Studio e execute o script no shell aberto. Certifique-se de usar o prompt de comando de 64 bits (x64) e não o prompt de comando de 32 bits (x86).

Consulte https://docs.microsoft.com/en-us/cpp/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line para obter mais detalhes.

Por exemplo, o seguinte irá baixar, construir e instalar as dependências do USD e, em seguida, construir e instalar o USD em C:pathtomy_usd_install_dir .

 C:> python OpenUSDbuild_scriptsbuild_usd.py "C:pathtomy_usd_install_dir"

4. Experimente

Defina as variáveis ​​de ambiente especificadas pelo script quando ele terminar e inicie usdview com um ativo de amostra.

 > usdview OpenUSD/extras/usd/tutorials/convertingLayerFormats/Sphere.usda

Contribuindo

Se você quiser contribuir com o USD (e agradecemos a ajuda!), consulte a página Contribuindo na documentação para obter mais informações.