차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
| 양쪽 이전 판 이전 판 다음 판 | 이전 판 | ||
|
ko:face_api [2024/02/27 14:48] 127.0.0.1 바깥 편집 |
ko:face_api [2025/02/18 10:52] (현재) ghshin [BS2FaceEx] |
||
|---|---|---|---|
| 줄 2: | 줄 2: | ||
| 사용자의 얼굴을 인식하여 템플릿 데이터를 추출하고 매치하는 함수를 제공하는 API입니다. \\ | 사용자의 얼굴을 인식하여 템플릿 데이터를 추출하고 매치하는 함수를 제공하는 API입니다. \\ | ||
| - | * [[BS2_ScanFace]]: ''FaceStation2'' ''FaceLite'' 장치에서 얼굴을 스캔하고 템플릿 데이터와 이미지 데이터를 추출합니다. | + | * [[BS2_ScanFace]]: ''IR Face 기반'' 장치에서 얼굴을 스캔하고 템플릿 데이터와 이미지 데이터를 추출합니다. |
| * [[BS2_GetAuthGroup]]: 주어진 인증 그룹을 가져옵니다. | * [[BS2_GetAuthGroup]]: 주어진 인증 그룹을 가져옵니다. | ||
| * [[BS2_GetAllAuthGroup]]: 모든 인증 그룹을 가져옵니다. | * [[BS2_GetAllAuthGroup]]: 모든 인증 그룹을 가져옵니다. | ||
| 줄 10: | 줄 10: | ||
| ====== FaceEx API ====== | ====== FaceEx API ====== | ||
| - | * [[BS2_ScanFaceEx]]: ''FaceStation F2'' ''BioStation 3'' 장치에서 얼굴을 스캔하고 이미지 및 템플릿을 추출합니다. [+ 2.7.1] | + | * [[BS2_ScanFaceEx]]: ''Visual Face 기반'' 장치에서 얼굴을 스캔하고 이미지 및 템플릿을 추출합니다. [+ 2.7.1] |
| - | * [[BS2_ExtraceTemplateFaceEx]]: ''FaceStation F2'' ''BioStation 3'' 얼굴이 포함된 이미지를 가지고 template을 추출합니다. [+ 2.7.1] | + | * [[BS2_ExtraceTemplateFaceEx]]: ''Visual Face 기반'' 얼굴이 포함된 이미지를 가지고 template을 추출합니다. [+ 2.7.1] |
| - | * [[BS2_GetNormalizedImageFaceEx]]: ''FaceStation F2'' ''BioStation 3'' WARP 되어지지 않은(가공되어지지 않은) 얼굴 이미지로, WARP 이미지를 만듭니다. [+ 2.8] | + | * [[BS2_GetNormalizedImageFaceEx]]: ''Visual Face 기반'' WARP 되어지지 않은(가공되어지지 않은) 얼굴 이미지로, WARP 이미지를 만듭니다. [+ 2.8] |
| ===== 구조체 ===== | ===== 구조체 ===== | ||
| 줄 73: | 줄 73: | ||
| } BS2TemplateEx; | } BS2TemplateEx; | ||
| </code> | </code> | ||
| - | ''FaceStation F2'' ''BioStation 3'' \\ \\ | + | ''Visual Face 기반'' \\ \\ |
| 1. //data// \\ | 1. //data// \\ | ||
| IR 또는 visual 이미지 탬플릿 데이터 입니다. \\ \\ | IR 또는 visual 이미지 탬플릿 데이터 입니다. \\ \\ | ||
| 줄 106: | 줄 106: | ||
| } BS2FaceEx; | } BS2FaceEx; | ||
| </code> | </code> | ||
| - | ''FaceStation F2'' ''BioStation 3'' ''BioEntry W3'' \\ \\ | + | ''Visual Face 기반'' \\ \\ |
| 1. //faceIndex// \\ | 1. //faceIndex// \\ | ||
| 얼굴 인덱스입니다. \\ \\ | 얼굴 인덱스입니다. \\ \\ | ||
| 줄 149: | 줄 149: | ||
| 9. //irImageData// \\ | 9. //irImageData// \\ | ||
| IR 이미지 데이터입니다. WARP 단계에서는 IR 이미지는 존재하지 않을 수 있습니다. \\ | IR 이미지 데이터입니다. WARP 단계에서는 IR 이미지는 존재하지 않을 수 있습니다. \\ | ||
| - | 인증을 시도하게되면 자동으로 생성됩니다. \\ | + | 인증을 시도하게되면 자동으로 생성됩니다. \\ \\ |
| 10. //templateEx// \\ | 10. //templateEx// \\ | ||
| Visual 또는 IR 이미지에 대한 탬플릿 데이터입니다. \\ \\ | Visual 또는 IR 이미지에 대한 탬플릿 데이터입니다. \\ \\ | ||
| 11. //rawImageData// \\ | 11. //rawImageData// \\ | ||
| - | WARP되지 않은 이미지 정보입니다. ''imageData'' 참조 \\ \\ | + | WARP되지 않은 이미지 정보입니다. ''imageData'' 참조 \\ |
| + | WARP되지 않은 이미지의 최대 해상도는 가로와 세로 모두 4000 픽셀 이며 1920 픽셀 이하를 권장합니다. \\ | ||
| + | 선명한 얼굴 영상을 권장합니다.원본 이미지가 깨져있는 경우, Warped Image 생성에 실패할 수 있습니다. \\ | ||
| + | 전체 사진의 가로 길이가 얼굴 가로길이 보다 190% 이상 큰 이미지 사용을 권장합니다. \\ \\ | ||
| 12. //onlyTemplateEx// \\ | 12. //onlyTemplateEx// \\ | ||
| [+ 2.9.6] 템플릿 정보인 BS2TemplateEx 데이터의 연속된 메모리 정보이며, numOfTemplate의 갯수만큼 할당되어있어야 합니다. \\ | [+ 2.9.6] 템플릿 정보인 BS2TemplateEx 데이터의 연속된 메모리 정보이며, numOfTemplate의 갯수만큼 할당되어있어야 합니다. \\ | ||
| flag가 BS2_FACE_EX_FLAG_TEMPLATE_ONLY인 경우에만 사용됩니다. \\ \\ | flag가 BS2_FACE_EX_FLAG_TEMPLATE_ONLY인 경우에만 사용됩니다. \\ \\ | ||