Crop
Extracts a rectangular region from an image, either by trimming each edge or by cropping to an exact output size you position over the source.
Crop has two modes, chosen with the Mode picker.
Edges (the default) removes pixels from the edges of an image. Specify how much to cut from the left, right, top, and bottom, using either pixel amounts or percentages of the source dimensions (toggle with the px/% button on each slider).
Size crops to an exact output size instead. Enter a Width and Height, then position that rectangle directly over the source rather than calculating four insets to reach it. This is the mode to reach for when the output dimensions are the requirement. Switching to Size for the first time starts from your current crop, so nothing jumps, and a later, larger source image satisfies the size you asked for rather than staying clamped to a smaller one.
Both modes show a read-only Output Size readout, so the dimensions you are actually publishing are always visible. In a batch where frames differ in size it reports per-frame rather than a single number.
Positioning a Size crop
Section titled “Positioning a Size crop”In Size mode the Parameters panel gives you exact Left and Top values in pixels, measured in the shown input frame, plus a Center crop button that re-centers the rectangle in one click.
On the canvas, the preview shows the complete source with the rejected exterior darkened, so you can see what you are cutting away rather than only what survives. Drag inside the crop (or use its center handle) to move it, and resize from any edge or corner. A crop that is tiny on screen keeps a reachable Move handle and asks you to zoom in before resizing.
The published output stays the tight cropped region. It recalculates once when a changed drag ends, not on every mouse-move frame, so dragging a crop over a large image stays responsive.
Aspect ratio
Section titled “Aspect ratio”Both modes show the crop’s current aspect ratio next to a Set Aspect… button offering Original, 1:1, common landscape and portrait ratios, or a custom ratio. Picking one re-fits the crop to that shape in a single click.
A persistent Lock Aspect checkbox sits beside it. With the lock on, panel edits and every on-canvas edge or corner drag stay proportional to the chosen or current ratio, reducing both Size dimensions together when the crop reaches the input boundary. With the lock off, holding Shift while dragging gives the same constraint temporarily. Moving a crop never changes its dimensions or its stored aspect ratio.
On-canvas handles
Section titled “On-canvas handles”The preview overlay shows edge and corner handles for the crop rectangle. Hold Ctrl to snap, and hold Shift to lock the aspect ratio for the duration of a drag.
When a size_ref pin is connected, the output dimensions come from the reference. The preview then shows a “Size Reference controls output” message, and the resize and aspect controls are disabled, but you can still see the full input and move the crop boundary over it.
Parameters
Section titled “Parameters”Pins
Crop
Amount to remove from the left edge
Amount to remove from the right edge
Amount to remove from the top edge
Amount to remove from the bottom edge
- Edges: trim by pixel/percent insets from each side.
- Size: crop to an exact output size with continuous placement.
Keep the authored crop ratio while editing
Exact output width in pixels (Size mode)
Exact output height in pixels (Size mode)
Usage Tips
Section titled “Usage Tips”- Use Crop to isolate a specific region of a larger image.
- Switch to percentage mode for resolution-independent cropping that scales with any input size.
- Use Size mode to cut every image in a batch down to the same dimensions, then place the crop once and let it apply across the batch.
- Turn on Lock Aspect before dragging when the shape matters more than the exact pixels; use Set Aspect… when you know the ratio you want.
- Connect a reference image to the size_ref input to auto-crop to its dimensions.
- Combine with Transform for repositioning before cropping.
- Existing projects open in Edges mode exactly as before.