Background & Cropping

The Background section (replacement, color substitution, balance) and the AutoCrop section (portrait auto-cropping).

Background Handling (Background)

Background replacement, color substitution, and balance.

Parameter	Value	Default	Description
ReplacePath	String	—	Path to a replacement background image
backgroundR	0 – 255	255	Red component for background color replacement
backgroundG	0 – 255	255	Green component for background color replacement
backgroundB	0 – 255	255	Blue component for background color replacement
balanceH	-1.0 – 1.0	0.0	Hue balance adjustment for background
balanceS	-1.0 – 1.0	0.0	Saturation balance adjustment for background
balanceV	-1.0 – 1.0	0.0	Value balance adjustment for background

---

Portrait Auto-Cropping (AutoCrop)

Automatic cropping based on facial detection. See Key Features → Adaptive Auto-Cropping.

Parameter	Value	Default	Description
HeadYawCoeff	Float	0.67	Coefficient for head yaw adjustment
HeadPitchCoeff	Float	0.75	Coefficient for head pitch adjustment
HeadroomFixed	0, 1	1	Use fixed headroom calculation
HeadroomUnit	Integer	0	Headroom unit type
ImageToHeadRatio	Float	0.48	Ratio of image to head size
HeadroomLeft	Float	0.1	Left side headroom
Headroom	Float	0.1	General headroom
CropModeHeadroom	Float	0.0	Headroom for crop mode
AspectHeight	Float	1.0	Target aspect ratio height
AspectWidth	Float	1.0	Target aspect ratio width
PortraitMode	Integer	2	Portrait cropping mode
AdaptAspectRatioToFace	0, 1	1	Adapt aspect ratio based on face detection
AspectRatio	Integer	0	Fixed aspect ratio mode
CropMode	0 – 2	0	Cropping mode (see CropMode values below)

CropMode values

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)