/*############################################################################# * 文件名：minutia.h * 功能：  細節點的一些函數接口 * modified by  PRTsinghua@hotmail.com#############################################################################*/#if !defined FVS__MINUTIA_HEADER__INCLUDED__#define FVS__MINUTIA_HEADER__INCLUDED__/* 基本類型定義 */#include "fvstypes.h"#include "image.h"#include "floatfield.h"/* 不同細節點類型的定義 */typedef enum FvsMinutiaType_t{    FvsMinutiaTypeEnding		= 0, /* 端點   */    FvsMinutiaTypeBranching		= 1, /* 分歧點 */    FvsMinutiaTypeCore			= 2, /* 核心點 */    FvsMinutiaTypeDelta			= 3, /* 三角點 */} FvsMinutiaType_t;/* 細節點結構，使用了FBI的模型，盡可能準確的提取細節點的類型，坐標，角度 */typedef struct FvsMinutia_t{    /* 細節點類型 */    FvsMinutiaType_t type;    /* X軸坐標    */    FvsFloat_t    x;    /* Y軸坐標    */    FvsFloat_t    y;    /* 細節點方向 */    FvsFloat_t    angle;} FvsMinutia_t;/* 對象的這些接口實現是私有的，不必為用戶所知 */typedef FvsHandle_t FvsMinutiaSet_t;/******************************************************************************  * 功能：創建一個細節點集合  * 參數：size  集合的大小  * 返回：若失敗，返回空；否則返回新的對象句柄******************************************************************************/FvsMinutiaSet_t MinutiaSetCreate (const FvsInt_t size);/******************************************************************************  * 功能：銷毀細節點集合。  *       一旦銷毀，該對象不再可以為任何函數所用，直到重新申請。  * 參數：minutia      細節點集合  * 返回：無******************************************************************************/void  MinutiaSetDestroy(FvsMinutiaSet_t minutia);/******************************************************************************  * 功能：獲得細節點集合的大小  * 參數：minutia      細節點集合  * 返回：細節點集合大小******************************************************************************/FvsInt_t MinutiaSetGetSize(const FvsMinutiaSet_t minutia);/******************************************************************************  * 功能：細節點集合的實際元素個數  * 參數：minutia      細節點集合  * 返回：元素個數******************************************************************************/FvsInt_t MinutiaSetGetCount(const FvsMinutiaSet_t minutia);/******************************************************************************  * 功能：返回細節點集合的數據緩沖區指針  * 參數：minutia      細節點集合  * 返回：指針******************************************************************************/FvsMinutia_t* MinutiaSetGetBuffer(FvsMinutiaSet_t minutia);/******************************************************************************  * 功能：清空細節點集合  * 參數：minutia      細節點集合  * 返回：錯誤編號******************************************************************************/FvsError_t MinutiaSetEmpty(FvsMinutiaSet_t minutia);/******************************************************************************  * 功能：在集合中添加一個細節點，如果滿了，返回一個錯誤  * 參數：minutia      細節點集合  *       x            細節點的X坐標  *       y            細節點的Y坐標  *       type         細節點類型  *       angle        角度  * 返回：錯誤編號******************************************************************************/FvsError_t MinutiaSetAdd    (    FvsMinutiaSet_t        minutia,    const FvsFloat_t       x,    const FvsFloat_t       y,    const FvsMinutiaType_t type,    const FvsFloat_t       angle    );/******************************************************************************  * 功能：從細化圖像中提取細節點，并儲存到集合中。  *       申請的細節點集合必須足夠大，如果太小了，滿了后會停止搜索細節點。  * 參數：minutia      細節點集合，用來保存細節點  *       image        細化后的圖像  *       direction    用來計算方向用  *       mask         用來表示有效的指紋區域  * 返回：錯誤編號******************************************************************************/FvsError_t MinutiaSetExtract    (    FvsMinutiaSet_t       minutia,    const FvsImage_t      image,    const FvsFloatField_t direction,    const FvsImage_t      mask    );/******************************************************************************  * 功能：在圖像中畫出細節點，不改變背景  * 參數：minutia      細節點集合  *       image        指紋圖像  * 返回：錯誤編號******************************************************************************/FvsError_t MinutiaSetDraw    (    const FvsMinutiaSet_t minutia,    FvsImage_t image    );#endif /* FVS__MINUTIA_HEADER__INCLUDED__ */