---

◎ What's New - v2.3.3

[!IMPORTANT] Native 32-Bit Scene-Linear Engine
Unlike standard ComfyUI nodes that clamp to 8-bit, Radiance preserves full IEEE 754 floating-point precision across the entire chain. Zero banding. Zero data loss.

• Smart Overwrite Protection — Radiance Write and EXR Save now feature automated index detection to prevent accidental file destruction.
• Universal Digital Cinema I/O — Consolidated Video, Image Sequence, and Single Image handling into a high-performance unified pipeline.
• Robust Pipeline Validation — Enhanced null-safety and input checking for high-load production environments.
• Terminal HUD & Live REPL — Nuke-style Python interaction directly inside the viewer for real-time data inspection.
• Interactive Mask Editor — Non-destructive brush masking in ◎ Radiance Load Image.
• ◎ Radiance Grade Match — Shot-to-shot color statistics transfer using CIE L*a*b* mean/std math.

---

◎ Getting Started

The Radiance Workspace node is the command center for your production. It handles project paths, versioning, and state management, ensuring that all 32-bit data is tracked correctly across your workflow.

1. Add the Workspace Node: Right-click > Radiance > Project > Radiance Workspace.
2. Set your Project Path: Point it to your production directory.
3. Connect to Viewer: Link the workspace output to the Radiance Viewer to enable live telemetry and Python REPL.

---

◎ Node Reference (79 Professional Nodes)

The suite is organized into 11 specialized production zones to mirror industry-standard VFX software topology.

◎ Project, Metadata & DNA (8 Nodes)

Node	Description
Radiance Workspace	Local Project, Shot & Version management with secure .rad v2 containers
Radiance Manager	Cinematic Prompt Studio with 30+ Camera/Lens profiles
Radiance DNA Reader/Writer	Extraction and injection of cinematic metadata
Radiance DNA Validator	SHA256 integrity and version checking for workflow files
Radiance Metadata Overlay	Custom burned-in metadata (Project, Shot, Resolution)

◎ Production I/O & Loaders (10 Nodes)

Node	Description
Radiance Read / Write	Universal 32-bit I/O with auto-increment and high-bitrate support (H.265 10-bit, ProRes)
Radiance Unified Loader	Smart model loader (Flux/SDXL) with precision auto-detection
Radiance LoRA Stack	Multi-layer LoRA management in a single node
Radiance CLIP Slot	Specialized CLIP conditioning slots for multi-prompt chains
Radiance Image & Mask	Professional loader with non-destructive mask layering

◎ HDR Imaging & Color Science (23 Nodes)

Node	Description
OCIO Color Transform	Industry-standard OpenColorIO v2.2 integration
ACES 2.0 Output	Professional ACES 2.0 Display/View transforms
Log Curve Decode/Encode	Precise curves for LogC3/C4, S-Log3, REDLog, etc.
HDR Tone Map / Expand	Advanced dynamic range recovery and tonemapping
Radiance VAE Encode/Decode	16-bit precision VAE processing for high-fidelity latents
Radiance LUT Apply/Blend	GPU-accelerated 33³ LUT processing with smooth blending
Wide Gamut Utilities	DaVinci and ARRI Wide Gamut color space primitives

◎ VFX Grading & Analysis (15 Nodes)

Node	Description
Radiance Grade	32-bit Lift/Gamma/Gain/Offset with cinematic presets
Radiance Grade Match	CIE L*a*b* mean/std statistics transfer for shot matching
Apply Grade Info	Replay saved grade JSON strings onto new shots with strength control
Radiance Waveform	GPU-accelerated RGB Parade / Luma / Overlay
Radiance Vectorscope	Phase-accurate hue/sat monitoring with Skin Tone line
Radiance False Color	IRE-calibrated 7-zone exposure mapping
Radiance QC Pro	Automated technical QC (Gamut, Clip, Banding)

◎ AI Vision & Temporal (15 Nodes)

Node	Description
Radiance Sampler Pro	High-end sampling (Flux/WAN) with AYS and Dynamic Guidance
Radiance Resolution	Advanced resolution selection with 8-pixel alignment
Depth Anything V2	Professional monocular depth estimation
Radiance Temporal Smooth	Motion-aware EMA flicker reduction for AI video
Radiance Pro Upscale	Vectorized kernel upscaling (Lanczos/Mitchell/Catmull-Rom)

---

◎ Quick Start Workflows

---

◎ Installation

Option 1: ComfyUI Manager

1. Open ComfyUI Manager
2. Search for Radiance
3. Click Install

Option 2: Manual (Git)

cd ComfyUI/custom_nodes
git clone https://github.com/fxtdstudios/radiance.git
cd radiance
pip install -r requirements_windows.txt  # Or linux/mac_silicon

[!TIP] Linux/macOS Users: Ensure you have libopenexr-dev installed via your package manager before running the requirements install.

---

◎ Troubleshooting

ComfyUI Manager Security Level

If ComfyUI Manager refuses to install Radiance because only the default channel is allowed, install manually with Git:

cd ComfyUI/custom_nodes
git clone https://github.com/fxtdstudios/radiance.git
cd radiance
pip install -r requirements.txt

Restart ComfyUI after installation. If you use a platform-specific requirements file, choose requirements_windows.txt, requirements_linux.txt, or requirements_mac_silicon.txt.

Dependency Conflicts

Radiance avoids strict upper version caps where possible so ComfyUI and other custom nodes can resolve shared packages. If another extension conflicts, reinstall Radiance dependencies last, then restart ComfyUI.

EXR / HDR Saving

Use ◎ Radiance Write, ◎ Radiance Save EXR, or ◎ Save Image 16-bit for managed outputs. Radiance writes non-overwriting filenames and reports saved files to ComfyUI history so API users can discover generated outputs from prompt history.

For EXR support, Radiance sets OPENCV_IO_ENABLE_OPENEXR=1 at import time, but the Python EXR packages must still be installed. On Linux, install the system OpenEXR development package before pip install -r requirements_linux.txt.

Viewer Export

The viewer preview is interactive. To bake the result, run the workflow first, open the Radiance Viewer controls, then use the delivery/export controls. Grain, bloom, halation, diffusion, and denoise are baked by the delivery path; purely interactive display/navigation overlays are not part of the source image.

32-Bit HDR Expectations

Radiance preserves 32-bit float values when upstream data contains them. It cannot recover highlight or shadow detail that was already clipped in an 8-bit source image. For true HDR workflows, start from EXR/HDR, scene-linear, or float outputs where possible.

Viewer And Lens Controls

◎ Radiance Viewer is the current viewer node. Legacy workflows that reference the older Pro Viewer name are mapped to the current viewer. Lens effects are in the Viewer Lens tab; use 32-bit mode for the widest HDR preview range and use the Strong Preview preset when tuning bloom, halation, and anamorphic streaks.

Old Workflows

Use the .rad workflows in the workflows/ folder for current node layouts. Very old JSON workflows may contain stale widget order or renamed nodes and should be rebuilt or imported through the current Radiance Workspace tools.

---

◎ Professional Keyboard Shortcuts

Radiance is designed for a keyboard-driven VFX workflow. Use these shortcuts to monitor, grade, and navigate your shots with industry-standard precision.

◎ Navigation & Playback

◎ Channel Monitoring

◎ Analysis & Scopes

◎ Community & Support

Radiance is backed by a professional team of VFX Technical Directors. Engage with us through our official channels:

◎ Official Discord Server

• Production Workflows: Access exclusive .rad templates and cinema-grade JSON presets.
• Direct Engineer Support: Real-time troubleshooting and feature requests.
• Showcase: share your work and get feedback from industry veterans.
• Beta Access: Test experimental HDR and temporal nodes before public release.

Join the FXTD Studios Discord

---

◎ Technical Resources

• Documentation: radiance.fxtd.org
• Issue Tracker: GitHub Issues
• Official Site: fxtd.org

---

◎ License & Credits

• License: GPL-3.0
• Authors: Created by the FXTD Studios team.
• Technology: Built on OpenColorIO v2.2, OpenEXR, and Colour-Science.
• Special Thanks: The ComfyUI community for pushing the boundaries of AI generation.

◎ References

• Reinhard, E., Ashikhmin, M., Gooch, B., Shirley, P. Color Transfer between Images. IEEE CGA, 2001.
• Hable, J. Filmic Tonemapping Operators. GDC 2010.
• Hill, S. HDR Color in Call of Duty. SIGGRAPH 2014.
• Academy of Motion Picture Arts and Sciences. ACES 2.0 Reference Rendering Transform. 2024.
• Sobotka, T. AgX: A Minimal Color Transform. Blender Institute, 2023.
• Magnor, M. et al. Digital Video Processing for Engineers. Morgan & Claypool, 2012.
• OpenColorIO Contributors. OpenColorIO v2 Architecture. ASWF, 2023.
• Colour-Science for Python. https://www.colour-science.org/. 2024.
• Narkowicz, K. ACES Filmic Tone Mapping Curve. Blog, 2016.
• ITU-R BT.1203. Subjective Picture Quality Assessment for Digital Cable Television Systems. ITU, 1994.

---

↑ Back to top