/*############################################################################# * 文件名：image.h * 功能：  實現了指紋圖像的基本操作 * modified by  PRTsinghua@hotmail.com#############################################################################*/#if !defined FVS__IMAGE_HEADER__INCLUDED__#define FVS__IMAGE_HEADER__INCLUDED__/* 基本類型定義 */#include "fvstypes.h"/* 對象的這些接口實現是私有的，不必為用戶所知。使用這里提供的函數操作圖像 */typedef FvsHandle_t FvsImage_t;/* 定義圖像屬性 */typedef enum{    FvsImageGray      = 0,	/* 8-bit灰度圖像 */    FvsImageBinarized = 1,	/* 二值化圖像    */    FvsImageThinned   = 2,	/* 細化圖像      */} FvsImageFlag_t;/******************************************************************************  * 功能：創建一個新的圖像對象  * 參數：無  * 返回：失敗返回空，否則返回新的圖像對象******************************************************************************/FvsImage_t ImageCreate(void);/******************************************************************************  * 功能：銷毀一個圖像對象  * 參數：image  指向圖像對象的指針  * 返回：無******************************************************************************/void ImageDestroy(FvsImage_t image);/******************************************************************************  * 功能：設置一個圖像對象的大小  * 參數：image   指向圖像對象的指針  *       width   圖像寬度  *       height  圖像高度  * 返回：錯誤編號******************************************************************************/FvsError_t ImageSetSize(FvsImage_t image, const FvsInt_t width, 							const FvsInt_t height);/******************************************************************************  * 功能：設置圖像標記，該操作大部分由庫函數自動完成  * 參數：image  指向圖像對象的指針  *       flag   標記  * 返回：錯誤編號******************************************************************************/FvsError_t ImageSetFlag(FvsImage_t image, const FvsImageFlag_t flag);/******************************************************************************  * 功能：獲得圖像標記  * 參數：image  指向圖像對象的指針  * 返回：圖像標記******************************************************************************/FvsImageFlag_t ImageGetFlag(const FvsImage_t image);/******************************************************************************  * 功能：拷貝圖像  * 參數：destination  指向目標圖像對象的指針  *       source       指向源圖像對象的指針  * 返回：錯誤編號******************************************************************************/FvsError_t ImageCopy(FvsImage_t destination, const FvsImage_t source);/******************************************************************************  * 功能：清空圖像  * 參數：image  指向圖像對象的指針  * 返回：錯誤編號******************************************************************************/FvsError_t ImageClear(FvsImage_t image);/******************************************************************************  * 功能：設置圖像中所有象素為特定值  * 參數：image  指向圖像對象的指針  *       value  要設定的值  * 返回：錯誤編號******************************************************************************/FvsError_t ImageFlood(FvsImage_t image, const FvsByte_t value);/******************************************************************************  * 功能：設置圖像中某個象素的值  * 參數：image  指向圖像對象的指針  *       x      X軸坐標  *       y      Y軸坐標  *       val    要設定的值  * 返回：無******************************************************************************/void ImageSetPixel(FvsImage_t image, const FvsInt_t x, const FvsInt_t y, 								const FvsByte_t val);/******************************************************************************  * 功能：獲得圖像中某個象素的值  * 參數：image  指向圖像對象的指針  *       x      X軸坐標  *       y      Y軸坐標  * 返回：象素的值******************************************************************************/FvsByte_t ImageGetPixel(const FvsImage_t image, const FvsInt_t x, 								const FvsInt_t y);/******************************************************************************  * 功能：獲得圖像緩沖區指針  * 參數：image  指向圖像對象的指針  * 返回：指向圖像內存緩沖區的指針******************************************************************************/FvsByte_t* ImageGetBuffer(FvsImage_t image);/******************************************************************************  * 功能：獲得圖像寬度  * 參數：image  指向圖像對象的指針  * 返回：圖像寬度******************************************************************************/FvsInt_t ImageGetWidth(const FvsImage_t image);/******************************************************************************  * 功能：獲得圖像高度  * 參數：image  指向圖像對象的指針  * 返回：圖像高度******************************************************************************/FvsInt_t ImageGetHeight(const FvsImage_t image);/******************************************************************************  * 功能：獲得圖像傾斜度  * 參數：image  指向圖像對象的指針  * 返回：傾斜度******************************************************************************/FvsInt_t ImageGetPitch(const FvsImage_t image);/******************************************************************************  * 功能：獲得圖像緩沖區的大小  * 參數：image  指向圖像對象的指針  * 返回：緩沖區大小******************************************************************************/FvsInt_t ImageGetSize(const FvsImage_t image);/******************************************************************************  * 功能：比較兩個圖像大小  * 參數：image1  指向圖像對象1的指針  *       image2  指向圖像對象2的指針  * 返回：若兩個圖像大小相等，返回true；否則返回false******************************************************************************/FvsBool_t ImageCompareSize(const FvsImage_t image1, const FvsImage_t image2);#endif /* FVS__IMAGE_HEADER__INCLUDED__ */