Ir para o conteúdo

Prontidão do ziviDomeLive 1.5.0

Este documento separa evidências automatizadas da qualificação que exige GPU e outputs nativos. Ele não transforma a topologia interna do renderer 1.x em um contrato permanente de API.

Identidade da Release

  • Versão semântica: 1.5.0
  • Contador de release Processing: 10
  • Toolchain Java: 17
  • Processing core: 4.5.6
  • Devolay: 2.2.0-vic.1
  • Licença: GPL-2.0-only

ReleaseMetadataTest exige que build.gradle.kts, release.properties, library.properties, CITATION.cff, .zenodo.json e CHANGELOG.md concordem.

Evidência Automatizada

Área Evidência
Compatibilidade pública 1.x Reflexão e ordem de enums
Preview e outputs Políticas puras de estado, rota e dimensão
Cenas e lifecycle Testes headless de ownership e recuperação
RenderMode Requisitos transitivos, rotas e layout do painel
Orientação Deltas cíclicos, ordem de composição e quaternion normalizado
NDI RGBA, stride, progressivo, linhas, backpressure e shutdown
Metadados Coerência entre todos os arquivos de release
Documentação MkDocs bilíngue com --strict e Javadocs
Pacotes ZIP, PDEX e TXT verificados

Execute em um checkout limpo:

./gradlew clean qualificationTests
./gradlew buildReleaseArtifacts
mkdocs build --strict

qualificationTests executa a suíte JUnit completa em um único fork headless e grava:

  • build/reports/qualification/summary.md para leitura humana;
  • build/reports/qualification/summary.json para automação;
  • build/reports/qualification/tests/index.html com detalhes;
  • build/test-results/qualification/ com XML JUnit.

Filtros como --tests '*CameraManagerTest' servem apenas para diagnóstico. A aceitação exige a suíte completa. src/test/** permanece no Git, mas fontes de teste e build/** não entram no deploy ao sketchbook nem nos pacotes Processing.

O workflow .github/workflows/automated-qualification.yml executa a mesma tarefa em pushes, pull requests para main e disparos manuais. O resumo aparece no job e a evidência detalhada permanece como artifact por 30 dias.

A verificação limpa de referência anterior à última passagem editorial, em 2026-08-11, produziu 182 testes: 181 aprovados, nenhuma falha e um skip de Syphon condicionado ao ambiente. Também concluiu build, Javadocs, MkDocs estrito e os três artefatos Processing. A validação final deve ser repetida no commit a ser marcado.

Matriz de Hardware

Sucesso automatizado não completa estes itens:

Qualificação Evidência exigida Estado local
Compatibilidade visual da GPU Capturas do CalibrationTool Não executado
Faces e emendas do cubemap Identidade, orientação, continuidade e espelhamento Não executado
Foco e amostragem Linhas, pontos e estrelas em todas as escalas Não executado
Cor e luminância Rampas, barras, cinza e clipping Não executado
Referência esférica Polos +Z/-Z, seam e rotação de 60 segundos Não executado
Calibração esférica Capturas de FOV, Size%, pitch, yaw e roll Não executado
Standard independente Standard isolado e com domemaster flutuante Não executado
Syphon Sender/receiver macOS, resize, pause/resume e shutdown Não executado
Spout Sender/receiver Windows, resize, pause/resume e shutdown Não executado
NDI Discovery, cor RGBA, orientação, resize e telemetria Não executado
OpenGL 1282 Execução sustentada no hardware alvo Não executado

Protocolo Visual Resumido

  1. Abra examples/CalibrationTool/CalibrationTool.pde em cada GPU alvo.
  2. Na Cena 1, confira identidade, índice, orientação e continuidade das seis faces.
  3. Inspecione grades, safe areas, círculos, raios, crosshairs, linhas, pontos e estrelas.
  4. Confira rampas RGB/CMY, barras puras, escala de cinza e patches de clipping.
  5. Capture fisheye, equiretangular, cubemap e Standard.
  6. Teste passos de 90 graus e sequências ordenadas de pitch, yaw e roll.
  7. Teste FOV, Size% e Standard com domemaster flutuante.
  8. Na Cena 2, confira polos, equador, seam e seleção de textura por resolução.
  9. Execute os dois perfis de rotação de 60 segundos e observe shimmer e cadência.
  10. Repita enable/disable, resize, pause/resume e shutdown em cada output suportado.
  11. Registre Processing, OS, arquitetura, GPU, driver, receiver, resolução e erros OpenGL.

O procedimento completo está no Protocolo do Calibration Tool.

Aceitação da Release

O candidato pode receber a tag somente quando:

  • todos os comandos automatizados passam em árvore limpa;
  • os artefatos contêm 1.5.0 e contador Processing 10;
  • a tag é exatamente v1.5.0 e passa em verifyReleaseTag;
  • licenças, avisos de terceiros e citação estão dentro do pacote;
  • README, Javadocs, exemplos e documentação bilíngue descrevem a mesma API;
  • lacunas de hardware foram executadas ou aceitas explicitamente;
  • nenhum backend experimental 2.0 está presente;
  • não há alterações locais de fonte ou artefatos gerados sem commit.