SpriteSheet Pack

Overview

Arranges multiple images into one spritesheet. It combines lists of frame images made as variants or prepared individually into a grid sheet usable by a game engine.

Usage tips

• The input is List<Image>. Connect an output list from a variant node such as variant_range, or frames bundled with list_create.
• With the default columns=0, the node automatically selects a nearly square grid. To meet an engine requirement for one horizontal row, set columns to the number of frames.
• Use animation_render when building a sheet from animation time. This node is for cases where you already have an image list.

Common pitfalls

• Frames have different sizes: every frame must have the same dimensions. Normalize them beforehand with canvas_resize or a similar node.

Related nodes

• animation_render — the other entry point, generating a time-based sheet
• sprite_sheet_playback / sprite_sheet_frame_get — inspect or use the generated sheet
• list_create / variant_range — supply frame lists
• batch_export — export the sheet to a file

Examples

1. Create a List<Image> with ListCreate or another node.
2. Connect it to SpriteSheetPack.frames.
3. Set columns and fill_order if needed.
4. Connect spritesheet to SpriteSheetPlayback or SpriteSheetFrameGet.

Additional notes:

• Every frame must have the same dimensions.
• With columns = 0, the node automatically chooses a nearly square arrangement.
• fill_order = row_major fills from the top left toward the right, while column_major fills from the top left downward.
• Helper metadata outputs remain available when downstream nodes need only the frame count or grid information.