Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
en:face_api [2023/08/17 13:11] 127.0.0.1 external edit |
en:face_api [2024/02/20 16:44] (current) kkshin [BS2FaceEx] |
||
|---|---|---|---|
| Line 102: | Line 102: | ||
| uint8_t *rawImageData; | uint8_t *rawImageData; | ||
| + | |||
| + | BS2TemplateEx *onlyTemplateEx; | ||
| }; | }; | ||
| } BS2FaceEx; | } BS2FaceEx; | ||
| </code> | </code> | ||
| - | ''FaceStation F2'' ''BioStation 3'' \\ \\ | + | ''FaceStation F2'' ''BioStation 3'' ''BioEntry W3'' \\ \\ |
| 1. //faceIndex// \\ | 1. //faceIndex// \\ | ||
| Index of face \\ \\ | Index of face \\ \\ | ||
| Line 111: | Line 113: | ||
| The number of template including Visual, IR \\ \\ | The number of template including Visual, IR \\ \\ | ||
| 3. //flag// \\ | 3. //flag// \\ | ||
| - | Flag whether the image is a WARPed image. \\ | + | Flag whether the image is a WARPed image. \\ |
| WARP is a kind of generalization that extracts the face among the physical image which contains different body parts. \\ | WARP is a kind of generalization that extracts the face among the physical image which contains different body parts. \\ | ||
| When flag is set to 1, the device refers to 5 pieces of information defined by the struct in the union. \\ | When flag is set to 1, the device refers to 5 pieces of information defined by the struct in the union. \\ | ||
| Line 119: | Line 121: | ||
| When this happens, the device will automatically go through the WARP process with rawImageData and fill in the information in the struct. \\ | When this happens, the device will automatically go through the WARP process with rawImageData and fill in the information in the struct. \\ | ||
| Please note that rawImageData and struct are tied in an union. \\ | Please note that rawImageData and struct are tied in an union. \\ | ||
| + | [+ 2.9.6] An option BS2_FACE_EX_FLAG_TEMPLATE_ONLY(0x20) has been added to allow transmitting only the template excluding the facial image when sending facial data. \\ | ||
| + | This is particularly useful in environments where privacy protection is emphasized. \\ | ||
| + | When using this option, the onlyTemplateEx should be allocated with template data for each numOfTemplate. \\ | ||
| + | Additionally, unableToSaveImageOfVisualFace in [[configuration_api#BS2FaceConfig]] must be set to 1 (true). \\ | ||
| <WRAP group 50%> | <WRAP group 50%> | ||
| ^Value ^Description ^ | ^Value ^Description ^ | ||
| |BS2_FACE_EX_FLAG_NONE |0x00 | | |BS2_FACE_EX_FLAG_NONE |0x00 | | ||
| |BS2_FACE_EX_FLAG_WARPED |0x01 | | |BS2_FACE_EX_FLAG_WARPED |0x01 | | ||
| + | |BS2_FACE_EX_FLAG_TEMPLATE_ONLY |0x20 | | ||
| |BS2_FACE_EX_FLAG_ALL |0xFF | | |BS2_FACE_EX_FLAG_ALL |0xFF | | ||
| </WRAP> | </WRAP> | ||
| Line 148: | Line 155: | ||
| 11. //rawImageData// \\ | 11. //rawImageData// \\ | ||
| Non-WARPed image data. See ''imageData'' \\ \\ | Non-WARPed image data. See ''imageData'' \\ \\ | ||
| + | 12. //onlyTemplateEx// \\ | ||
| + | [+ 2.9.6] This represents contiguous memory information of BS2TemplateEx data, which is template information, and must be allocated as many as numOfTemplate. \\ | ||
| + | This is only used when the flag is BS2_FACE_EX_FLAG_TEMPLATE_ONLY. \\ \\ | ||