imageTilesFromBatch

The imageTilesFromBatch node extracts a single tile from a batch of image tiles and its matching mask from a batch of tile masks. It is intended for tiled workflows where an image has been split into overlapping tiles: after tiling, this node lets you pull out one specific tile by zero-based index while also returning that tile’s position information for later stitching or coordinate-aware processing.

Description

Use this node when you need to process or inspect one tile from a tiled image batch. The tiles and masks inputs are expected to come from the same tile-splitting process, and the overlap input carries the layout metadata needed to determine where the selected tile sits within the original image.

Inputs

tiles (IMAGE): A batch of tile images. The selected tile is taken from this batch at the given index.
masks (MASK): A batch of masks corresponding to the tiles. The mask at the same index is returned alongside the tile.
overlap (OVERLAP): An overlap/layout object produced by the tile-splitting node that created the tiles and masks. This is not a plain integer overlap amount; it contains the geometry needed to calculate the selected tile’s position.
index (INT): The zero-based index of the tile to extract. Defaults to 0, with a minimum of 0 and maximum of 10000.

Outputs

IMAGE: The tile image at the selected index.
MASK: The tile mask at the selected index.
INT: The horizontal position of the selected tile in the tiling layout, as derived from the overlap metadata.
INT: The vertical position of the selected tile in the tiling layout, as derived from the overlap metadata.

The two integer outputs are typically the tile’s position in the original image or tile-grid coordinate space, and are useful when the selected tile needs to be recombined, compared, or processed with awareness of its location.

Usage Notes

Tiles are indexed starting at 0, so index = 0 selects the first tile.
The overlap value must come from the same tile-splitting node that produced the tiles and masks; using mismatched overlap metadata will produce incorrect positions.
This node is useful for per-tile processing, such as feeding individual tiles into an upscaler, inpaint model, or other image-to-image node, while retaining the coordinates needed to put the results back together.
The output order is image, mask, x position, y position.