setPictureCrop.lua
[返回首页]

API说明

设置视频后级(编码)图像裁切参数

后级图像裁切,是相对于前级裁切(参考 getSourceCrop.lua / setSourceCrop.lua)而言的。后级图像裁切对KILOVIEW全系列编码器产品适用。

后级图像裁切,是在视频即将进行编码时,可以对经过前级处理后的图像(对于G/M系列产品)或直接输入的图像(对于U系列产品)进行裁切,从而实现局部感兴趣区域的编码。如果对于G/M系列产品,这也许和前级裁切功能有所重复,但也可以组合前级裁切完成更高级的图像处理,当然也可以只考虑二者之一的功能开启;对于U系列产品,这是实现图像裁切功能的手段。

参数

HTTP提交参数:POST

通过HTTP测试该API调用 (URL):

Enable
整数

0|1。可选。0表示关闭裁切;1表示打开裁切

测试值:

Left
数值

可选。裁切位置的左边起始位置(Pixel)

测试值:

Top
数值

可选。裁切位置的顶部起始位置(Line)

测试值:

Width
数值

可选。裁切的画面宽度(Pixel)

测试值:

Height
数值

可选。裁切的画面高度(Line)

测试值:

返回

返回JSON格式的结果。该JSON数据的格式如下:

{
/*对象*/

"Result":
数值

200表示OK, 其它错误码含义类似于HTTP Response.

"Status":
"字符串"

状态消息。反馈API执行的结果状态,如有错误,将描述出错的原因。

}

说明

1. 如果裁切的起始位置(Left,Top)超出实际画面的有效大小,将产生不可预估的结果;

2. 如果起始位置加指定的宽度/高度超出实际画面的有效大小,实际裁切的宽度/高度将自动进行调整以适应实际画面大小。

3. 最终画面进行裁切时,Left/Width的值将以4像素为倍数进行近似约束,Top/Height的值将以2行为倍数进行近似约束,所以实际裁切的大小与指定的大小可能存在细微出入,请注意。

其它说明

Device HTTP API, v1.0