Overview

The Crop & Warp node lets you crop and transform a video.

Inputs & Outputs

Inputs : 1, Media Format : Raw Video
Outputs : 1, Media Format: Raw Video
Output Metadata : None

Pipeline usage

Define exactly one four-point ROI around the surface to extract. crop takes its bounding region without correcting perspective, while the crop_warp modes straighten the quadrilateral. Place Warp before downstream analytics when they should inspect only the corrected view, and configure their ROIs against the warped output. area interpolation is generally suitable for downscaling; bicubic is the default and is generally preferable for enlargement or perspective correction where visual smoothness matters.

Properties

Property	Description	Type	Default	Required
`roi_labels`	Regions of interest labels	`string`	—	No
`rois`	Specify a single ROI with 4 points to crop/warp the image to. Conditional on `roi_labels`. Format: comma-separated normalized `x,y` coordinate pairs; separate multiple polygons with semicolons (for example, `0.1,0.1,0.9,0.1,0.9,0.9`).	`string`	`null`	No
`mode`	Mode. Options: Disable (`disable`): Disable transform; Crop (`crop`): Crop to specified ROI without changing the perspective; Crop and Warp (`crop_warp`): Crop to specified ROI and straighten the perspective; Crop and Warp, Aspect aware (`crop_warp_aspect`): Crop to specified ROI and straighten the perspective with aspect awareness.	`enum`	`crop`	No
`interpolation_mode`	Interpolation mode. Options: Nearest (`nearest`); BiLinear (`bilinear`); BiCubic (`bicubic`); Area (`area`).	`enum`	`bicubic`	No
`rotate`	Rotate image after crop/warp by the specified angle. Unit: degrees.	`float`	`null`	No
`rotation_mode`	Rotation mode. Options: Rotate and crop to fit (`crop`); Rotate and scale to fit (`scale`).	`enum`	`crop`	No

Output Metadata

Node does not insert any output metadata; upstream metadata continues through the pipeline