Cropping

Crop the dimensions of your source video.

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <crop_top>[CropTop]</crop_top>
        <crop_right>[CropRight]</crop_right>
        <crop_bottom>[CropBottom]</crop_bottom>
        <crop_left>[CropLeft]</crop_left>
        <crop_vbi>[yes|no]</crop_vbi>
    </format>
</query>
{
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "[Action]",
        "format": {
            "crop_top": "[CropTop]",
            "crop_right": "[CropRight]",
            "crop_bottom": "[CropBottom]",
            "crop_left": "[CropLeft]",
            "crop_vbi": "[yes|no]"
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Values
crop_topSpecify the top crop band size in pixels.Positive integerNone
crop_rightSpecify the right crop band size in pixels.Positive integerNone
crop_bottomSpecify the bottom crop band size in pixels.Positive integerNone
crop_leftSpecify the left crop band size in pixels.Positive integerNone
crop_vbiCrop the top 32 lines of vertical blanking (VBI) from 720x608 and 720x512 sources, leaving 720x576 and 720x480. Other sources are not changed.yes, nono

With crop_vbi, the source aspect ratio applies to the picture left after the VBI lines are cropped, and the other crop, auto_crop, cut_black and size parameters work with that picture: crop_top counts from the first line below the VBI lines. Without a size, the output is the size of the cropped picture and the picture is fitted into it as usual: for example, mp4 output is 720x576 with square pixels and a 4:3 picture letterboxed. crop_vbi is also available for advanced_hls output. It is ignored when the video is copied and can't be used with gif and vp6 outputs and the mainconcept_avc and vp6 video codecs.