imageSplitTiles

Description

The imageSplitTiles node splits an input image into a grid of overlapping tiles. This is useful for tile-based image processing, feeding large images into models with smaller input windows, or preparing tiles for a companion merge node.

Inputs

image

• type: IMAGE
• required: true
• The input image to split into tiles.

overlap_ratio

• type: FLOAT
• required: true
• default: 0.0
• range: 0.0 to 0.5
• step: 0.01
• Fraction of the tile size used as overlap between neighbouring tiles. Higher values create wider overlapping borders; 0.5 is the maximum allowed overlap ratio.

overlap_offset

• type: INT
• required: true
• No default is declared in the node definition; provide an integer.
• Integer pixel offset used in the overlap calculation. It lets you adjust the overlap in fixed pixels, independent of the ratio-based value.

tiles_rows

• type: INT
• required: true
• default: 2
• range: 1 to 50
• Number of rows to split the image into. A value of 1 means no vertical splitting.

tiles_cols

• type: INT
• required: true
• default: 2
• range: 1 to 50
• Number of columns to split the image into. A value of 1 means no horizontal splitting.

norm

• type: BOOLEAN
• optional: true
• default: true
• Normalize the OVERLAP output coordinates to the range [0, 1] relative to the original image. When disabled, the overlap output uses raw pixel values. Leave this enabled for most workflows, especially when the overlap output will be consumed by a merge or utility node.

Outputs

IMAGE output

• The generated image tiles, stacked as a batch. Use the INT output to know how many tiles are present.

MASK

• A mask corresponding to each tile. These masks are useful for compositing, blending, or passing to a companion merge node.

OVERLAP

• Overlap metadata generated while splitting. This is a custom output type intended for the matching merge node; it contains the tile position/overlap information needed to reconstruct the original image. The norm input controls whether these values are normalized or raw pixel coordinates.

INT

• The number of tiles produced. Typically equal to tiles_rows × tiles_cols.

Usage Notes

• Use tiles_rows = 1 to split only horizontally, or tiles_cols = 1 to split only vertically.
• The maximum overlap_ratio is 0.5, so a tile cannot overlap by more than half of its size.
• When in doubt, leave norm enabled.
• The OVERLAP output is not a standard image or conditioning tensor; consume it with the corresponding merge node, such as the companion image merge node.