Overview
Reports the X, Y, width, and height of visible content without modifying the image. Use it to inspect padding before atlas packing, detect empty animation frames, or crop while retaining the original origin.
Usage tips
- For automatic cropping, connect
image → content_bounds → crop. Connect the source image directly tocrop.input, and wirex,y,width, andheightto the matching promoted crop parameters. - Start with an alpha threshold of
0–0.01for ordinary pixel art. Raise it to about0.25–0.5only when soft shadows or glow make the bounds too large. - Include Transparent RGB is an inspection option for assets that intentionally preserve color in fully transparent pixels. Leave it off for normal appearance-based cropping.
- Even when
is_empty=true, width and height are1. This safe value prevents a zero-size error downstream; useis_emptyas the branch condition when empty frames must be removed.
Common mistakes
- Shadows or glow are included: raise the alpha threshold slightly. If the outline is clipped, the value is too high.
- An invisible image reports the full canvas: check whether Include Transparent RGB is on.
- Animation placement jitters: cropping every frame independently changes its origin. Use one union bound for all frames or store X/Y in the export manifest.
Related nodes
crop— crop to the measured rectanglecanvas_resize— place the cropped result back on a fixed canvasregion_info— measure area and center for each existing Region instead of the whole image