Portrait Auto Cropping

Automatically crops the image based on detected face position and configurable aspect ratio, headroom, and portrait mode.

Requires: Face Detection for modes 1 and 2 — enabled automatically.

Example

Before

After

Parameters

Parameter	Section	Value	Default	Description
CropMode	AutoCrop	0 – 2	0	Mode selection (see below)
AspectWidth	AutoCrop	Float	1.0	Target aspect ratio width
AspectHeight	AutoCrop	Float	1.0	Target aspect ratio height
Headroom	AutoCrop	Float	0.106	General headroom
HeadroomLeft	AutoCrop	Float	0.106	Left-side headroom
PortraitMode	AutoCrop	0 – 2	2	Portrait cropping mode (largest face / all / auto)
CropModeHeadroom	AutoCrop	0, 1	0	Headroom alignment (centre / left)

Modes

Value	Description
0 — Manual	Uses the configured aspect ratio and headroom values without face-based adjustment
1 — Automatic	Crops to the dominant detected face using the configured aspect ratio and headroom
2 — Group	Crops to include all detected faces (for group portraits)

For the full AutoCrop parameter set, see the Parameter Reference → AutoCrop.

Recommended: Use Mode 1 for single-subject portraits and Mode 2 for group shots. Set AspectWidth/AspectHeight to your output ratio; the default headroom (0.106) suits most headshots.