




版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
1、显微科技图像系列工业相机开目录档1234概述3文件3开发工具3应用程序的发布45 API 说明45.1定义说明4函数功能说明6相机控制6函数CameraInit6函数CameraUnInit6函数CameraPlay6函数CameraStop7函数CameraCaptureFile7函数CameraCaptureToBuf7函数RecordAviStart7函数RecordAviStop7相机功能8函数CameraGetImageSize8函数CameraSetAeSe8函数CameraGetAeSe8函数CameraSetAWBS函数CameraGetAWBS函数CameraSetAe函数C
2、ameraGetAee8e8.9. 9函数CameraSetEx函数CameraGetEx函数 CameraSet函数 CameraGetureTime9ureTime9ogGain9ogGain10函数CameraSetGain10函数CameraGetGain10函数CameraSetGamma10函数CameraGetGamma10函数CameraSetSaturation11函数CameraGetSaturation11函数CameraSetContrast11函数CameraGetContrast11函数CameraSetMirror11函数CameraSetMonochrome12
3、函数CameraGetMonochrome12函数 CameraSetFrameSpeed12函数 CameraGetFrameSpeed12函数 CameraSetLightFrquency12函数 CameraGetLightFrquency13函数 CameraRearameter13函数 CameraGetCurrentParameterTeam13函数CameraGetRowTime131 概述在的32位Windows操作系统中,数字头应用接口库直接操作数字头,并提供给用户一个简单明确的应用接口。用户在编制自己的应用程序时,可以直接调用这些库函数来实现指定的功能。数字头工作流程如下开
4、始(初始化指定设备申请资源)参数设置(增益等)图像到内存(停止)结束(其资源)一般情况下,头的开始操作和初始化参数的设置,最好在用户应用程序的初始化中完成,头的结束操作应在应用程序退出前执行。本版D-IMAGE SDK 支持所有 CMOS 数字头。2 文件数据类型定义头文件:DIDefine.h函数库头文件:DICAMSDK.h库:DICAMSDK.dll库:DICAMSDK.lib动态静态3 开发工具应用接口库支持 32 位编程开发工具Visual C/C+、VisualBasic、 BorlandC/C+、 Delphi、 C+ Buildower Builder 等。使用C/C+编程工具
5、用户应在程序中调用相关的包含文件(.h.),并将静态库(.lib )文件加入到工程文件中,供编译程序在(Link )时使用。需明的是,MS-Visual C/C+和 C+Builder 定义了各自的静态库的文件格式,它们之间是不通用的。使用MS-Visual Basic、 Delphi、er Builder 等编程工具调用应用接口库时,应按照调用动态链接库的方法,在程序中重新函数原型,这时要注意正确定义参数的数据类型4 应用程序的发布发布数字机的应用程序。首先,安装机的设备驱动程序(安装步骤可参见安装数字机设备驱动程序说明),并确认安装成功;然后,将要发布的应用程序安装到相应的工作目录。这样,
6、应用程序就可以运行了。如果需要将驱动程序与二次开发的应用程序安装盘一并发布,请将随卡的驱动程序光盘或软盘中,相应操作系统目录下的驱动程序拷贝到准备发布的安装盘上即可5 API 说明数字数的原型头应用接口库包括数字头的控制、图像到内存、错误处理、其它功能等功能。函在包含文件 DICAMSDK.H,动态库 DICAMSDK.dll,静态库DICAMSDK.lib。5.1 定义说明typedef enum tagDI_RUNMODERUNMODE_PLAY=0, RUNMODE_PAUSE, RUNMODE_STOP,DI_RUNMODE;相机运行状态typedef enum tagDI_CAMER
7、A_SUS _stdcallS S S SUS_OK = 1,/动作成功US_ERNAL_ERROR = 0,/错误US_NO_DEVICE_FIND = -1,/没有发现相机US_NOT_ENOUGH_SYSTEM_MEMORY = -2,/没有足够系统内存S S S S SUS_HW_IO_ERROR = -3,US_PARAMETER_INVALID = -4,US_PARAMETER_OUT_OF_BOUND = -5,US_FILE_CREATE_ERROR = -6,/硬件 IO 错误/参数无效/参数越界/创建文件失败US_FILE_INVALID = -7,/文件格式无效DI_C
8、AMERA_S函数调用返回状态US _stdcall;typedef enum tagDI_MIRROR_DIRECTIONMIRROR_DIRECTION_HORIZONTAL = 0,MIRROR_DIRECTION_VERTICAL = 1,DI_MIRROR_DIRECTION;图像翻转方向typedef enum tagDI_FRAME_SPEEDFRAME_SPEED_NORMAL = 0,FRAME_SPEED_HIGH = 1,FRAME_SPEED_SUPER = 2, FRAME_SPEED_SUPER2,DI_FRAME_SPEED;相机工作速度typedef enum
9、tagDI_FILE_TYPEFILE_JPG = 1,FILE_BMP = 2,FILE_RAW = 4,FILE_PNG = 8,DI_FILE_TYPE;文件类型定义typedef enum tagDI_DATA_TYPEDATA_TYPE_RAW = 0,DATA_TYPE_RGB24 = 1,DI_DATA_TYPE;图像数据类型定义typedef enum tagDI_SNAP_MODE SNAP_MODE_CONTINUATION SNAP_MODE_SOFT_TRIGGER= 0,= 1,SNAP_MODE_EXTERNAL_TRIGGER DI_SNAP_MODE;相机触发模
10、式定义typedef enum tagDI_LIGHT_FREQUENCY LIGHT_FREQUENCY_50HZ = 0,LIGHT_FREQUENCY_60HZ = 1,= 2,/externalDI_LIGHT_FREQUENCY;光源频率选择typedef enum tagDI_PARAMETER_TEAM PARAMETER_TEAM_A = 0,PARAMETER_TEAM_B = 1,PARAMETER_TEAM_C = 2,PARAMETER_TEAM_D = 3,DI_PARAMETER_TEAM;参数保存组别定义typedef enum tagDI_B2RGB_MODEB
11、2RGB_MODE_LINE= 0,B2RGB_MODE_HAMILTON = 1,B2RGB_MODE_LAROCHE= 2,B2RGB_MODE_DIRECTLY = 3,DI_B2RGB_MODE;色彩空间转换算法定义typedef enum tagDI_CAMERA_MSGCAMERA_MSG_= 0,CAMERA_MSG_AVI = 1,DI_CAMERA_MSG;相机消息定义typedef enum tagDI_RECORDMODERECORDMODE_START=0, RECORDMODE_STOP,tagDI_RECORDMODE;AVItypedef状态定义(CALLBACK
12、* DI_SNAP_PROC)(BYTE*pImageBuffer, DI_DATA_TYPE TYPE, LPVOIDlpContext);回调函数的图像到内存中时由 SDK 调用;用户;回调函数的函数体由用户编写,在可以在此函数中编写自己的程序例如图像处理,控制等等。回调函数参数:BYTE *pImageBuffer 图像数据指针;DI_DATA_TYPE TYPE 图像数据类型,SDK到一帧图像后,正常情况会调用两次回调函数,一次数据类型为DATA_TYPE_RAW(原始数据),第二次为 DATA_TYPE_RGB24(处理后的 RGB24 数据);LPVOID lpContext 加调
13、函数调用的上下文。5.2 函数功能说明5.2.1 相机控制函数 CameraInit原型:DI_A BYTE CamNum,I_CAMERA_SUS _stdcall CameraInit(DI_RESOLUTION uiResolution,HWND hWndDisplay, DI_SNAP_PROC pCallbackFunction,LPVOID lpContext);功能: 初始化设备参数: CamNum 相机(当有多台同类型相机同时接入电脑时,按相机接入顺序依次编码 1,2,3)uiResolution hWndDisplay度索引显示控件句柄(不需显示窗口时请传NULL)pCall
14、backFunction 回调函数指针(不用时传 NULL) lpContext 回调函数上下文参数返回值: 调用成功返回S说明: 初始化机像处理,控制程序US_OK 否则返回错误代码图像到内存的控制指定回调函数,用户可以在回调函数中编写自己的程序例如图函数 CameraUnInit原型:DI_AI_CAMERA_SUS _stdcall CameraUnInit(void);功能: 反初始化设备参数:返回值: 调用成功返回SUS_OK 否则返回错误代码说明: 必须在程序退出时调用,用于内存分配空间函数 CameraPlay原型:DI_A功能: 打开参数:I_CAMERA_S流US _stdc
15、all CameraPlay(void);返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 C原型:DI_A功能: 停止参数:I_CAMERA_S流US _stdcall CameraStop(void);返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraCaptureFile原型:DI_AI_CAMERA_SUS _stdcall CameraCaptureFile(IN LPCTSTRstrFileName, IN DS_FILE_TYPE FileType);功能:一帧图像到文件,文件格式会根据 FileType 设定改变参数: strFileNa
16、me 文件名(包括目录路径)FileType 文件类型,具体参 FILE_TYPE 定义返回值: 调用成功返回SUS_OK 否则返回错误代码说明: 当流停止时会保存最后一幅图像函数 CameraCaptureToBuf原型:DI_AI_CAMERA_SUS _stdcall CameraCaptureToBuf(BYTE* pBuffer, DI_DATA_TYPE Type);功能:图像数据到用户分配内存参数: pBuffer 用户分配内存首地址Type 数据类型(参考 DI_DATA_TYPE)返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 RecordAviStart原型
17、:DI_A功能:I_CAMERA_SUS _stdcall RecordAviStart(CStringcsFileName);参数: csFileName 文件名,包括路径(D:TEST.AVI)返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 RecordAviStop原型:DI_A功能: 停止参数:I_CAMERA_SUS _stdcall RecordAviStop(void);返回值: 调用成功返回SUS_OK 否则返回错误代码说明:5.2.2 相机功能函数 CameraGetImageSize原型:DI_A*pHeight)I_CAMERA_SUS _stdcall
18、CameraGetImageSize(*pWidth,功能:单前图像大小参数: *pWidth 图像宽度的指针*pHeight 图像高度的指针返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraSetAeSe原型:DI_A bSe);I_CAMERA_SUS _stdcall CameraSetAeSe(IN BOOL功能:设置自动状态。参数:BOOL bSe返回值:调用成功返回S说明:US_OK 否则返回错误代码函数 CameraGetAeSe原型:DI_A*pAeSe);功能:I_CAMERA_SUS _stdcall CameraGetAeSe(BOOL模式参数:
19、BOOL *pAeSe返回值:调用成功返回S说明:US_OK 否则返回错误代码函数 CameraSetAWBSe原型:DI_A bAWBSe);I_CAMERA_SUS _stdcall CameraSetAWBSe(BOOL功能:设置白平衡模式参数: bAWBSe - TRUE 自动白平衡- FALSE 手动白平衡返回值:调用成功返回SUS_OK 否则返回错误代码说明:函数 CameraGetAWBSe原型:DI_A*pAWBSe);I_CAMERA_SUS _stdcall CameraGetAWBSe(BOOL功能:白平衡模式参数: *pAWBSe 存放状态指针返回值:调用成功返回S说明
20、:US_OK 否则返回错误代码函数 CameraSetAe原型:DI_AI_CAMERA_SUS _stdcall CameraSetAe(IN BYTEuiAe);功能: 设定自动目标值参数: uiAe-自动目标值返回值:说明:调用成功返回SUS_OK 否则返回错误代码函数 CameraGetAe原型:DI_A BYTE *pAeI_CAMERA_S);目标值US _stdcall CameraGetAe(IN OUT功能:参数: *pAe自动-存放目标值指针US_OK 否则返回错误代码返回值: 调用成功返回S说明:函数 CameraSetExureTime原型:DI_AI_CAMERA_S
21、US _stdcall CameraSetExureTime(INuiExureTime);功能:设定时间参数: uiExureTime -时间US_OK 否则返回错误代码返回值: 调用成功返回S说明:函数 CameraGetExureTime.原型:DI_AI_CAMERA_SUS _stdcall CameraGetExureTime(IN*pEx功能:ureTime);时间参数: *pExureTime -存放时间指针US_OK 否则返回错误代码返回值: 调用成功返回S说明:函数 CameraSetogGain原型:DI_A usogGain);功能: 设定增益I_CAMERA_SUS
22、_stdcall CameraSetogGain(IN USHORT参数: usogGain 增益返回值: 调用成功返回S说明:US_OK 否则返回错误代码CameraGetogGain函数原型:DI_AI_CAMERA_S*pogGain);功能: 设定增益US _stdcall CameraGetogGain(IN USHORT参数: *pogGain 存放增益指针返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraSetGain原型:DI_AI_CAMERA_SUS _stdcall CameraSetGain(IN USHORTRGain, USHORT GGa
23、in, USHORT BGain);功能: 设定各色彩通道的增益参数: RGain 红通道增益 GGain 绿通道增益BGain 蓝通道增益返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 Ca原型:DI_A*pGGain,I_CAMERA_S*pBGain);US _stdcall CameraGetGain(IN*pRGain,功能:各色彩通道的增益参数: *pRGain 存放红通道增益指针*pGGain 存放绿通道增益指针*pBGain 存放蓝通道增益指针返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraSetGamma原型:DI_A uiGamm
24、a);I_CAMERA_SUS _stdcall CameraSetGamma(IN BYTE功能: 设定GAMMA参数: uiGamma返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraGetGamma原型:DI_A*pGamma);I_CAMERA_SUS _stdcall CameraGetGamma(IN BYTE功能:GAMMA参数: *pGamma 存放GAMMA 的指针返回值: 调用成功返回SUS_OK 否则返回错误代码说明:函数 CameraSetSaturation原型:DI_A uiSaturation);I_CAMERA_SUS _stdcall
25、 CameraSetSaturation(IN BYTE功能: 设定饱和度参数: uiSaturation返回值: 调用成功返回SUS_OK 否则返回错误代码说明:函数 CameraGetSaturation原型:DI_A*pSaturation);I_CAMERA_SUS _stdcall CameraGetSaturation(IN BYTE功能:饱和度参数: *pSaturation 存放饱和度的指针返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraSetContrast原型:DI_A uiContrast);I_CAMERA_SUS _stdcall Came
26、raSetContrast(IN BYTE功能: 设定对比度参数: uiContrast返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraGetContrast原型:DI_A*pContrast);I_CAMERA_SUS _stdcall CameraGetContrast(IN BYTE功能:对比度参数: *pContrast返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraSetMirror原型:DI_AI_CAMERA_SUS _stdcall CameraSetMirror(INDS_MIRROR_DIRECTION uiDir,
27、IN BOOL bEnable);参数:DS_MIRROR_DIRECTION uiDir IN BOOL bEnable返回值:调用成功返回S说明US_OK 否则返回错误代码函数 CameraSetMonochrome原型:DI_A bEnable);功能: 设定单色I_CAMERA_SUS _stdcall CameraSetMonochrome(IN BOOL参数: bEnable - TRUE- FALSE 取消单色返回值: 调用成功返回S说明:单色US_OK 否则返回错误代码函数 CameraGetMonochrome原型:DI_A*pEnable);I_CAMERA_SUS _st
28、dcall CameraGetMonochrome(IN BOOL功能:色彩设定参数: *pEnable 存放状态指针返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraSetFrameSpeed原型:DI_AI_CAMERA_SUS _stdcall CameraSetFrameSpeed(INDS_FRAME_SPEED FrameSpeed);功能: 设定帧率参数: FrameSpeed 帧率索引,具体定义参 DS_FRAME_SPEED返回值: 调用成功返回S说明:US_OK 否则返回错误代码CameraGetFrameSpeed函数原型:DI_AI_CAMERA_S*pFrameSpeed);功能: 设定帧率US _stdcall CameraGetFrameSpeed(IN BYTE参数: FrameSpeed 帧率索引,具体定义参 DS_FRAME_SPEED返回值: 调用成功返回S说明:US_OK 否则返回错误代码函数 CameraSetLightFrquency原型:DI_AI_CAMERA_SUS _stdcall CameraSetLightFrquency(INDS_LIGHT_F
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 药物输注过程中的安全隐患防范
- 静脉穿刺操作的无菌安全护理
- 市场营销实务说课课件
- 工造朱俊文管理课件
- 工程问题课件复习
- 工程课程的课件制作
- 二零二五年度城乡一体化发展内部承包施工合同
- 疫情复课开学班会课件
- 社区物业服务委托协议
- 遥感技术农业信息管理系统合同
- 结肠癌根治手术配合创意
- 消杀消毒培训课件
- 汽车连接器标准QCT1067解析
- 基于大语言模型和事件融合的电信诈骗事件风险分析
- 消化道穿孔护理
- 维生素D缺乏症患儿的护理课件
- 《1 例慢性肾功能衰竭患者急性上消化道出血的护理体会》
- 《MATLAB编程及应用》全套教学课件
- 二零二四年度生物医药实验室建设合同
- 加油站事故隐患排查清单(主要负责人级)
- 金螳螂新员工培训
评论
0/150
提交评论