✕

METAMAPPER — HELP

A browser-based polygon editor and generative animation tool for projection mapping by Metamo Industries. Trace regions over a mask reference image, assign animated fill and edge effects per region, modulate parameters with LFOs or live audio, and record the output.

WORKFLOW

1. Click Mask to load your projection mask template as a reference background.
2. Click on the canvas to place polygon vertices over the mask. Each click adds a point.
3. Click Close when your shape has 3+ points to complete the region.
4. Click + Region to start tracing the next panel. Repeat for all surfaces.
5. Click EDIT to toggle to ANIMATE mode and see your effects live.
6. Click Unmask to drop the reference image for better performance.
7. Use ⏺ to record MP4 or 📷 for PNG stills.

TOOLBAR

Editing

EDIT / ANIMATE Toggle between editing polygons and viewing live effects.
+ Region Add a new polygon region.
Undo Pt Remove the last placed vertex (before closing).
Close Close the current polygon (needs 3+ points).
Reopen Reopen a closed shape for editing.

Playback

Play / Pause Start or stop the animation clock.
Fullscr Fullscreen mode for capture or performance.

I/O

JSON Export all regions, effects, and settings as JSON text.
Import Paste JSON into the text area and click to load.
SVG Download regions as an SVG file.
OBJ Download regions as a 3D OBJ mesh (flat, with canvas bounds quad).
Blender Download a Python script that sets up an orthographic camera in Blender matching your canvas.
Mask Load a reference mask image (PNG). Canvas stays at current resolution.
Unmask Unload the mask image to improve performance.

Resolution

½× Half resolution — fast editing and performance.
1× Full mask resolution — for final recording.

Audio & Recording

🎤 Enable microphone input for audio-reactive effects.
⏺ Start/stop MP4 video recording of the canvas.
📷 Save a PNG screenshot of the current frame.

Presets & Randomize

Save Save current state to browser localStorage.
Load Load a previously saved preset.
🎲 Randomize all region fill/edge types, hues, speeds, and blend modes.
Auto dropdown — auto-randomize at set intervals (2s–32s).

SIDE PANEL — GLOBAL

Speed — Global animation speed multiplier.
Bright — Global brightness multiplier.
Mask — Reference mask opacity (edit mode) or faint overlay (animate mode).
Blackout — Master fade to black.
Palette — Four color pickers for the global color palette.

POST FX

Trails — Motion echo/ghosting. Higher values = longer trails. Great with edge particles.
Bloom — Gaussian glow applied additively. Simulates light bleed.
Vignette — Radial edge darkening.
Chrom Ab — Chromatic aberration (RGB channel offset).
Each post-FX parameter has its own LFO/Audio modulation under "▸ POST FX LFO".

SIDE PANEL — PER REGION

▲ ▼ Reorder layers (later = on top).
Dup Duplicate the region with all settings.
M Mute — hide this region.
S Solo — show only soloed regions.

Fill Effects

Noise, Scan Lines, Pulse, Breathe, Rain, Static, Plasma, Gradient, Grid, Ripple, Stripes, or Off.

Edge Effects

Pulse (chasing light trails), Flow (orbiting particles), Strobe (flashing outline), Maze (segmented dashes), Glow (bloom outline), Dashes (animated dash pattern), or Off.

Common Controls

Blend — Compositing mode: Normal, Add, Multiply, Screen, Overlay, Difference.
Opacity — Region transparency.
Scale — Effect pattern zoom (noise density, grid spacing, stripe width, etc).
Angle — Rotates applicable effects (scan, pulse, grid, stripes, gradient).
Phase — Time offset so identical effects on different regions aren't synchronized.

LFO / Audio Modulation

Each parameter can be modulated by a waveform: Sine, Triangle, Sawtooth, Square, Noise, or live audio bands (Bass, Mid, High). Set Rate for speed and Depth for modulation amount. The LFO oscillates around the base slider value.

VERTEX EDITING

In Edit mode, click and drag existing vertices to reposition them. Cyan = dragging, Yellow = last placed point. Vertex indices are shown for reference. Use Reopen on closed shapes to add or remove points.

SHARING

This is a single self-contained HTML file. Share it with the mask PNG and a JSON export of your regions/settings. The recipient opens the HTML in Chrome, loads the mask, and clicks Import to restore your setup.

MetaMapper by Metamo Industries — About