Auto Crop

Detect and remove video letterbox.

<?xml version="1.0"?>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "[Action]",
        "format": {
            "auto_crop": {
                "enable": "[yes|no]",
                "crop_type": "[CropType]",
                "limit": "[Detection]",
                "round": "[CropRound]"
ParameterDescriptionAllowed ValuesDefault Value
enableEnable auto-cropping.yes, nono
crop_typeSpecify cropping type.resize - crop letterbox, then crop to keep width/height ratio then re-scaling to fit output size.
stretch - crop letterbox, then re-scaling without saving of width/heigth ratio to fit output size
crop - only letterbox cropping
limitHigher black value threshold.Positive integer number from 0 to 128. Value greater than 128 will be changed to 128.

0 – Pixel must be absolutely black to be classified as black.

128 – The lightest pixels would be classified as black.
roundThe value which the width/height should be divisible by.Positive integer number.16


Note for crop_type

If <crop_type /> set to crop and specified for output then video will be re-scaled as though <crop_type /> was set to stretch.



Auto cropping will be ignored if <crop_* /> parameters are specified.