Crop one connected image with normalized Left, Top, Width, and Height controls or lock the result to Square, Wide, Portrait, or Story proportions.
Where: Flowgen → Add → Image & Vector → Adjust → Crop
Key ideas
- Crop is one graph step: Crop one connected image with normalized Left, Top, Width, and Height controls or lock the result to Square, Wide, Portrait, or Story proportions.
- Typed sockets: Inputs: Image / image_in — one source image.. Outputs: Image Output / image_out — the cropped raster.. Settings stay on the node rather than masquerading as extra wires.
- Card and Properties agree: The compact card and selected-node Properties sidebar expose the same persisted controls: Aspect: Free, Square 1:1, Wide 16:9, Portrait 4:5, Story 9:16.; Left and Top: 0–1 shares of the source.; Width: 0.01–1 share.; Height: 0.01–1 share in Free mode..
- Execution behavior: This browser-local pure operation previews automatically after a short pause while a control changes, then overwrites one durable result file after the value settles. Deselecting the card or starting a downstream flow flushes the pending save. A terminal error exposes Retry; there is no normal Run button.
- Cost and privacy boundary: It calls no generation provider and charges no Sparks/Flowies. Processing happens in the open browser, so it cannot execute in a headless/server-only flow and the source must be readable by the page.
- Crop card: PureOpNode uses the authored shared-card path. Crop an image with free bounds or a fixed aspect-ratio preset.
- Properties sidebar: Card-owned operation controls; common properties shell
- Opened surfaces: Live image preview
- Direct crop-box manipulation: The card overlays the crop geometry on the actual object-fit image. Drag the box or its edges/corners to update x/y/width/height; numeric controls and presets remain synchronized.
Steps
- Connect the source image.
- Choose Free for independent bounds or select an aspect preset.
- Move Left and Top to position the crop origin.
- Reduce Width and, in Free mode, Height to frame the subject.
- Check that important content is not clipped at the target platform ratio.
- Use Image Output in the next node.
- Choose a preset or free crop, then drag the overlay and handles directly on the image before inspecting the resulting dimensions.
Inputs
- Image / image_in — one source image.
Outputs
- Image Output / image_out — the cropped raster.
Controls
- Aspect: Free, Square 1:1, Wide 16:9, Portrait 4:5, Story 9:16.
- Left and Top: 0–1 shares of the source.
- Width: 0.01–1 share.
- Height: 0.01–1 share in Free mode.
Important behavior
- Aspect presets derive height from the chosen ratio, so the Free Height control is hidden/ignored.
- The crop rectangle is resolved against real source dimensions and kept inside the canvas.
- Values are proportional, making one recipe reusable across similarly framed images of different pixel sizes.
MCP authoring
- Create with create_node { type: "imageCrop" }.
- Connect exact handles with connect_nodes when the node has more than one input or output.
- Use set_props with the complete opParams bag and let the open Flowgen client preview/save it; there is no normal run_node step.
Crop controls and presets
- Add path: Flowgen → Add → Image & Vector → Adjust → Crop.
- Card: PureOpNode.
- Properties: Card-owned operation controls; common properties shell.
- Controls: Free; 1:1; 16:9; 4:5; 9:16; Left; Top; Width; Height.
- Opened surfaces: Live image preview.
Geometry behavior
Hit testing is measured against the displayed picture rather than the full card, so letterbox bars do not shift the crop. The same persisted opParams drive overlay, sidebar, live preview, and output.
Tips
- Use 9:16 for stories/vertical video references, 4:5 for portrait feed assets, and 16:9 for wide frames.
- Crop before expensive generation/editing when the model should see only the intended subject.
Limitations and important notes
- This card uses numeric bounds rather than an interactive crop overlay.
- Aspect presets anchor from the current Left/Top and available bounds; they do not perform content-aware reframing.
Troubleshooting
Changing Height has no effect
Height is intentionally ignored while an aspect preset is selected. Switch Aspect to Free.
FAQ
Does this open the full Image Editor?
No. This is a focused Flowgen node. Use Image Editor when you need layers, selections, paint, paths, or several edits in one document.
Can I use it in a List iteration?
Yes. Wire the current row field into the typed input, collect the exact output handle, and test one row before scaling the run.