Instalação¶
Gerenciador de Contribuições¶
Depois da publicação do pacote 2.0.0:
- Abra o Processing.
- Selecione Sketch > Import Library > Add Library....
- Pesquise por ziviDomeLive.
- Instale ziviDomeLive.
- Instale ControlP5 explicitamente pelo Gerenciador de Contribuições caso ainda não esteja instalado.
- Reinicie o Processing.
Após a instalação, abra File > Examples > Contributed Libraries > ziviDomeLive > EmptyProject. A cena vazia deve iniciar sem erros de shader ou dependência. Pressione h para confirmar que o painel de controle pode ser exibido e ocultado.
NDI é opcional e não pode ser instalado pelo Gerenciador de Contribuições do Processing. Instale separadamente o Runtime NDI do sistema antes de habilitar o output de vídeo NDI experimental.
Apple Silicon + Syphon¶
O pacote upstream do Syphon for Processing 4.0 não inclui atualmente o payload nativo Apple Silicon exigido pelo Processing 4.
- Baixe Syphon-for-Processing-4.0-macOS-universal-community.zip.
- Feche completamente o Processing.
- Faça backup ou remova
libraries/Syphon/no Sketchbook. - Extraia o ZIP dentro de
libraries/, resultando emlibraries/Syphon/. - Reinicie o Processing.
Não mescle sobre uma instalação Syphon antiga. Veja Dependências para proveniência e SHA-256.
Artefato de Release¶
Para instalação manual, use o artefato empacotado do release correspondente. Não instale o ZIP do código-fonte como biblioteca Processing:
- Baixe
ziviDomeLive.zipouziviDomeLive.pdex. - Extraia a pasta superior
ziviDomeLive. - Mova-a para o diretório
librariesdo sketchbook indicado nas preferências do Processing. - Instale explicitamente a biblioteca externa obrigatória ControlP5; instale Syphon ou Spout somente quando precisar do output opcional correspondente à plataforma.
- Reinicie o Processing.
O pacote inclui Devolay, mas não o NDI Runtime proprietário. Usuários NDI devem concluir a instalação separada do Runtime NDI correspondente ao sistema operacional.
A estrutura instalada deve seguir este layout de biblioteca Processing:
libraries/ziviDomeLive/
library.properties
library/
examples/
GettingStarted/
Advanced/
Tools/
reference/
Checkout do Código-Fonte¶
Use um checkout do código-fonte somente para desenvolvimento ou verificação de release:
git clone https://github.com/vicvalentim/ziviDomeLive.git
cd ziviDomeLive
./gradlew buildReleaseArtifacts
./gradlew qualificationTests
O pacote instalável é gerado em release/ como ziviDomeLive.zip, ziviDomeLive.pdex e ziviDomeLive.txt.
Para um deploy local no sketchbook em vez de gerar o pacote:
Essa tarefa instala a biblioteca e os exemplos, mas exclui intencionalmente src/test e não executa a qualificação. Rode qualificationTests separadamente antes de considerar o checkout pronto para release. Para verificações de publicação, consulte Publicação Processing.