CropByBBoxes - ComfyUI Built-in Node Documentation

The CropByBBoxes node extracts and resizes specific rectangular regions from an input image batch. It uses provided bounding box coordinates to define the area to crop from each image. The cropped regions are then resized to a specified output dimension, with options to either stretch the crop or pad it to preserve its original aspect ratio.

Inputs

Parameter	Description	Data Type	Required	Range
`image`	The input batch of images to crop.	IMAGE	Yes	-
`bboxes`	The list of bounding boxes defining the regions to crop. This input is forced, meaning it must be connected.	BOUNDINGBOX	Yes	-
`output_width`	The width each crop is resized to (default: 512).	INT	No	64 - 4096
`output_height`	The height each crop is resized to (default: 512).	INT	No	64 - 4096
`padding`	Extra padding in pixels added on each side of the bounding box before cropping (default: 0).	INT	No	0 - 1024
`keep_aspect`	Whether to stretch the crop to fit the output size, or pad with black pixels to preserve its aspect ratio (default: “stretch”).	COMBO	No	`"stretch"` `"pad"`

Note: The node processes one image frame at a time. If multiple bounding boxes are provided for a single frame, it calculates a single crop region that is the union (the smallest rectangle containing all boxes) of all provided boxes. If a calculated crop region is invalid (e.g., zero width or height), the node will create a fallback crop from the center-top of the image.

Outputs

Output Name	Description	Data Type
`image`	All cropped and resized regions, stacked into a single image batch.	IMAGE

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): 7524d629e61f5af2475f819bc9431d4f4173feb5ad59f9bcf81d822330fb3e22

CenterCropImages - ComfyUI Built-in Node Documentation

ImageCrop - ComfyUI Built-in Node Documentation

​Inputs

​Outputs

Inputs

Outputs