摘要：介绍柯达公司的数码相机开发套件SDK DC280、SDK的结构及其函数分类,并提供了一个典型的编程实例。

    关键词：SDK 数码相机 开发

数码相机作为一种目前常见的消费类商品,其基本工作原理是利用CCD光耦器件将光信号转变为电信号,经过A/D转换、数据压缩等处理后经串口或USB口在PC端应用程序控制下将图片（多为JPEG格式）传送到PC机的硬盘中。目前PC端的应用程序都由相机制造商所提供。很少有人注意到一些数码相机制造商为开发人员提供了相对丰富的SDK（Software Development Kit）资源,便于有关人员利用数码相机进行图像采集和监测方面的开发工作。SDK开发套件一般由头文件（.H）、库文件（.lib）和动态链接库文件（.dll）组成。美国柯达公司是世界相机制造业和诸多影像标准制定的带头兵。本文将以KODAK DC280 SDK为例对SDK及其应用作介绍,以使感兴趣的开发人员可以自编程序将数据相机应用在工程项目中。

1 SDK结构图

DC280 SDK原理框图如图1所示。SDK控制层位于应用程序与指定SDK控制层（对于DS280相机此层为DC280SDK控制层）之间,它的主要作用是接收应用程序的DC280_OpenCamera（）指令,同时将指定相机SDK控制层调入内存区;接收DC2x0_CloseCamera（）指令,同时释放指定相机SDK控制层所占内存区。指定相机SDK层位于SDK控制层下,本层支持所有访问相机的函数,并将函数执行结果状态码（即错误代码）经SDK控制层上传给应用程序。指定相机控制层的下层为驱动程序层。驱动程序用于与外部设备直接打交道。

2 SDK函数分类

SDK内的函数按照作用类型一般可以分为以下几类：

（1）相机初始化函数：主要包括_CloseCamera()和_OpenCamera()。

（2）相机控制函数：主要包括_GetStatus()、_GetConfig()、_SetConfig()、_ControlCameraTime()、_ControlCameraID（）、_ControlTakePicture()、_ResetCamera()。

（3）图片管理函数：_TakePicture()、_ResetCamera()。

（4）图片信息获取函数：_GetCameraPictInfo()、_GetAllPictureName（）、_GetNativePicture（）。

（5）文件传递函数：_GetFileFormCamera()、_SetFileToCamera。

（6）其他类型的函数：包括电池电量数据获取函数、最后一次操作返回码获取函数等。

3 SDK用法的一个典型实例

下面举一个拍摄图片的简单实例使读者大体了解编程的一般模式,其过程如图2所示。首先是相机初始化即打开相机,然后读取目前相机中拍摄方面的参数设置,根据需要修改某些参数设置,接着拍摄图片,最后关闭相机释放内存。例程如下：

    以下为SDK用法的典型例程：

#include "F210.h"

OSErr ret;

DC280_Camera ;Camera;

DC280_ImgProcData ThumbImgInfo;

DC280_TakePictInfo TakePictInfo;

DC280_PictInfo GenericPictInfo;

DC280_SpecificPictInfo SpecificPictInfo;//打开相机

DC280_OpenCamera(VersionData,CameraData); //获取相机设置参数

ret=DC280_ControlTakePicture(&Camera,TRUE,0L,(VOIDPTR &TakePictInfo);

//修改需要变动的参数

ret=DC280_ControlTakePicture(&Camera,FALSE,（VOIDPTR&TakePictInfo）; //拍照

ret=DC280_TakePicture(&Camera,TRUE,&ThumbImgInfo,&GenericPictInfo,(VOIDPTR)&SpecificPictInfo);

//可以根据需要加上文件传递函数等

DC210_CloseCamera(CameraData); //关闭相机

其中DC280_ControlTakePicture的第二个参数为GetSetFlag。当其为true时表示从相机中获取设置参数;为false时表示将改动过的参数输送给相机。DC280_Camera的数据结构如下：

typedef struct {DC210_PortNum PortNum;

DC210_BitRate BitRate;

DC210_CameraType CamType;

BOOL CameraOpenFlag;

VOIDPTR InternalUseOnly;

}DC280_Camera ;

本文通过柯达公司的DC280 SDK开发工具对SDK及利用它开发相机应用程序进行了简单介绍。其他公司SDK的使用方法基本类似,只是函数名称略有不同,使用方法是一致的。SDK中函数及其参数的详细说明,可以在相机制造商的英文网站上从开发工具一览中找到。