LightSound Lab 03 · Guide
Guide
For users, students and teachers of the LightSound hub: what the studio is for, how its screen is organised, how to make a light étude in time and how to save and hand in your work.
Contents
1. What the studio is for
LIGHT ACTOR · CANVAS 0.3 is an interactive graphic editor in time for designing light compositions, visual dramaturgy and light études. It combines building light forms on a plane with a score of cues laid along the waveform of your music, so that smooth light transitions can be composed without programming or complex 3D animation.
Version 0.3 adds music, live recording of gestures, an educational DMX patch with a cue list for the console and an automatic check for dangerous flashing. The studio works in the browser with nothing to install, supports touch screens and the mouse, and saves projects and scores as JSON files.
2. The working space
Left panel — composition tools
- 01 / Stage canvas: switch the background between Black (#050505 — a dark stage, where forms act as beams or pools of light) and White (#ffffff — an architectural or graphic sketch).
- 02 / Create a shape: six basic forms appear in the centre of the canvas — circle, square, triangle, line, ellipse and hexagon. New forms start in Additive (light) mode.
- 03 / Layers: order of overlap (↑ Up, ↓ Down), Duplicate and Delete. The top item in the list covers those below it.
- 04 / Composition: Export PNG saves the current frame at 1000 × 1000 px; Clear empties the stage (it can be undone).
Centre — stage and score
- Stage / square (X / Y): the working canvas of 1000 × 1000 units. The selected form is outlined with a dashed frame. Centre returns it to the point (500, 500); Full screen enlarges the stage for a demonstration or rehearsal.
- 06 / Score · music and live recording: ♪ Load audio draws the waveform of an MP3 or WAV file and sets the length of the score (up to 15 minutes). Click or drag along the waveform to go to any moment. Blue lines are cues recorded by hand; thin amber lines are points of a live recording.
- Cue buttons under the waveform jump to each cue. Erase live recording removes the live points but keeps the cues; Cue list (CSV) exports the table for the console.
- Flash check: a line under the score tells you whether the brightness of the stage changes abruptly more than three times a second — the WCAG 2.3 threshold for photosensitive epilepsy.
Right panel — properties of the selected shape
- 05 / Shape properties: layer name, colour, opacity (0–100 %), position X / Y, width, height, rotation (−180° … +180°) and blend mode:
- Normal (source-over) — opaque or semi-transparent overlap;
- Additive (light) (lighter) — brightnesses add up, as where beams of light cross on a dark background;
- Multiply, Screen and Difference — for more complex optical and contrast studies.
- Educational DMX patch: every form occupies 8 channels — 1 dimmer, 2–4 red, green and blue, 5 pan, 6 tilt, 7 beam, 8 reserved — so form 1 has address 001–008, form 2 009–016 and so on, up to 64 forms in one universe of 512 channels.
3. Step by step: making a light étude
- Load the music (optional). Press ♪ Load audio (MP3/WAV). The waveform appears and the length of the score follows the track. Without audio you can work with the timer.
- Build the opening scene (0.0 s). Choose the black stage, create several forms and give them colours and opacity. Make sure the playhead is at 0.0 s and press + Record cue.
- Add cues along the music. Click on the waveform where the music changes. If the preview has switched on, press ■ Stop / edit. Change the stage and press + Record cue. A new form fades in; a deleted one fades out.
- Or record live. Put the playhead where you want to start and press ● Live recording. While the music plays, drag the forms and move the sliders; the stage is captured every 0.25 s. Press the button again (or ■ Stop / edit) to finish. Recording again from the same moment replaces the earlier take; cues recorded by hand stay.
- Play, check and save. Press ▶ Play. Read the flash check under the score; if it warns you, space the cues further apart or soften the change in brightness. Then save the score and export the cue list.
4. Saving and keyboard shortcuts
- Save project (top bar) saves only the current still composition: LIGHT_ACTOR_composition.json.
- Save score + stage saves the stage, all cues and live points: LIGHT_ACTOR_partytura.json. The audio file itself is not stored — keep it next to the score and load it again after opening.
- Cue list (CSV) saves LIGHT_ACTOR_cue_list.csv: cue number, time, fade time since the previous cue, stage colour, number of forms and the DMX values of each form.
- Ctrl + Z / Ctrl + Y — undo or redo (up to 80 steps); arrow keys move the selected form by 2 units, Shift + arrows by 20; Delete removes it.
- During score preview, editing is paused; press ■ Stop / edit to continue composing. Scores from version 0.2 open without changes.
5. For teachers
- A simple assignment: a light étude of 30–90 seconds to a chosen piece of music, with at least four cues and one live-recorded passage, handed in as LIGHT_ACTOR_partytura.json, the audio file and the cue list (CSV).
- Open the student’s score with Open score, load the same audio and press ▶ Play to see the étude exactly as it was composed.
- Discuss the cue list as a lighting operator would: which cues need long fades, which are cut on the beat, and how the DMX values would change on a real fixture.
- Ask students to keep the flash check green: work that flashes more than three times a second must not be shown to an audience.
6. Methodological notes
The digital blend modes (lighter, screen, multiply) are an artistic model for designing light dramaturgy; they do not replace a photometric calculation of light flux. The DMX patch is a simplified teaching model: real fixtures have their own channel maps, and Pan and Tilt there are rotation angles rather than positions on a canvas. The flash check analyses the average brightness of the whole stage; it is a safeguard, not a certified test.
7. Changes in version 0.3
- Music: loading MP3 / WAV files, a waveform with navigation, scores up to 15 minutes.
- Live gesture recording every 0.25 s, with re-recording and erasing of live points.
- An educational 8-channel DMX patch for every form and a cue list (CSV) for the console.
- A flash check by the WCAG 2.3 criterion; the stage colour now fades smoothly instead of switching abruptly.
- Full interface in Ukrainian, English and Hungarian; scores from version 0.2 remain compatible.
← Back to the LIGHT ACTOR page
Lux Aeterna / LightSound project
Concept and direction: Daniel A. Freedman — stage director, founder of the Lux Aeterna Light and Music Theatre
Published on LightSound — a digital ecosystem-school for interdisciplinary research
Scientific and Educational Institute of Multidisciplinary Research “SMART City”, Uzhhorod National University · svitlozvuk.freedanman.com · 2026