4ever-coder/ar-film-creator

Creador de Películas AR

Usa el proyecto incluido como fuente de verdad para nuevos proyectos. Mantén estables la cámara, el seguimiento, la geometría, la oclusión y el pipeline del servidor a menos que el usuario solicite explícitamente cambios de interacción.

Enrutar la solicitud

1. Clasifica la solicitud:
   • Nuevo proyecto: instancia assets/browser-ar-template.
   • Cambio solo de estilo: edita src/filter-presets.js.
   • Cambio de comportamiento: primero edita la geometría preestablecida o los valores de movimiento.
   • Cambio de motor: edita src/app.js solo cuando los campos preestablecidos no puedan expresar la solicitud.
2. Lee references/preset-contract.md para cada cambio de estilo o comportamiento.
3. Lee references/filter-recipes.md al traducir un resumen visual a parámetros.
4. Lee references/architecture.md antes de cambiar el seguimiento, la geometría, el orden de renderizado, el enmascaramiento, el inicio o la estructura de archivos.

Crear un proyecto

Ejecuta:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/New-ArFilmProject.ps1 -Destination "<ruta-absoluta-de-salida>"

Requiere un destino ausente o vacío. No sobrescribas un proyecto existente implícitamente.

Personalizar un estilo

1. Conserva un preset existente como fallback conocido y funcional.
2. Agrega un nuevo ID de preset único en kebab-case en src/filter-presets.js.
3. Cambia solo los campos definidos por references/preset-contract.md.
4. Mantén exactamente tres definiciones de capa a menos que el usuario solicite explícitamente un cambio de número de capas a nivel de motor.
5. Prueba el preset mediante ?preset=<id-del-preset>.
6. Confirma que un ID de preset desconocido retrocede a transparent-film.

Proteger invariantes del motor

• Conserva las URLs fijas de MediaPipe Tasks Vision y el comportamiento de fallback del modelo.
• Conserva la ordenación por posición en pantalla de las dos manos.
• Conserva las filas de control 4, 8, 12 y 20.
• Conserva los límites compartidos entre superficies adyacentes.
• Permite transiciones de pliegue y giro; no reintroduzcas la congelación por auto-intersección.
• Conserva el orden de composición: fondo, películas, manos/antebrazos, controles.
• Conserva el inicio en localhost y el manejo de errores de permiso de cámara.
• Mantén el proyecto derivado sin compilación a menos que el usuario solicite explícitamente otra pila.

Validar

Ejecuta:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/Test-ArFilmProject.ps1 -ProjectPath "<ruta-absoluta-del-proyecto>"

Luego inicia el servidor local y verifica:

1. Raíz, CSS, app.js y filter-presets.js devuelven HTTP 200.
2. Los modelos terminan de cargarse.
3. El modo demo renderiza cuatro líneas de control curvas y tres superficies conectadas.
4. El preset solicitado es visualmente distinto.
5. La animación de giro cruza ambas direcciones de curvatura sin congelarse.
6. Los controles de reinicio y suavizado funcionan.
7. La consola del navegador tiene cero errores de proyecto.

Usa una herramienta real de automatización de navegador cuando esté disponible. Trata la advertencia interna de MediaPipe "La comprobación de errores de OpenGL está deshabilitada" como informativa a menos que la acompañe un error real.

Reportar

Reporta:

• el preset o comportamiento del motor añadido;
• los archivos modificados;
• cómo seleccionar y usar el estilo;
• la validación completada;
• las verificaciones de cámara o hardware que aún requieren del usuario.