阳光人脸识别二次开发包说明书解析.docVIP

阳光人脸识别二次开发包 （V3.51）说明书 注：附件SDK_V2.7版，仅供用户学习本SDK的调用方法。识别性能测试请使用最高版本的SDK。 第一部分 产品的性能评估，应用说明，问题等。 第二部分 主要是SDK函数的使用说明。 目录 第一部分 一．产品的版权 二．产品的版本 三．产品的重要特点 四．如何使用范例代码 五．如何采模板 六．如何设置相似度阀值 七．图像格式，大小，人脸大小怎样最佳 八．产品的适用人群 九．人脸特征数据的保存 十．如何鉴别两套人脸识别SDK的优劣 十一.在DELPHI下做二次开发的注意事项 十二.如何正确使用子功能 十三.SDK升级信息 十三.人脸检测性能指标 第二部分 一．输出数据-结构定义 二．SDK调用的-初始化部分 三．人脸识别主函数 四．赠送的USB视频函数 五．模板管理部分 六．输出调试变量 七．参数设置 八．活体识别 九．人工定位 十．背光模式下的人脸识别 十一.打瞌睡检测参考代码 十二.多线程范例 十三.人面搜索 附录： （1）Ver 2.7 版的《人脸识别相似度阀值表》 （2）Ver3.51版的《人脸识别相似度阀值表》 第一部分 产品的版权 本品系国人完全自主知识产权开发，从底层开始即是自行编码，未引用任何第三方技术如（人脸识别库/图像识别算法库/开源代码）等资源。更未引用其它公司的人脸识别SDK来做外壳调用型封装。 本品是VC开发，但只有极小部分用到了MFC函数,大部分CODE均为标准C++编写。 作者于2010年在北京申请了著作权，申请名称为：人脸检测与识别算法软件 注：国家软件版权申请现起禁止用 SDK/开发包/系统/模块/库 之类的字眼，一律用软件两字做结尾。 产品的版本 SunLightFace.exe是网站发布的演示程序，用户可以通过这个程序来测试SDK的性能。 SunLightFace.dll 是SDK，其性能技术指标与演示程序是完全相同的。 目前这个版本全称是：可见光主动识别版（非红外摄像头，配合识别） 另外还有两个版本：可见光被动识别版，红外主动识别版。（仅供定制用户） 用户可以用SunLightFace.dll Ver2.7这个版本来做演练性的开发，从而掌握开发包的调用方法。 但识别能力的测试，应以当前发布的最高版本为准，Ver2.7版的识别能力较弱。 产品的重要特点 人脸检测的高正确率，误检，漏检很少，支持多脸（max=32）。 平面旋转高达60度，并带鼻，嘴定位，及眼镜判断等功能。 人脸识别的高精度，向用户推荐的识别阀值不仅能适应光线环境的变化，而且有高达97.18%以上的正确率。带眼镜或头发挡住眉毛都行。（但黑粗边眼镜的识别率相对低些，即在较好的识别环境下，黑粗边眼镜仍是OK的，只要看得清眼球，就对识别率没有任何影响） 在背光模式下（看上去黑黑的一大片），开启背光识别的开关后，识别速度会减低，把识别阀值调低一些，就仍然能进行准确的识别。 高精度的人眼定位，对高清大图，开启二次精定位开关后，能准确地定位人眼中的瞳孔。准确的人眼定位，使用户能在此基础上开发出多款有创意的延伸产品。 如何使用范例代码 SunLightFace.dll是按WINDOWS API的标准调用来生成的动态库，并提供了VB,VC,C#三类范例代码，精简扼要，如果因VS版本问题无法打开，可以用其它文件编辑器打开.CPP,.H,.CS，.frm,.bas等文件来进行分析。 用户实际做应用项目时，可以直接粘贴范例代码到自己的工程中运行，只是注意调节好适当的参数值即可。 注意：要把识别能力调好，照搬范例代码是不够的，需要仔细阅读本文档，做一些参数的设置和调节。 如何采模板 1.因为是主动配合识别，最好是采5张模板（总量是10张），正面1张，侧面2张，上仰下俯各1张，偏角不宜大（2-3度即可-微偏：因为你在主动配合识别时不会故意地去偏着头识别，而是正对识别，但可能无心偏了一点，这里要求你“微偏”的目的就是为了和你将来可能的“无心偏了一点“对应），并都眼看着画面中的自己，因为眼球是定准比对的重要依据，所以无论是采模板还是识别，都眼看着画面中的自己最佳。 2.另外余下的5个模板，可以空，用于以后进行动态模板更新（后面第二部分详解），以适应人脸的长期发展变化。 当然，如果要求更稳定的识别效果，并有充分的时间和配合度，也可在每个方向上采上两个角度差不大的模板，这样总共就用掉9个模板，为了更好适应光线，还可再采不同光线的两套模板，这样就用掉18或27个模板。个人模板的总量是可设置的，请参看后面的设置函数。 注意：如果采的某几张模板在角度或光线上完全一样，这是没有任何意义的，等于只采了一张。 3.采模板时，光线不宜偏亮，也不宜偏暗，适中，并充分地反映出人脸轮廓。这样的标准化模板才能