<?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]"
}
}
}| Parameter | Description | Allowed Values | Default Values |
|---|---|---|---|
| crop_top | Specify the top crop band size in pixels. | Positive integer | None |
| crop_right | Specify the right crop band size in pixels. | Positive integer | None |
| crop_bottom | Specify the bottom crop band size in pixels. | Positive integer | None |
| crop_left | Specify the left crop band size in pixels. | Positive integer | None |
| crop_vbi | Crop the top 32 lines of vertical blanking (VBI) from 720x608 and 720x512 sources, leaving 720x576 and 720x480. Other sources are not changed. | yes, no | no |
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.