ComfyUI Node

VNCCS Sheet Extractor

Pulling one panel out of a 2x6 sprite sheet

By AHEKOT·Created 10 months ago·Updated 20 days ago· 1,446
VNCCS Sheet Extractor
  • image
  • image
part_index1
target_width1024
target_height3072

Where VNCCS Quad Splitter handles a simple 2×2 grid, this node is built for a bigger, fixed layout: a 2×6 grid, twelve panels total, indexed 1 through 12 with 1–6 running left-to-right across the top row and 7–12 across the bottom. Feed it a sheet image and a part_index, and it returns just that one panel, resized to a target width and height.

Why a fixed 2×6 layout specifically

Twelve panels on one sheet lines up with generating a batch of related sprites - a full emotion set for one costume, say - as a single combined image rather than twelve separate generations, the same batching logic that makes VNCCS Quad Splitter's 2×2 grid worthwhile at smaller scale. Generating everything in one pass with shared context tends to hold a character more consistent across the set than twelve independent generations would, and it's cheaper besides. This node is the retrieval half of that trick - after the sheet's been generated, pull each of the twelve results back out as a standalone image.

The inputs that matter

  • part_index (1–12, default 1) - which cell of the grid to extract. Remember the indexing: 1–6 top row, 7–12 bottom row, both left to right. Get this wrong and you'll pull a neighboring panel instead of the one you meant.
  • target_width (default 1024, 64–6144) and target_height (default 3072, 64–6144) - the size the extracted panel gets resized to on the way out. Note the default aspect ratio here - tall and narrow (1024×3072) - which matches a standing character sprite far better than a square crop would, a sign this node is built specifically around VNCCS's sprite proportions rather than being a generic grid-cutting utility.

One output, image - just the extracted, resized panel.

Where it fits

Run this once per panel you need pulled from a generated sheet, looping part_index from 1 to 12 (or however many of the twelve you actually populated) to unpack the full set. If you're not sure whether a given VNCCS workflow stage produces a 2×2 or 2×6 layout, check the canvas dimensions of what you're feeding in before picking between this node and Quad Splitter - they're not interchangeable, and running the wrong one against the wrong grid size just gives you a meaningless crop rather than an error.

How to install it

Bundled with the main pack:

  • ComfyUI Manager - search VNCCS - Visual Novel Character Creation Suite, install, restart.
  • Manual - cd ComfyUI/custom_nodes && git clone https://github.com/AHEKOT/ComfyUI_VNCCS.git, then cd ComfyUI_VNCCS_Utils && pip install -r requirements.txt, restart, and let Comfy Manager grab any missing dependencies.

Common issues

Extracted panel shows the wrong sprite. Double-check the index math - it's easy to assume a 2×6 grid runs top-to-bottom column by column instead of left-to-right row by row. Indices 1–6 are the entire top row before 7 starts the bottom row, not 1–2 being the first column.

Extracted image looks stretched. The node resizes unconditionally to target_width/target_height regardless of the source panel's actual proportions, so if your generated sheet's panels don't already match roughly a 1:3 aspect ratio, expect distortion. Either adjust the target dimensions to match your actual panel shape, or fix the aspect ratio upstream at generation time rather than trying to compensate here.

Sheet dimensions don't divide evenly into twelve clean panels. This node assumes a clean, evenly-spaced 2×6 grid with no borders or padding between cells. A sheet generated with visible gutters between panels will extract slightly off, cutting into neighboring content at the edges - check your sheet-generation step's output dimensions before assuming this node mis-extracted.

CategoryVNCCS

Inputs (4)

NameTypeDefaultDescription
imageIMAGE
part_indexINT11–12
target_widthINT102464–6144
target_heightINT307264–6144

Outputs (1)

NameTypeDescription
imageIMAGE