Active Shape Models with Stasm 接口使用

本人只是使用了stasm接口中的一部分功能，直接拿他们训练好的模型进行使用，整个结构精简过，若需要完整的stasm文件。可下在后面链接下载完整版的。

一、简介 Stasm：
1、stasm是一个c++软件包，用来定位人脸中面部的landmarks（特征点）。输入带有人脸图像，返回landmarks的位置。特征点坐标按照[x,y],[x,y]…………顺序存放在一维数组中。
2、Stasm被设计工作在大约垂直（竖直）且带有中性表情的直视的人脸。对于生气或者带有表情的将得到不好的效果。尝尝会出现下巴部位不准，即使是闭上眼睛也会标记出眼球，这个它用的算法思想有关。
3、Stasm采用的HAT(Histogram Array Transform)描述子来做模版匹配，类似与SIFT描述子。

二、测试和运行
用vs2010打开minimal.sln文件，进入工程后，假如opencv的配置环境，包括(.h,lib,和dll)，就可以运行看到效果。本人实验室用的是2.4.8版本的。这里可能需要小小的配置一下。

三、Stasm的库函数
库接口定义在stasm_lib.h文件中，landmarks的名字列在stasm_landmarks.h的头文件中。

1、简单接口:
最简单的方法：使用stasm_search_single函数，该函数使用opencv的前侧人脸检测器找到图像中最大的人脸，并且返回landmarks的位置。
人脸的宽度至少是图像宽度的10%。本人提供的demo中调用的就是这个函数。因为目前我的项目中只涉及到一张图中只有一个人脸的情况。

**2、更多用途的接口：
1）一个图像中多张人脸的标定(landmarks)
2）可以找到一些连续的接口，一致的接口。
最基本的思想是：首先调用stasm_open_image函数来检测人脸，其次重复的调用stasm_search_auto函数来一个一个地landmarks（标记）人脸。具体详情参考minimal2.cpp和stasm_lib.h中的注释。

3、multiface 参数
stasm_open_image函数中的参数multiface，如果设置为1，你可以重复地调用stasm_search_auto函数，直到图像找到图像中的所有人脸（人脸检测器能够检测到的）。
如果设置为0，stasm_search_auto函数返回一个“最好”的人脸，通常是OpenCV人脸检测器检测到的最大的人脸。**

4、用户部分初始化
在许多应用中，需要人为的手动矫正人脸上的一些点，使用stasm_search_pinned函数可以实现。
主要用在用户指定5个点：眼睛的外角（2个），鼻子的顶端（1个），和嘴角（2个）。

5、工具函数
1）stasm_convert_shape函数，例如:stasm_convert_shape(newlandmarks, 76);newlandmarks为float类型的数组，大小为2*stasm_NLANDMARKS，stasm_NLANDMARKS为默认值77。即可以改变寻找特征点的个数，一般为20，22，68，76和默认的77。对于其他值如40，则特征点全为0（不工作）。
2）stasm_face_points_into_image函数，是landmarks(标记， 特征点)在图像的边界内部。例如如果一个人的前额被图像的边缘剪切了，Stasm将会把landmarks(特征点）的位置定位在图像的边界外面。
3）stasm_printf 打印输出流，类似与printf函数，但也可以打印到文件stasm.log。如果stasm_init函数的trace参数设置为1，则输出stasm.log日志文件。

四、注意人脸检测实现
对于左侧人脸，OpenCV经常会检测不到，因为人脸太过于靠近图像的边缘。
对于左侧图像，Stasm通过人工增加边界1.2*1.2倍的大小，这样可以简单的人脸，但是也降低了检测的速度。
对于左侧人脸，OpenCV经常会检测不到，因为人脸太过于靠近图像的边缘。

对于左侧图像，Stasm通过人工增加边界1.2*1.2倍的大小，这样可以简单的人脸，但是也降低了检测的速度。

五、stasm_landmarks.h文件内的landmarks的名字:

enum stasm_LANDMARKS_77 // stasm77 landmarks
{
    L_LTemple,          // 00
    L_LJaw01,           // 01
    L_LJawNoseline,     // 02 nose line on left jaw
    L_LJawMouthline,    // 03 mouth line on left jaw
    L_LJaw04,           // 04
    L_LJaw05,           // 05
    L_CTipOfChin,       // 06
    L_RJaw07,           // 07
    L_RJaw08,           // 08
    L_RJawMouthline,    // 09
    L_RJawNoseline,     // 10
    L_RJaw11,           // 11
    L_RTemple,          // 12
    L_RForehead,        // 13
    L_CForehead,        // 14
    L_LForehead,        // 15
    L_LEyebrowTopInner, // 16
    L_LEyebrowTopOuter, // 17
    L_LEyebrowOuter,    // 18
    L_LEyebrowBotOuter, // 19
    L_LEyebrowBotInner, // 20
    L_LEyebrowInner,    // 21
    L_REyebrowInner,    // 22
    L_REyebrowTopInner, // 23
    L_REyebrowTopOuter, // 24
    L_REyebrowOuter,    // 25
    L_REyebrowBotOuter, // 26
    L_REyebrowBotInner, // 27
    L_REyelid,          // 28
    L_LEyelid,          // 29
    L_LEyeInner,        // 30
    L_LEye31,           // 31
    L_LEyeTop,          // 32
    L_LEye33,           // 33
    L_LEyeOuter,        // 34
    L_LEye35,           // 35
    L_LEyeBot,          // 36
    L_LEye37,           // 37
    L_LPupil,           // 38
    L_RPupil,           // 39
    L_REyeInner,        // 40
    L_REye41,           // 41
    L_REyeTop,          // 42
    L_REye43,           // 43
    L_REyeOuter,        // 44
    L_REye45,           // 45
    L_REyeBot,          // 46
    L_REye47,           // 47
    L_RNoseMid,         // 48
    L_CNoseMid,         // 49
    L_LNoseMid,         // 50
    L_LNostrilTop,      // 51
    L_CNoseTip,         // 52
    L_RNostrilTop,      // 53
    L_RNoseSide,        // 54
    L_RNostrilBot,      // 55
    L_CNoseBase,        // 56
    L_LNostrilBot,