lib_uvc.h

浏览该文件的文档.

#ifndef LINUX_LIBV2_SOURCE_USB_CAMERA_LIB_UVC_H_
#define LINUX_LIBV2_SOURCE_USB_CAMERA_LIB_UVC_H_


struct uvc_struct_camera_data
{
    int width;
    int high;
    int fps;
    int format;
};

struct uvc_struct_videobuffer
{
    unsigned char *start;
    size_t offset;
    unsigned int length;
};

struct uvc_struct_v4l_args
{
    const char *name;
    int v4l2_fd;
    int in_width;
    int in_height;
    int width;
    int height;
    int sizeimage;
    int top;
    int left;
    int rotate;
    int cap_fmt;
    int camera_framerate;
    int capture_mode;
    int usb_camera;
    struct uvc_struct_videobuffer buffers[4];
    unsigned int buf_count;
    int buf_index;
};

struct uvc_struct_Attributes
{
    int isError;
    unsigned char driverName[16];
    unsigned char cardName[32];
    unsigned char bus_info[32];
    char version[10];
};

struct uvc_struct_format
{
    char format[32];
};
#ifdef __cplusplus
#define UVC_API extern "C"
#else
#define UVC_API
#endif

    UVC_API int camera_test();

    UVC_API int uvc_init(char *dev_name, int width, int high, int fps, void **buff);
    /*
 * 描述：初始化摄像头
 * 参数：char *dev_name//设备文件名
        int width//宽
        int high//高
        int fps//帧率
        void** buff
 * 返回值：成功：设备文件
 *        失败：-1：打开设备文件失败
 *        失败：-2：设置数据流参数失败
 *        失败：-3：设置视频的制式和帧格式
 *        失败：-4：内存申请失败
 *        失败：-5：查询申请到的内存失败
 *        失败：-6：将空闲的内存加入可捕获视频的队列失败
 *        失败：-7：打开视频流失败
 *        失败：-99：参数错误
 */

    UVC_API int uvc_check(char *dev);
    /*
 * 描述：检测摄像头是否存在
 * 参数：index用于检测第几个摄像头，从0开始,对应video0~x
 *返回值：存在返回0，不存在返回-1 参数错误返回-99
 *
*/

    UVC_API int uvc_args(int fd, int *width, int *high);
    /*
 * 描述：获取设备可支持的图像尺寸
 * 参数：int fd//设备文件(uvc_init的返回值),int width(用于存放设备当前分辨率的宽),int high(用于存放设备当前分辨率的高)
 * 返回值：成功：0
 *        失败：-1：获取失败
 *        失败：-98：未初始化
 *        失败：-99：参数错误
*/

    UVC_API int uvc_format(int fd, struct uvc_struct_format **);
    /*
 * 描述：获取设备可支持的格式
 * 参数：int fd//设备文件(uvc_init的返回值),struct uvc_format**(用于存放设备可支持的格式)
 * 返回值：成功：int（可支持设备格式的数量）
 *        失败：-98：未初始化
 *        失败：-99：参数错误
*/

    UVC_API struct uvc_struct_Attributes uvc_Attributes(int fd);
    /*
 * 描述：查询设备属性
 * 参数：int fd//设备文件(uvc_init的返回值)
 * 返回值：成功：uvc_Attributes结构体
 *             uvc_Attributes.driverName[16]//驱动模块的名字
 *             uvc_Attributes.cardName[32]//设备名字
 *             uvc_Attributes.bus_info[32]//总线信息
 *             uvc_Attributes.verison[10]//内核版本
 *        失败：查询失败,结构体uvc_Attributes所有值均为error(-1)
 *        失败：未初始化,结构体uvc_Attributes所有值均为error(-98)
 *        失败：参数错误,结构体uvc_Attributes所有值均为error(-99)
 */

    UVC_API int uvc_capturing(int fd);
    /*
 * 描述：将已经捕获好视频的内存拉出已捕获视频的队列
 * 参数：int fd//设备文件(uvc_init的返回值)
 * 返回值：int 索引值:成功：大于0
 *                  失败：-1
 *                  失败：-98：未初始化
 *                  失败：-99：参数错误
 */

    UVC_API int uvc_release(int fd, int index);
    /*
 * 描述：将空闲的内存加入可捕获视频的队列
 * 参数：int fd//设备文件(uvc_init的返回值)
 *      int index//索引值(uvc_capturing的返回值)
 * 返回值：int 成功：0
 *            失败：-1
 *            失败：-98：未初始化
 *            失败：-99：参数错误
*/

    UVC_API int uvc_close(int fd, void **buff);
/*
 * 描述：关闭摄像头
 * 参数：int fd//设备文件(uvc_init的返回值),void **buff(与初始化函数uvc_init调用同一个)
 * 返回值：成功：0
 *        失败：-1 关闭失败
 *        失败：-2：查询申请到的内存失败
 *        失败：-98：未初始化
 *        失败：-99：参数错误
*/

#endif