Face SDK  1.13.0 Mozart release
Face Recognition Software Development Kit
Modules | Classes | Typedefs | Functions
c interface

Modules

 Alignment info
 
 Alignment info set
 
 Data container
 
 Face
 
 Face set
 
 Set of face sets
 
 Fir set
 
 Image set
 
 Face landmark
 
 Landmark set
 
 Last error
 
 License
 
 Matrix
 
 Pure Fir extractor
 
 Remote_license
 
 Serializer
 
 Version
 
 Video frame
 
 Video stream
 

Classes

struct  face_sdk__fir
 The FIR object. FIR - Face Identification Record, biometric template. More...
 
struct  face_sdk__image
 An image keeps bitmap data in 24bpp RBG format. More...
 

Typedefs

typedef struct face_sdk__fir face_sdk__fir_t
 The FIR object. FIR - Face Identification Record, biometric template. More...
 
typedef struct face_sdk__image face_sdk__image_t
 An image keeps bitmap data in 24bpp RBG format. More...
 

Functions

bool face_sdk__fir__get_addr (const face_sdk__fir_t *fir, uint64_t *addr)
 Retrieves face_sdk__fir_t object address * *. More...
 
bool face_sdk__fir__get_version (const face_sdk__fir_t *fir, uint32_t *value)
 Retrieves fir object version. More...
 
bool face_sdk__fir__is_short (const face_sdk__fir_t *fir, bool *value)
 Retrieves fir data type. More...
 
bool face_sdk__fir__is_binary (const face_sdk__fir_t *fir, bool *value)
 Retrieves fir data type. More...
 
bool face_sdk__convert_to_short_fir (const face_sdk__fir_t *long_fir, face_sdk__fir_t **short_fir)
 Converts long data type fir to short data type fir. More...
 
void face_sdk__fir_free (face_sdk__fir_t *fir)
 Destroys face_sdk__fir object. More...
 
bool face_sdk__image__get_addr (const face_sdk__image_t *image, uint64_t *addr)
 Retrieves face_sdk__image_t object address * *. More...
 
bool face_sdk__load_image_from_file (const uint8_t *file_name, uint64_t file_name_size, face_sdk__image_t **image)
 Load encoded image from file. Image must be in RBG or BRG channels order. Grayscale or images with alfa-channel not allowed. More...
 
bool face_sdk__load_image_from_data (const uint8_t *data, uint64_t data_size, face_sdk__image_t **image)
 Load encoded image from memory. More...
 
bool face_sdk__make_image_from_data (const uint8_t *data, uint32_t width, uint32_t height, face_sdk__image_t **image)
 Makes image object from bitmap. Bitmap must 24bpp RGB format. More...
 
bool face_sdk__make_image_from_data_1 (const uint8_t *data, uint32_t width, uint32_t height, uint64_t stride, face_sdk__image_t **image)
 Makes image object from bitmap. Bitmap must 24bpp RGB format. More...
 
bool face_sdk__image__get_width (const face_sdk__image_t *image, int32_t *value)
 Retrieves image width. More...
 
bool face_sdk__image__get_height (const face_sdk__image_t *image, int32_t *value)
 Retrieves image height. More...
 
bool face_sdk__image__get_stride (const face_sdk__image_t *image, uint64_t *value)
 Retrieves image stride. More...
 
bool face_sdk__image__get_data (const face_sdk__image_t *image, void **data, uint64_t *data_size)
 Retrieves image data. More...
 
void face_sdk__image_free (face_sdk__image_t *image)
 Destroys Image object. More...
 

Detailed Description

Typedef Documentation

◆ face_sdk__fir_t

The FIR object. FIR - Face Identification Record, biometric template.

Usually face_sdk__builder_builder make firs, but you can use face_sdk__make_fir() function to instantiate a fir object.

◆ face_sdk__image_t

An image keeps bitmap data in 24bpp RBG format.

Use face_sdk__load_image_from_file(), face_sdk__load_image_from_data() and face_sdk__make_image_from_data() functions to get handle to image. Use face_sdk__image_free() to release resources occupied by image;

Function Documentation

◆ face_sdk__convert_to_short_fir()

bool face_sdk__convert_to_short_fir ( const face_sdk__fir_t long_fir,
face_sdk__fir_t **  short_fir 
)

Converts long data type fir to short data type fir.

Parameters
[in]long_firLong data type fir object
[out]short_firShort data type fir object
Returns
true on success, false on failure. See last_error

◆ face_sdk__fir__get_addr()

bool face_sdk__fir__get_addr ( const face_sdk__fir_t fir,
uint64_t *  addr 
)

Retrieves face_sdk__fir_t object address * *.

Parameters
[in]firface_sdk__fir_t object *
[out]addrObject address * *
Returns
true on success, false on failure. See last_error

◆ face_sdk__fir__get_version()

bool face_sdk__fir__get_version ( const face_sdk__fir_t fir,
uint32_t *  value 
)

Retrieves fir object version.

Parameters
[in]firFir object
[out]valueFir object version
Returns
true on success, false on failure. See last_error

◆ face_sdk__fir__is_binary()

bool face_sdk__fir__is_binary ( const face_sdk__fir_t fir,
bool *  value 
)

Retrieves fir data type.

Parameters
[in]firFir object
[out]valueTrue if fir has binary data type, false if it has short or float-based data type.
Returns
true on success, false on failure. See last_error

◆ face_sdk__fir__is_short()

bool face_sdk__fir__is_short ( const face_sdk__fir_t fir,
bool *  value 
)

Retrieves fir data type.

Parameters
[in]firFir object
[out]valueTrue if fir has short data type, false if it has binary or float-based data type.
Returns
true on success, false on failure. See last_error

◆ face_sdk__fir_free()

void face_sdk__fir_free ( face_sdk__fir_t fir)

Destroys face_sdk__fir object.

Parameters
[in]firFir object

◆ face_sdk__image__get_addr()

bool face_sdk__image__get_addr ( const face_sdk__image_t image,
uint64_t *  addr 
)

Retrieves face_sdk__image_t object address * *.

Parameters
[in]imageface_sdk__image_t object *
[out]addrObject address * *
Returns
true on success, false on failure. See last_error

◆ face_sdk__image__get_data()

bool face_sdk__image__get_data ( const face_sdk__image_t image,
void **  data,
uint64_t *  data_size 
)

Retrieves image data.

Parameters
[in]imageImage object
[out]dataBuffer holding bitmap
[out]data_sizeSize in bytes of data buffer
Returns
true on success, false on failure. See last_error

◆ face_sdk__image__get_height()

bool face_sdk__image__get_height ( const face_sdk__image_t image,
int32_t *  value 
)

Retrieves image height.

Parameters
[in]imageImage object
[out]valueImage height
Returns
true on success, false on failure. See last_error

◆ face_sdk__image__get_stride()

bool face_sdk__image__get_stride ( const face_sdk__image_t image,
uint64_t *  value 
)

Retrieves image stride.

Parameters
[in]imageImage object
[out]valueImage stride
Returns
true on success, false on failure. See last_error

◆ face_sdk__image__get_width()

bool face_sdk__image__get_width ( const face_sdk__image_t image,
int32_t *  value 
)

Retrieves image width.

Parameters
[in]imageImage object
[out]valueImage width
Returns
true on success, false on failure. See last_error

◆ face_sdk__image_free()

void face_sdk__image_free ( face_sdk__image_t image)

Destroys Image object.

Parameters
[in]imageImage object

◆ face_sdk__load_image_from_data()

bool face_sdk__load_image_from_data ( const uint8_t *  data,
uint64_t  data_size,
face_sdk__image_t **  image 
)

Load encoded image from memory.

Parameters
[in]datapointer to memory with encoded image
[in]data_sizesize of data
[out]imageImage object
Returns
true on success, false on failure. See last_error

◆ face_sdk__load_image_from_file()

bool face_sdk__load_image_from_file ( const uint8_t *  file_name,
uint64_t  file_name_size,
face_sdk__image_t **  image 
)

Load encoded image from file. Image must be in RBG or BRG channels order. Grayscale or images with alfa-channel not allowed.

Parameters
[in]file_nameString containing path to a file. See text_encoding
[in]file_name_sizeSize in bytes of file_name string
[out]imageImage object
Returns
true on success, false on failure. See last_error

◆ face_sdk__make_image_from_data()

bool face_sdk__make_image_from_data ( const uint8_t *  data,
uint32_t  width,
uint32_t  height,
face_sdk__image_t **  image 
)

Makes image object from bitmap. Bitmap must 24bpp RGB format.

Parameters
[in]datapointer to memory with bitmap
[in]widthbitmap width in pixels
[in]heightbitmap height in pixels
[out]imageImage object
Returns
true on success, false on failure. See last_error

◆ face_sdk__make_image_from_data_1()

bool face_sdk__make_image_from_data_1 ( const uint8_t *  data,
uint32_t  width,
uint32_t  height,
uint64_t  stride,
face_sdk__image_t **  image 
)

Makes image object from bitmap. Bitmap must 24bpp RGB format.

Parameters
[in]datapointer to memory with bitmap
[in]widthbitmap width in pixels
[in]heightbitmap height in pixels
[in]stridebitmap row size in bytes
[out]imageImage object
Returns
true on success, false on failure. See last_error