Orion4D · Matrix 3x3 APP

Every color transform you've ever used - channel mixing, color balance, even white balance - is secretly a 3x3 matrix multiplying your RGB values. Orion4D_FXMax_Matrix3x3 (displayed "Orion4D · Matrix 3x3 APP") just skips the friendly wrapping and hands you the matrix. If you know what a color matrix does, this is the most powerful node in the pack. If you don't, it's the most dangerous. It's for the people who think in numbers.

How it works

You get the full nine coefficients (m00 through m22) where each output channel is a weighted sum of the input channels, plus per-channel offsets, a strength dial that scales the whole transform, preserve_luminosity, and a clamp to keep output in range. The identity matrix - 1s down the diagonal - is the "do nothing" starting point, and it's also the shipped Neutral preset. From there, every coefficient is a question: "how much of the input red should appear in the output blue?" A saturation matrix puts large values on the diagonal and smaller ones off it; a hue rotation is a carefully chosen set of off-diagonals; a warm grade nudges the red-dominant entries up.

The Warm Matrix preset is a working example of the last one - it's worth loading in the Open APP just to see what a few off-diagonal tweaks do to the whole image. Because it's pure linear math, Matrix 3x3 can do things the other color nodes can't: cross-channel bleeding that isn't a "natural" grade at all, exact color-space conversions, and looks you literally cannot dial in with sliders.

Inputs and outputs

Pack-standard schema:

• image - the IMAGE tensor.
• preset - Identity or Warm Matrix.
• raw_settings - "Embedded JSON settings used for workflow portability. Managed automatically by the APP."
• mask (optional) - apply the matrix to only part of the frame.

Outputs: image and mask.

Performance and install

A CPU/NumPy node in the moderate tier - fine on stills, a mild delay on video batches. Install is the pack standard:

cd ComfyUI/custom_nodes
git clone https://github.com/orion4d/Orion4D_FXMax.git
# restart ComfyUI

ComfyUI Manager search "Orion4D_FXMax" works. No models, Pillow-only deps.

Gotchas

This is where you can genuinely wreck an image, so the training wheels matter: keep clamp_output on (it stops out-of-range values from going to pure black or white), and don't zero the whole matrix. Start from Identity or a preset, change one coefficient at a time, and watch the APP's live split-screen. If the image suddenly looks like a negative or a solarization, you've hit a degenerate matrix - undo, don't debug. For everyone who isn't a colorist, the pack's Color Balance or Channel Mixer gives the same ideas in friendlier form.