camera - 摄像头#

已适配 Air105

备注

本页文档由这个文件自动生成。如有错误,请提交issue或帮忙修改后pr,谢谢!

小技巧

本库有专属demo,点此链接查看camera的demo例子

camera.init(InitReg)#

初始化摄像头

参数

传入值类型

解释

table

InitReg camera初始化命令 见demo/camera/AIR105 注意:如扫码 camera初始化时需设置为灰度输出

返回值

返回值类型

解释

int

camera_id

例子

camera_id = camera.init(GC032A_InitReg)--屏幕输出rgb图像
--初始化后需要start才开始输出/扫码
camera.start(camera_id)--开始指定的camera

camera.on(id, event, func)#

注册摄像头事件回调

参数

传入值类型

解释

int

camera id, camera 0写0, camera 1写1

string

事件名称

function

回调方法

返回值

返回值类型

解释

nil

无返回值

例子

camera.on(0, "scanned", function(id, str)
--id int camera id
--str 多种类型 false 摄像头没有正常工作,true 拍照模式下拍照成功并保存完成, int 原始数据模式下本次返回的数据大小, string 扫码模式下扫码成功后的解码值
    print(id, str)
end)

camera.start(id)#

开始指定的camera

参数

传入值类型

解释

int

camera id,例如0

返回值

返回值类型

解释

boolean

成功返回true,否则返回false

例子

camera.start(0)

camera.stop(id)#

停止指定的camera

参数

传入值类型

解释

int

camera id,例如0

返回值

返回值类型

解释

boolean

成功返回true,否则返回false

例子

camera.stop(0)

camera.close(id)#

关闭指定的camera,释放相应的IO资源

参数

传入值类型

解释

int

camera id,例如0

返回值

返回值类型

解释

boolean

成功返回true,否则返回false

例子

camera.close(0)

camera.capture(id, save_path, quality)#

camera拍照

参数

传入值类型

解释

int

camera id,例如0

string

save_path,文件保存路径,空则写在上次路径里,默认是/capture.jpg

int

quality, jpeg压缩质量,1最差,占用空间小,3最高,占用空间最大而且费时间,默认1

返回值

返回值类型

解释

boolean

成功返回true,否则返回false

例子

camera.capture(0)

camera.video(id, w, h, out_path)#

camera输出视频流到USB

参数

传入值类型

解释

int

camera id,例如0

int

宽度

int

高度

int

输出路径,目前只能用虚拟串口0

返回值

返回值类型

解释

boolean

成功返回true,否则返回false

例子

camera.video(0, 320, 240, uart.VUART_0)

camera.startRaw(id, w, h, buff)#

启动camera输出原始数据到用户的zbuff缓存区,输出1fps后会停止,并通过camera.on设置的回调函数回调接收到的长度,如果需要再次输出,请调用camera.getRaw

参数

传入值类型

解释

int

camera id,例如0

int

宽度

int

高度

zbuff

用于存放数据的缓存区,大小必须不小于w X h X 2 byte

返回值

返回值类型

解释

boolean

成功返回true,否则返回false

例子

camera.startRaw(0, 320, 240, buff)

camera.getRaw(id)#

再次启动camera输出原始数据到用户的zbuff缓存区,输出1fps后会停止,并通过camera.on设置的回调函数回调接收到的长度,如果需要再次输出,请继续调用本API

参数

传入值类型

解释

int

camera id,例如0

返回值

返回值类型

解释

boolean

成功返回true,否则返回false

例子

camera.getRaw(0)