ILLUMIN8 QR  v1.7
Free, open QR code generator for DaVinci Resolve and Fusion Studio
by Shannon Glen, Illumin8 Productions (Hervey Bay, QLD)
https://illumin8productions.com.au
=====================================================================

Type a URL, get a razor sharp, scannable QR code. Fusion page and Edit page.
Pure Lua: no installers, no licence keys, works on Mac, Windows and Linux,
and doesn't break when Resolve updates. MIT licensed: share it, mod it.

INSTALL
The "Fusion" folder in this zip mirrors your Fusion user folder. Merge it in:
   Mac:     ~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/
   Windows: %APPDATA%\Blackmagic Design\DaVinci Resolve\Support\Fusion\
   Linux:   ~/.local/share/DaVinciResolve/Fusion/
You end up with three Illumin8 folders:
   Fusion/Fuses/Illumin8/Illumin8QR.fuse ........................ the tool
   Fusion/Templates/Edit/Generators/Illumin8/Illumin8 QR Generator.setting ... Edit page
   Fusion/Illumin8/Illumin8QR_Presets.txt ........................ your presets (auto created)
Quit Resolve first, relaunch after. Remove any older copies of Illumin8QR.fuse first.
Mac tip: Finder > Cmd+Shift+G and paste the path. ~/Library is hidden by default.

USE
Edit page:   Effects > Generators > Illumin8 QR Generator. Drop it above your shot.
Fusion page: Shift+Space, type "Illumin8 QR", Merge over your plate.

CONTROLS
Text / URL ............ what the code opens. Shorter = chunkier modules = easier scan.
Error Correction ...... default High (30%). Best for cinema and big screens.
Size .................. code size as a fraction of frame height.
Position .............. Custom (drag Center), Centre, or any corner.
Corner Margin ......... gap from the frame edge for the corner positions.
Quiet Zone ............ border in modules. Spec is 4. Don't go below 2.
Snap To Pixels ........ whole pixel modules for razor edges. Leave on.
Resolution ............ always renders at full timeline resolution. Use Size to scale.
Code / Background ..... colours. Keep dark code on a light background.
                        Background Alpha 0 = code only, no box.

PRESETS (no pop-ups, all in the Inspector)
Save .................. type a name in Preset Name, hit Save. Same name = overwrite.
Load .................. type the name (case doesn't matter), hit Load. Tick
                        "Keep Current URL On Load" to apply just the look.
Prev / Next ........... flick through your saved presets. Each click loads the next one.
Delete ................ type the name (or browse to it), hit Delete.
Saved Presets ......... list of everything saved, ">" marks the loaded one.
Presets live in one plain text file: Fusion/Illumin8/Illumin8QR_Presets.txt
(older builds kept it loose in the Fusion folder: it gets moved in automatically).
Back it up or share it with other editors.

EXPORT SVG TO DESKTOP
Saves the current code as a vector SVG with your colours, named after the preset and
time stamped. For posters, print, social and web: matches the on-screen code exactly.

BIG SCREEN RULES OF THUMB
- Hold the code on screen 5 seconds minimum, 7 to 10 is better.
- Size 0.3 to 0.5 of frame height reads from the back rows.
- Use a short URL or a redirect you control, so you can change the destination later.
- Test-scan off the actual screen before going live.

TROUBLESHOOTING
- Not in the Shift+Space list? The Fuse didn't load: check the path, restart Resolve,
  open Workspace > Console and look for red lines.
- Red frame = the Fuse hit an error. The Console prints "Illumin8 QR ERROR: ...".
- The Console also logs render resolution and QR version whenever they change.

CREDITS
Made by Shannon Glen, Illumin8 Productions. If it saves you time, say g'day:
https://illumin8productions.com.au
QR Code is a registered trademark of DENSO WAVE INCORPORATED.
