add-ioctl.h

gtk实现的图像采集的示例程序。

/*
*   PengJieJun,2003.7.9
*	Copyright大恒图像.
*/

#ifndef __ADD_DH_USER_VID_FUCTION__
#define __ADD_DH_USER_VID_FUCTION__

//#include <linux/videodev.h>
#include "videodev.h"

#if defined(__cplusplus) || defined(c_plusplus)
extern "C"{
#endif

//外部调用的函数,采单幀或者单场时调用的函数，
//函数返回0,调用成功，
//返回-1,调用失败，
//该函数调用同直接调用ioctl(int h_Vid, VIDIOCMCAPTURE, video_mmap*)用法一样，
//只是硬件启动采集的速度更快，但只适用于采集单幀或者单场。
//如果是连续采集，则应该使用ioctl(int h_Vid, VIDIOCMCAPTURE, video_mmap*)
int dh_Add_FastCapOne(int h_dhVid,struct video_mmap* video_map);

//外部调用函数,判断当前源路是否有视频输入
//结果存入src,有视频src为1,无视频src为0
//函数返回0,调用成功
//返回-1,调用失败
int dh_Add_IsVideoOn(int h_dhVid, int* src);

//外部调用的函数,得到采集卡的数目
//卡数赋值给nV
//函数返回0,调用成功
//返回-1,调用失败
int dh_Add_GetVideoNum(int h_dhVid, int *nV);

//外部调用的函数,让硬件处于快速采集方式状态.只需调用一次即可.
//使用限制:
//限制1,调用该函数前,必须停止其它的采集方式,(向屏幕采集,向内存采集),即该函数只是在
//	调用函数dh_Add_FastCapOneField时才使用.调用该函数后约150毫秒,
//	才能调用函数dh_Add_FastCapOneField采集到稳定的图像.
//限制2,使用其它采集方式前(向屏幕采集,向内存采集),必须先调用dh_Add_StopFastCap()关闭快速采集.
//限制3,在改变采图大小,颜色位数等参数的时候,必须先调用dh_Add_StopFastCap()停止快速采集,
//	等参数设置完成后再调用dh_Add_StartFastCap()
//函数参数同dh_Add_FastCapOne()
//函数返回0,调用成功，
//返回-1,调用失败，
int dh_Add_StartFastCap(int h_dhVid,struct video_mmap* video_map);

//外部调用的函数,停止硬件快速采集.
//函数返回0,调用成功，
//返回-1,调用失败，
int dh_Add_StopFastCap(int h_dhVid);

//外部调用的函数,在快速采集一场图像时调用的函数.
//与函数dh_Add_FastCapOne()的区别:
//区别1:	函数dh_Add_FastCapOne()可用于幀和场采集;而函数dh_Add_FastCapOneField()只用于场采集.
//区别2:	调用函数前dh_Add_FastCapOneField()前,必须调用过一次函数dh_Add_StartFastCap(),
//	调用dh_Add_FastCapOne()则无此限制.
//区别3:调用函数dh_Add_FastCapOneField()可以在20~40毫秒内采集到一场图像;
//	函数dh_Add_FastCapOne()可以在40~60毫秒内采集到一场图像;在60~80毫秒内采集到一幀图像;
//函数参数同dh_Add_FastCapOne()
//函数返回0,调用成功，
//返回-1,调用失败，
int dh_Add_FastCapOneField(int h_dhVid,struct video_mmap* video_map);
#if defined(__cplusplus) || defined(c_plusplus)
}
#endif

#endif		//end of define __ADD_DH_USER_VID_FUCTION__