Crop Gravity

Steers where the crop window lands when fit=crop is used. By default fit=crop keeps the center of the frame; crop lets you anchor to an edge, a corner, or an arbitrary focal point instead.

crop accepts one vertical token (top/middle/bottom), one horizontal token (left/center/right), or both combined. Tokens are order-independent — top,left and left,top are identical. An unspecified axis stays centered, so crop=top is shorthand for crop=top,center.

For sub-pixel precision, set crop=focalpoint and provide fp-x and fp-y as fractions of the frame.

If the same axis is specified twice (e.g. crop=left,right), the last token wins.

crop is only honored under fit=crop (including the video-center-crop=true alias). It is ignored for other fit modes. The crop window size — and thus the output dimensions — is the same as a center crop; only the position changes.