摘? 要: 介紹柯達" title="柯達">柯達公司的數碼相機開發套件" title="開發套件">開發套件SDK DC280、SDK的結構及其函數分類,并提供了一個典型的編程實例。
關鍵詞: SDK? 數碼相機? 開發
?
數碼相機作為一種目前常見的消費類商品,其基本工作原理是利用CCD光耦器件將光信號轉變為電信號,經過A/D轉換、數據壓縮等處理后經串口或USB口在PC端應用程序" title="應用程序">應用程序控制下將圖片(多為JPEG格式)傳送到PC機的硬盤中。目前PC端的應用程序都由相機制造商所提供。很少有人注意到一些數碼相機制造商為開發人員提供了相對豐富的SDK(Software Development Kit)資源,便于有關人員利用數碼相機進行圖像采集和監測方面的開發工作。SDK開發套件一般由頭文件(.H)、庫文件(.lib)和動態鏈接庫文件(.dll)組成。美國柯達公司是世界相機制造業和諸多影像標準制定的帶頭兵。本文將以KODAK DC280 SDK為例對SDK及其應用作介紹,以使感興趣的開發人員可以自編程序將數碼相機應用在工程項目中。
1 SDK結構圖
DC280 SDK原理框圖如圖1所示。SDK控制層位于應用程序與指定SDK控制層(對于DC280相機此層為DC280SDK控制層)之間,它的主要作用是接收應用程序的DC280_OpenCamera()指令,同時將指定相機SDK控制層調入內存區;接收DC2x0_CloseCamera()指令,同時釋放指定相機SDK控制層所占內存區。指定相機SDK層位于SDK控制層下,本層支持所有訪問相機的函數，并將函數執行結果狀態碼(即錯誤代碼)經SDK控制層上傳給應用程序。指定相機控制層的下層為驅動程序層。驅動程序用于與外部設備直接打交道。
?
?
2 SDK函數分類
SDK內的函數按照作用類型一般可以分為以下幾類:
(1)相機初始化函數:主要包括_CloseCamera()和_OpenCamera()。
(2)相機控制函數: 主要包括_GetStatus()、_GetConfig()、_SetConfig()、_ControlCameraTime()、_ControlCa-
meraID()、_ControlTakePicture()、_ResetCamera()。
(3)圖片管理函數:_TakePicture()、_DeletePicture()。
(4)圖片信息獲取函數:_GetCameraPictInfo()、_Get-AllPictureName()、_GetNativePicture( )。
(5)文件傳遞函數" title="傳遞函數">傳遞函數:_GetFileFromCamera()、_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開發工具" title="開發工具">開發工具 對SDK及利用它開發相機應用程序進行了簡單介紹。其他公司SDK的使用方法基本類似,只是函數名稱略有不同,使用方法是一致的。SDK中函數及其參數的詳細說明,可以在相機制造商的英文網站上從開發工具一覽中找到。
?
參考文獻
1 Kodak DC280 Camera Software Development Kit Library Reference Manual. Version 0.71.1999；(6)