차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
ko:face_api [2021/05/26 15:44] kkshin [FaceEx API] |
ko:face_api [2021/11/14 18:34] sypark1 |
||
---|---|---|---|
줄 1: | 줄 1: | ||
====== Face API ====== | ====== Face API ====== | ||
- | 사용자 얼굴을 인식하여 템플릿 데이터 추출하고 매치하는 함수를 제공하는 API입니다. \\ | + | 사용자의 얼굴을 인식하여 템플릿 데이터를 추출하고 매치하는 함수를 제공하는 API입니다. \\ |
* [[BS2_ScanFace]]: ''FaceStation2'' ''FaceLite'' 장치에서 얼굴을 스캔하고 템플릿 데이터와 이미지 데이터를 추출합니다. | * [[BS2_ScanFace]]: ''FaceStation2'' ''FaceLite'' 장치에서 얼굴을 스캔하고 템플릿 데이터와 이미지 데이터를 추출합니다. | ||
* [[BS2_GetAuthGroup]]: 주어진 인증 그룹을 가져옵니다. | * [[BS2_GetAuthGroup]]: 주어진 인증 그룹을 가져옵니다. | ||
- | * [[BS2_GetAllAuthGroup]]: 모든 인증 그룹을 가져옵니다. * | + | * [[BS2_GetAllAuthGroup]]: 모든 인증 그룹을 가져옵니다. |
* [[BS2_SetAuthGroup]]: 인증 그룹을 설정합니다. | * [[BS2_SetAuthGroup]]: 인증 그룹을 설정합니다. | ||
* [[BS2_RemoveAuthGroup]]: 주어진 인증 그룹을 제거합니다. | * [[BS2_RemoveAuthGroup]]: 주어진 인증 그룹을 제거합니다. | ||
줄 31: | 줄 31: | ||
</code> | </code> | ||
1. //faceIndex// \\ | 1. //faceIndex// \\ | ||
- | 얼굴 인덱스입니다 \\ \\ | + | 얼굴 인덱스입니다. \\ \\ |
2. //numOfTemplate// \\ | 2. //numOfTemplate// \\ | ||
얼굴 템플릿 개수입니다. \\ \\ | 얼굴 템플릿 개수입니다. \\ \\ | ||
줄 60: | 줄 60: | ||
인증 그룹 식별자입니다. \\ \\ | 인증 그룹 식별자입니다. \\ \\ | ||
2. //name// \\ | 2. //name// \\ | ||
- | BioStar 애플리케이션에서 보여줄 인증 그룹 이름입니다 \\ \\ | + | BioStar 애플리케이션에서 보여줄 인증 그룹 이름입니다. \\ \\ |
3. //reserved// \\ | 3. //reserved// \\ | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
줄 106: | 줄 106: | ||
''FaceStation F2'' \\ \\ | ''FaceStation F2'' \\ \\ | ||
1. //faceIndex// \\ | 1. //faceIndex// \\ | ||
- | 얼굴 인덱스입니다 \\ \\ | + | 얼굴 인덱스입니다. \\ \\ |
2. //numOfTemplate// \\ | 2. //numOfTemplate// \\ | ||
Visual, IR을 포함한 얼굴 템플릿 개수입니다. \\ \\ | Visual, IR을 포함한 얼굴 템플릿 개수입니다. \\ \\ | ||
3. //flag// \\ | 3. //flag// \\ | ||
이미지가 WARP된 이미지인지 여부를 나타냅니다. \\ | 이미지가 WARP된 이미지인지 여부를 나타냅니다. \\ | ||
- | 여기서 WARP란, 이미지에는 다양한 신체부분이 담겨 있을 수 있는데, 이중 얼굴부분을 뽑아내는, 일종의 일반화라고 보시면 됩니다. \\ | + | 여기서 WARP란, 이미지에는 다양한 신체 부분이 담겨 있을 수 있는데, 이 중 얼굴 부분을 뽑아내는, 일종의 일반화라고 보시면 됩니다. \\ |
flag가 1로 설정되면, 장치는 union 내의 struct로 정의되어 있는 5개의 정보를 참조합니다. \\ | flag가 1로 설정되면, 장치는 union 내의 struct로 정의되어 있는 5개의 정보를 참조합니다. \\ | ||
flag가 0으로 설정되면, 장치는 union 내의 rawImageData를 참조합니다. \\ | flag가 0으로 설정되면, 장치는 union 내의 rawImageData를 참조합니다. \\ | ||
만약에 사용자가 WARP되지 않은 임의의 이미지를 가지고 얼굴을 등록하고자 하는 경우, \\ | 만약에 사용자가 WARP되지 않은 임의의 이미지를 가지고 얼굴을 등록하고자 하는 경우, \\ | ||
- | flag는 BS2_FACE_EX_FLAG_NONE(0)으로, rawImageData의 주소공간에 이미지 데이터로 설정하고, 이미지 데이터의 크기를 imageLen으로 지정해주시면 됩니다. \\ | + | flag는 BS2_FACE_EX_FLAG_NONE(0)으로, rawImageData의 주소공간에 이미지 데이터로 설정하고, 이미지 데이터의 크기를 imageLen으로 지정해 주시면 됩니다. \\ |
이렇게 되면 장치는 rawImageData를 가지고 자동으로 WARP 과정을 거쳐서 struct 내의 정보들을 채워주게 될 것입니다. \\ | 이렇게 되면 장치는 rawImageData를 가지고 자동으로 WARP 과정을 거쳐서 struct 내의 정보들을 채워주게 될 것입니다. \\ | ||
rawImageData와 struct가 union으로 묶여있음을 주목해 주세요. \\ | rawImageData와 struct가 union으로 묶여있음을 주목해 주세요. \\ |