4ever-coder/ar-film-creator

AR Film Creator

Use o projeto incluído como fonte da verdade para novos projetos. Mantenha a câmera, rastreamento, geometria, oclusão e pipeline do servidor estáveis, a menos que o usuário solicite explicitamente alterações de interação.

Roteie a solicitação

1. Classifique a solicitação:
   • Novo projeto: instancie assets/browser-ar-template.
   • Alteração apenas de estilo: edite src/filter-presets.js.
   • Alteração de comportamento: edite primeiro a geometria predefinida ou os valores de movimento.
   • Alteração de mecanismo (engine): edite src/app.js apenas quando os campos predefinidos não puderem expressar a solicitação.
2. Leia references/preset-contract.md para cada alteração de estilo ou comportamento.
3. Leia references/filter-recipes.md ao traduzir um briefing visual em parâmetros.
4. Leia references/architecture.md antes de alterar o rastreamento, geometria, ordem de renderização, mascaramento, inicialização ou estrutura de arquivos.

Crie um projeto

Execute:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/New-ArFilmProject.ps1 -Destination "<caminho-absoluto-de-saida>"

Exija um destino ausente ou vazio. Não sobrescreva um projeto existente implicitamente.

Personalize um estilo

1. Preserve um preset existente como um fallback conhecido e funcional.
2. Adicione um novo id de preset único em kebab-case em src/filter-presets.js.
3. Altere apenas os campos definidos por references/preset-contract.md.
4. Mantenha exatamente três definições de camada, a menos que o usuário solicite explicitamente uma alteração no número de camadas no nível do mecanismo.
5. Teste o preset através de ?preset=<id-do-preset>.
6. Confirme que um id de preset desconhecido cai de volta para transparent-film.

Proteja as invariantes do mecanismo

• Preserve as URLs fixas do MediaPipe Tasks Vision e o comportamento de fallback do modelo.
• Preserve a ordenação das duas mãos por posição na tela.
• Preserve as linhas de controle 4, 8, 12 e 20.
• Preserve os limites compartilhados entre superfícies adjacentes.
• Permita transições de dobra e torção; não reintroduza o congelamento por auto-interseção.
• Preserve a ordem de composição: fundo, filmes, mãos/antebraços, controles.
• Preserve a inicialização em localhost e o tratamento de erros de permissão da câmera.
• Mantenha o projeto derivado livre de builds, a menos que o usuário solicite explicitamente outra pilha.

Valide

Execute:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/Test-ArFilmProject.ps1 -ProjectPath "<caminho-absoluto-do-projeto>"

Em seguida, inicie o servidor local e verifique:

1. Raiz, CSS, app.js e filter-presets.js retornam HTTP 200.
2. Os modelos terminam de carregar.
3. O modo de demonstração renderiza quatro linhas de controle curvas e três superfícies conectadas.
4. O preset solicitado é visualmente distinto.
5. A animação de torção cruza ambas as direções de curvatura sem congelar.
6. Os controles de redefinição e suavização funcionam.
7. O console do navegador tem zero erros do projeto.

Use uma ferramenta de automação de navegador real quando disponível. Trate o aviso interno do MediaPipe “OpenGL error checking is disabled” como informativo, a menos que um erro real o acompanhe.

Relate

Relate:

• o preset ou comportamento do mecanismo adicionado;
• arquivos alterados;
• como selecionar e usar o estilo;
• validação concluída;
• verificações de câmera ou hardware que ainda exigem o usuário.