ComfyUI Node

AKXZ Preview Plot

The debug node that reads metadata out of a plot

By akawana·Created 9 months ago·Updated 7 months ago· 4
AKXZ Preview Plot
  • plot_image
  • plot_image
  • params_text

AKXZ Preview Plot is the "trust, but verify" node of the ComfyUI-AK-XZ-Axis pack, and it's filed under AK/Debug because that's exactly what it is: a debugging tool. Its whole job is to read the invisible parameter data back out of a plot image and show it to you as readable text. It's the smallest node in the pack, and for most people it'll be a "occasionally useful to check my work" thing rather than a daily driver - but when you need it, nothing else does what it does.

What it's for

Remember that AK XZ Axis Plot embeds the sweep's parameter config as JSON into the top row of pixels of its output image, with a little AKXZ magic marker? That embedded data is how the pack survives the flattening step - once ten labeled images become one strip, the per-image parameter dicts would normally be gone. AKXZ Preview Plot is the tool that extracts them back.

You feed it a plot_image (the output of AK XZ Axis Plot, in either plot or separate mode) and it:

  • Passes the image straight through unchanged (plot_image out), and
  • Spits out params_text - the recovered config as indented JSON, both on a string output and into a UI text box.

So if you've ever looked at a grid and wondered "wait, was that last column seed 9001 or 9002?", this node settles it. It also doubles as a sanity check that your whole XZ setup is actually wired right - if the extracted JSON is empty, no metadata ever made it into the image, which means the config chain broke somewhere upstream.

The inputs that matter

One input: plot_image (IMAGE). That's the entire interface. In exchange you get two outputs: the same image, and params_text (STRING).

Honestly, most users will connect this node, read the text once, and then bypass it. That's fine. It's the verification pass, not the pipeline.

Install

Same as the rest of the pack - ComfyUI Manager → search AK XZ → install, or:

cd ComfyUI/custom_nodes
git clone https://github.com/akawana/ComfyUI-AK-XZ-Axis.git

Restart, done. Zero extra dependencies, zero model downloads.

The one caveat

Because the payload lives in the top row of pixels, anything that crops, resizes, or re-encodes the plot image before it reaches this node can destroy the embedded data - then params_text comes back empty or garbage, and that's expected, not a bug. Read the params from the plot image directly. It's a debug node with a narrow job, and within that job it works.

CategoryAK/Debug

Inputs (1)

NameTypeDefaultDescription
plot_imageIMAGE

Outputs (2)

NameTypeDescription
plot_imageIMAGE
params_textSTRING