Input Image¶
In order to use many of the Trueface AI inference functions (face detection, face recognition, etc), you must first set the image.
The SDK is stateful meaning that once you set the image, it will persist until the next call to setImage is made.
This means that you can set the image once then call various functions on that same image.
Once you have set the image, you are ready to start calling the various Trueface AI inference functions.
-
ErrorCode
Trueface::SDK::setImage(std::string imageFile)¶ Set the image that is processed by the other methods.
- See
setImage(uint8_t* image, uint16_t width, uint16_t height, ColorCode color, int stride)
- Parameters
imageFile – [in] the path of a JPEG, JPG, PNG, BMP, or TIFF file (path must not contain ~ ).
- Returns
error code, see ErrorCode. Note, it is highly encouraged to check the return value from setImage before proceeding. If the license is invalid, the INVALID_LICENSE error will be returned.
-
ErrorCode
Trueface::SDK::setImage(uint8_t *image, uint16_t width, uint16_t height, ColorCode color, int stride = 0)¶ Set the image that is processed by the other methods.
- Parameters
image – [in] an 8-bit decoded image array, in the CPU memory or the GPU memory.
width – [in] the image width.
height – [in] the image height.
color – [in] the image color model, see ColorCode.
stride – [in] the distance between image array rows in bytes, also known as step size (used only for pointers to the GPU memory).
- Returns
error code, see ErrorCode. Note, it is highly encouraged to check the return value from setImage before proceeding. If the license is invalid, the INVALID_LICENSE error will be returned.
-
ErrorCode
Trueface::SDK::setImage(const std::vector<uint8_t> &encodedImageBuffer)¶ Set the image that is processed by the other methods.
- Parameters
encodedImageBuffer – [in] encoded image buffer, supports JPG, PNG, BMP, and TIFF.
- Returns
error code, see ErrorCode. Note, it is highly encouraged to check the return value from setImage before proceeding. If the license is invalid, the INVALID_LICENSE error will be returned.