using System.Runtime.InteropServices;
|
|
namespace WIDESEAWCS_Common.Face
|
{
|
public class TH_Faces // 人脸检测及识别SDK接口，可参见 IdFaceSdk.h（内含所有接口的功能、参数、返回值的具体描述）
|
{
|
#region 结构体定义
|
|
public struct RECT
|
{
|
public Int32 left;
|
public Int32 top;
|
public Int32 right;
|
public Int32 bottom;
|
};
|
|
public struct POINT
|
{
|
public Int32 x;
|
public Int32 y;
|
};
|
|
// 人脸检测返回的人脸坐标参数
|
public struct FACE_DETECT_RESULT
|
{
|
public RECT rcFace;//coordinate of face
|
public POINT ptLeftEye;//coordinate of left eye
|
public POINT ptRightEye;//coordinate of right eye
|
public POINT ptMouth;//coordinate of mouth
|
public POINT ptNose;//coordinate of nose
|
public Int32 nAngleYaw, nAnglePitch, nAngleRoll;//value of face angle
|
public Int32 nQuality;//quality of face(from 0 to 100)
|
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 512)]
|
public Byte[] FaceData;
|
};
|
|
// 人脸质量检测返回的人脸质量参数
|
public struct FACE_QUALITY_LEVEL
|
{
|
public Int32 nHalf; // 人脸完整性: 0-正常，1-人脸不太完整，2-人脸非常不完整
|
public Int32 nSmall; // 人脸大小：0-正常，1-人脸较小，2-人脸太小
|
public Int32 nPosture; // 姿态：0-正常，1-偏头较多，2-偏头太多
|
public Int32 nMask; // 脸部遮挡: 0-正常，1-人脸有遮挡，2-人脸遮挡太多
|
public Int32 nFaceMask; // 口罩：0-正常，1-有戴口罩，2-确认戴口罩
|
public Int32 nHat; // 帽子：0-正常，1-有戴帽，2-帽子遮挡脸部
|
public Int32 nGlasses; // 眼镜: 0-正常，1-有戴眼镜，2-确认戴眼镜
|
public Int32 nGape; // 张嘴: 0-正常，1-张嘴，2-张大嘴
|
public Int32 nBlur; // 模糊度：0-正常，1-较模糊，2-太模糊
|
public Int32 nBright; // 脸部曝光度：0-正常，1-太暗，2-过爆
|
public Int32 nLight; // 光源方向: 0-正常，1-侧光，2-顶光, 3-逆光
|
};
|
|
#endregion
|
|
#region 初始化及基本功能
|
|
// 返回SDK版本号（随时可调用）
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkVer", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkVer();
|
|
// 返回设备运行码
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkGetRunCode", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkGetRunCode([Out] IntPtr pStrRunCode);
|
|
// SDK初始化，成功返回0（后面除辅助接口外的所有功能接口都必须是SDK初始化成功后才有用）
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkInit", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkInit();
|
|
// SDK反初始化（后面除辅助接口外的所有功能接口在调用反初始化后均不可用，除非再次初始化）
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkUninit", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern void IdFaceSdkUninit();
|
|
// 设置检测大小（针对高分辨率且人脸占比较小时设置检测大小，通常不必调用）
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkSetDetectSize", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern void IdFaceSdkSetDetectSize(Int32 nDetectSize);
|
|
// 返回特征码大小
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkFeatureSize", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkFeatureSize();
|
|
// 返回当前的授权是否支持活体检测
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkGetLiveFaceStatus", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkGetLiveFaceStatus();
|
|
#endregion
|
|
#region 单人脸检测
|
|
// 检测最大人脸
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkDetectFace", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkDetectFace(IntPtr pImage, Int32 nWidth, Int32 nHeight, ref FACE_DETECT_RESULT Face);
|
|
#endregion
|
|
#region 多人脸检测并提取特征
|
|
// 检测多人脸同时提取各人脸的特征（nMaxFace 表示最多要检测的人脸个数，Faces 必须按最大人脸个数分配人脸坐标空间， pFeatures 必须按最大人脸个数分配特征码空间，pFeatures 参数传 0 时则只检测人脸不提特征）
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkFaceFeature", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkFaceFeature(IntPtr pImage, Int32 nWidth, Int32 nHeight, Int32 nMaxFace, [Out] FACE_DETECT_RESULT[] Faces, [Out] IntPtr pFeatures);
|
|
#endregion
|
|
#region 人脸质量检测
|
|
// 检测人脸质量（需输入人脸检测返回的人脸坐标）
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkFaceQualityLevel", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkFaceQualityLevel(IntPtr pImage, Int32 nWidth, Int32 nHeight, ref FACE_DETECT_RESULT Face, ref FACE_QUALITY_LEVEL FaceQualityLevel);
|
|
#endregion
|
|
#region SDK特征提取
|
|
// 提取人脸特征（需输入人脸检测返回的人脸坐标，pFeature需分配不小于一个人脸特征的空间）
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkFeatureGet", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkFeatureGet(IntPtr pImage, Int32 nWidth, Int32 nHeight, ref FACE_DETECT_RESULT Face, [Out] IntPtr pFeature);
|
|
#endregion
|
|
#region 一对一比对（1:1，多用于人证核验）
|
|
// 两个人脸特征比对出相似度
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkFeatureCompare", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Byte IdFaceSdkFeatureCompare(IntPtr pFeature1, IntPtr pFeature2);
|
|
#endregion
|
|
#region 一对多比对（1:N，多用于服务器识别）
|
|
// 创建一对多人脸比对列表
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkListCreate", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern IntPtr IdFaceSdkListCreate(Int32 nMaxFeatureNum);
|
|
// 向人脸比对列表中增加/插入模板的人脸特征
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkListInsert", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkListInsert(IntPtr hList, [In, Out] ref Int32 nPos, IntPtr pFeatures, Int32 nFeatureNum);
|
|
// 从人脸比对列表中删除部分人脸特征
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkListRemove", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkListRemove(IntPtr hList, Int32 nPos, Int32 nFeatureNum);
|
|
// 清空人脸比对列表中的所有人脸特征
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkListClearAll", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern void IdFaceSdkListClearAll(IntPtr hList);
|
|
// 一对多人脸比对，返回参与比对的特征数，pnScores 需分配不小于模板特征数的空间，调用后将输出与每个模板特征比对的结果（特征相似度）
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkListCompare", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkListCompare(IntPtr hList, IntPtr pFeature, Int32 nPosBegin, Int32 nFeatureNum, [Out] IntPtr pnScores);
|
|
// 销毁一对多特征比对列表
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkListDestroy", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern void IdFaceSdkListDestroy(IntPtr hList);
|
|
#endregion
|
|
#region 活体检测
|
|
// 活体检测（返回1表示活体），需传入人脸检测返回的人脸坐标，pImageColor 与 pImageBW 均有效则进行双目活体检测，如 pImageBW 为 0 则进行彩色单目活体检测，pImageColor 为 0 则进行红外双目活体检测
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkLiveFaceDetect", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkLiveFaceDetect(Int32 nWidth, Int32 nHeight, IntPtr pImageColor, ref FACE_DETECT_RESULT FaceColor, IntPtr pImageBW, ref FACE_DETECT_RESULT FaceBW);
|
|
// 活体检测并输出活检分数（可根据活检分数是否达到阈值判别是否为活体），需传入人脸检测返回的人脸坐标，pImageColor 与 pImageBW 均有效则进行双目活体检测，如 pImageBW 为 0 则进行彩色单目活体检测，pImageColor 为 0 则进行红外双目活体检测
|
[DllImport("IdFaceSdk.dll", EntryPoint = "IdFaceSdkLiveFaceDetectEx", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 IdFaceSdkLiveFaceDetectEx(Int32 nWidth, Int32 nHeight, IntPtr pImageColor, ref FACE_DETECT_RESULT FaceColor, IntPtr pImageBW, ref FACE_DETECT_RESULT FaceBW, ref Int32 nScore);
|
|
#endregion
|
|
#region 辅助接口
|
|
// 读图象文件到RGB24图象数据缓冲区，支持BMP、JPG、PNG图象文件，pRgbBuf 必须分配足够的缓冲区（不小于 nWidth * nHeight * 3）,如不知道图象分辨率可将此参数传 0 则本次调用只返回图象分辨率，然后分配足够的缓冲区再次调用读出图象数据
|
[DllImport("IdFaceSdk.dll", EntryPoint = "ReadImageFile", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 ReadImageFile(IntPtr filename, [Out] IntPtr pRgbBuf, Int32 nBufSize, ref Int32 nWidth, ref Int32 nHeight, Int32 nDepth);
|
|
// 读图象文件数据到RGB图象数据缓冲区，支持BMP、JPG、PNG图象文件，pRgbBuf 必须分配足够的缓冲区（不小于 nWidth * nHeight * 3）,如不知道图象分辨率可将此参数传 0 则本次调用只返回图象分辨率，然后分配足够的缓冲区再次调用读出图象数据
|
[DllImport("IdFaceSdk.dll", EntryPoint = "ReadImageFileData", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 ReadImageFileData(IntPtr pFileData, Int32 nFileDataSize, [Out] IntPtr pRgbBuf, Int32 nBufSize, ref Int32 nWidth, ref Int32 nHeight, Int32 nDepth);
|
|
// 旋转RGB24图象数据，nDegree为旋转角度（支持0、90、180、270），nMirror为0表示不镜象，为1表示左右镜象
|
[DllImport("IdFaceSdk.dll", EntryPoint = "RotateRgb24Data", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 RotateRgb24Data(IntPtr pSrc, Int32 nWidth, Int32 nHeight, Int32 nDegree, Int32 nMirror, [Out] IntPtr pDst);
|
|
// 从RGB24图象数据裁剪出小图
|
// 输入参数：
|
// pSrc ---- 原图数据（RGB24格式）
|
// nSrcWidth ---- 原图宽度
|
// nSrcHeight ---- 原图高度
|
// nLeft ---- 裁剪区域左上角X坐标
|
// nTop ---- 裁剪区域左上角Y坐标
|
// nWidth ---- 裁剪区域宽度
|
// nHeight ---- 裁剪区域高度
|
// nRate ---- 裁剪图象缩小倍数（0-不缩小，1-宽高缩小至原来的1/2，2-宽高缩小至原来的1/3，...）
|
// 输出参数：
|
// pDst ---- 小图数据(RGB24格式，调用前需分析足够的缓冲区)
|
// 返回值：
|
// 0 ---- 成功
|
// -1 ---- 参数错误
|
// 备注：裁剪后的图象分辨率为：宽度 = nWidth / (nRate + 1), 高度 = nHeight / (nRate + 1)
|
[DllImport("IdFaceSdk.dll", EntryPoint = "CropImage", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 CropImage(IntPtr pSrc, Int32 nSrcWidth, Int32 nSrcHeight, [Out] IntPtr pDst, int nLeft, int nTop, int nWidth, int nHeight, int nRate);
|
|
// 将RGB24图象数据保存为JPEG文件
|
[DllImport("IdFaceSdk.dll", EntryPoint = "SaveJpegFile", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 SaveJpegFile(IntPtr filename, IntPtr pRgbData, Int32 nWidth, Int32 nHeight, Int32 nDepth, Int32 nQuality);
|
|
// 将RGB24图象数据保存为JPEG文件数据
|
[DllImport("IdFaceSdk.dll", EntryPoint = "SaveJpegFileData", CharSet = CharSet.Ansi, CallingConvention = CallingConvention.StdCall)]
|
public static extern Int32 SaveJpegFileData(IntPtr pRgbData, Int32 nWidth, Int32 nHeight, Int32 nDepth, Int32 nQuality, [Out] IntPtr pFileDataBuf, Int32 nBufSize, ref Int32 nFileDataSize);
|
|
#endregion
|
}
|
}
|
