| # Easy Nodes and MG_SuperSimple |
| |
| MagicNodes provides simplified “Easy” variants that expose only high‑value controls while relying on preset files for the rest. These are grouped under the UI category `MagicNodes/Easy`. |
| |
| - Presets live in `pressets/mg_cade25.cfg` and `pressets/mg_controlfusion.cfg` with INI‑like sections `Step 1..4` and simple `key: value` pairs. The token `$(ROOT)` is supported in paths and is substituted at load time. |
| - Loader: `mod/easy/preset_loader.py` caches by mtime and does light type parsing. |
| - The Step+Custom scheme keeps UI and presets in sync: choose a Step to load defaults, then optionally toggle Custom to override only the visible controls, leaving hidden parameters from the Step preset intact. |
|
|
| ## MG_SuperSimple (Easy) |
| |
| Single node that reproduces the 2/3/4‑step CADE+ControlFusion pipeline with minimal surface. |
| |
| Category: `MagicNodes/Easy` |
| |
| Inputs |
| - `model` (MODEL) |
| - `positive` (CONDITIONING), `negative` (CONDITIONING) |
| - `vae` (VAE) |
| - `latent` (LATENT) |
| - `control_net` (CONTROL_NET) — required by ControlFusion |
| - `reference_image` (IMAGE, optional) — forwarded to CADE |
| - `clip_vision` (CLIP_VISION, optional) — forwarded to CADE |
| |
| Controls |
| - `step_count` int (1..4): how many steps to run |
| - `custom` toggle: when On, the visible CADE controls below override the Step presets across all steps; when Off, all CADE values come from presets |
| - `seed` int with `control_after_generate` |
| - `steps` int (default 25) — applies to steps 2..4 |
| - `cfg` float (default 4.5) |
| - `denoise` float (default 0.65, clamped 0.45..0.9) — applies to steps 2..4 |
| - `sampler_name` (default `ddim`) |
| - `scheduler` (default `MGHybrid`) |
| - `clipseg_text` string (default `hand, feet, face`) |
|
|
| Behavior |
| - Step 1 runs CADE with `Step 1` preset and forces `denoise=1.0` (single exception to the override rule). All other visible fields follow the Step+Custom logic described above. |
| - For steps 2..N: ControlFusion (with `Step N` preset) updates `positive/negative` based on the current image, then CADE (with `Step N` preset) refines the latent/image. |
| - Initial `positive/negative` come from the node inputs; subsequent steps use the latest CF outputs. `latent` is always taken from the previous CADE. |
| - When `custom` is Off, UI values are ignored entirely; presets define all CADE parameters. |
| - ControlFusion inside this node always relies on presets (no additional CF UI here) to keep the surface minimal. |
|
|
| Outputs |
| - `(LATENT, IMAGE, selected_seed)` from the final executed step (e.g., step 2 if `step_count=2`). No preview outputs. |
| - `selected_seed` is the seed CADE actually used after SmartSeed selection. With a non-zero fixed seed, it matches the requested seed. |
|
|
| Quickstart |
| 1) Drop `MG_SuperSimple` into your graph under `MagicNodes/Easy`. |
| 2) Connect `model/positive/negative/vae/latent`, and a `control_net` module; optionally connect `reference_image` and `clip_vision`. |
| 3) Choose `step_count` (2/3/4). Leave `custom` Off to use pure presets, or enable it to apply your `seed/steps/cfg/denoise/sampler/scheduler/clipseg_text` across all steps (with Step 1 `denoise=1.0`). |
| 4) Run. The node returns the final `(LATENT, IMAGE, selected_seed)` for the chosen depth. |
|
|
| Notes |
| - Presets are read from `pressets/mg_cade25.cfg` and `pressets/mg_controlfusion.cfg`. Keep them in UTF‑8 and prefer `$(ROOT)` over absolute paths. |
| - `seed` is shared across all steps for determinism; if per‑step offsets are desired later, this can be added as an option without breaking current behavior. |
|
|
|
|
