~~NOTOC~~
[[face_api]] > [[BS2_ExtraceTemplateFaceEx]]

----

===== BS2_ExtractTemplateFaceEx =====
[+ 2.7.1] ''Visual Face 기반'' 얼굴이 포함된 이미지를 가지고, template을 추출합니다. \\
AOC 카드에 template을 담기 위해 사용합니다.
<callout type="warning" icon="true">
**주의 사항** \\
[[BS2_GetNormalizedImageFaceEx]]를 통해 추출된 이미지를 전달하여야 합니다.
</callout>

==== 함수 ====
<code cpp>
#include "BS_API.h"

int BS2_ExtractTemplateFaceEx(void* context, uint32_t deviceId, const uint8_t* imageData, uint32_t imageDataLen, bool isWarped, BS2TemplateEx* templateEx);
</code>

<callout type="info">
[[face_api#BS2TemplateEx|BS2TemplateEx구조체 보기]]
</callout>
==== 파라미터 ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : 장치 식별자
  * [In] ''//imageData//'' : 얼굴이 포함된 이미지 정보를 가리키는 포인터
  * [In] ''//imageDataLen//'' : imageData의 길이
  * [In] ''//isWarped//'' : warp된 이미지인지의 여부
  * [Out] ''//templateEx//'' : imageData가 가리키는 이미지로 추출된 얼굴 template
==== 반환값 ====
성공적으로 수행될 경우 ''BS_SDK_SUCCESS''를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다. 
\\