RollLux
✨ RollLux(Smart Auto Lighting)
Perceptive Full-Auto Metering Lighting
· The luckier you are, the better your lighting looks!
· Lights should know how to adjust themselves.
· Your lighting plans should twist and turn in a thousand ways.
· Blazing fast responses, no AI required.（AI is slow）
— From a guy who just wants to quickly light it and move on
Introduction
RollLux is a Blender 5.0+ extension that analyzes a reference photo and builds a ready-to-tune light rig — key, fill, rim, accent, and world ambient — so you can replicate cinematic, portrait, product, and stylized looks without hand-placing every light.
Every strategy thumbnail and library reference is procedurally generated in code — shaded spheres, gradient maps, and light blobs — not hand-picked stock photos. Roll Random anytime for a fresh combo, or step through named starting points that share the same generative pipeline.
Drop in a reference, hit Generate, and refine with real-time sliders. Works with Cycles and Eevee, fully offline, zero pip installs.
| Blender | 5.0.0 or newer |
| Engines | Cycles · Eevee |
| Dependencies | None (uses Blender’s bundled NumPy) |
✨ Features
| Feature | What you get |
|---|---|
| 🎯 Reference analysis | Key / fill / ambient colors, contrast, mood, color temperature |
| 🧭 LuxPro direction | Portrait-tuned light direction (left, right, top, backlight…) with confidence |
| 🎨 Dual-tone gel lights | Blue + red/magenta (and similar) each get their own accent SPOT |
| ⚡ Split & hard light | Sharp terminators → SPOT key, minimal fill, auto contrast / shadow seeding |
| 🎛️ Live tuning | Intensity, exposure, distance, rotation, saturation, shadows, highlights, contrast |
| 📸 Auto exposure | Viewport sampling in Rendered mode; TRIM / LOG / P60 metering, EV bias, fast converge, LIGHT_RIG bake |
| 🧩 Quick / Pro UI | Compact Quick workflow or full Pro panel with advanced AE, rig, and per-light controls |
| 🎲 Procedural presets | Strategy thumbnails & distribution refs generated in code — random roll yields new looks every time |
| 🗂️ Strategy picker | Named starting styles + Random · procedural shaded-sphere previews · step navigation |
| 🖼️ Distribution library | Built-in reference images procedurally synthesized (gradients, blobs, rim, vignette…) |
| 💡 1–8 lights | Hue-diverse k-means palette matched to light count |
| 🔧 Per-light edit | Toggle, recolor, energy, softness, delete |
| 🪟 Floating overlay | Pin reference in viewport (opacity, scale, corner) |
| 📋 Clipboard paste | Paste reference image from system clipboard |
| 🌐 Trilingual UI | English / 中文 / 日本語 |
📊 RollLux vs manual lighting setup
| Manual rig | RollLux | |
|---|---|---|
| Start from reference photo | ❌ | ✅ |
| Auto direction + color | ❌ | ✅ |
| Dual gel / accent detection | ❌ | ✅ |
| Random roll | ❌ | ✅ |
| Procedural preset & ref generation | ❌ | ✅ |
| Live slider updates | — | ✅ |
| Auto Light Meter | ❌ | ✅ |
| Fully offline | ✅ | ✅ |
Basic workflow
- 3D Viewport → N → RollLux tab.
- Load or paste a reference image (a procedurally generated default is applied on first open).
- Pick a Strategy preset or tap 🔄 Random for a freshly generated style.
- Optionally change Lighting Distribution (procedural library) or use your own photo.
- Select your subject → Generate Lighting.
- Tune Intensity, Contrast, Shadows, Highlights, Saturation — updates apply live.
- Switch the 3D View to Rendered shading and enable Auto Exposure (on by default)
- Use Quick for a compact panel, or Pro for full AE and rig controls.
What's New
5.5.5 June 23rd, 2026
·New lighting distribution map modes: Balanced, Soft, and Vibrant
·Added distinct method for color extraction
·Optimize code