4ever-coder/ar-film-creator

AR Film Creator

Use the bundled project as the source of truth for new projects. Keep the camera, tracking, geometry, occlusion, and server pipeline stable unless the user explicitly requests interaction changes.

Route the request

1. Classify the request:
   • New project: instantiate assets/browser-ar-template.
   • Style-only change: edit src/filter-presets.js.
   • Behavior change: edit preset geometry or motion values first.
   • Engine change: edit src/app.js only when preset fields cannot express the request.
2. Read references/preset-contract.md for every style or behavior change.
3. Read references/filter-recipes.md when translating a visual brief into parameters.
4. Read references/architecture.md before changing tracking, geometry, rendering order, masking, startup, or file structure.

Create a project

Run:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/New-ArFilmProject.ps1 -Destination "<absolute-output-path>"

Require an absent or empty destination. Do not overwrite an existing project implicitly.

Customize a style

1. Preserve an existing preset as a known-good fallback.
2. Add a new unique kebab-case preset id in src/filter-presets.js.
3. Change only the fields defined by references/preset-contract.md.
4. Keep exactly three layer definitions unless the user explicitly requests an engine-level layer-count change.
5. Test the preset through ?preset=<preset-id>.
6. Confirm that an unknown preset id falls back to transparent-film.

Protect engine invariants

• Preserve MediaPipe Tasks Vision pinned URLs and model fallback behavior.
• Preserve screen-position sorting of the two hands.
• Preserve control rows 4, 8, 12, and 20.
• Preserve shared boundaries between adjacent surfaces.
• Permit fold and twist transitions; do not reintroduce self-intersection freezing.
• Preserve composition order: background, films, hands/forearms, controls.
• Preserve localhost startup and camera permission error handling.
• Keep the derived project build-free unless the user explicitly requests another stack.

Validate

Run:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/Test-ArFilmProject.ps1 -ProjectPath "<absolute-project-path>"

Then start the local server and verify:

1. Root, CSS, app.js, and filter-presets.js return HTTP 200.
2. Models finish loading.
3. Demo mode renders four curved control lines and three connected surfaces.
4. The requested preset is visually distinct.
5. Twist animation crosses both bend directions without freezing.
6. Reset and smoothing controls work.
7. The browser console has zero project errors.

Use a real browser automation tool when available. Treat MediaPipe's internal “OpenGL error checking is disabled” warning as informational unless an actual error accompanies it.

Report

Report:

• the preset or engine behavior added;
• files changed;
• how to select and use the style;
• validation completed;
• camera or hardware checks that still require the user.