bbmsp_image_create()

Creates a new bbmsp_image_t to hold an image.

Synopsis:

#include "bbmsp/bbmsp_util.h"

BBMSP_API bbmsp_result_t bbmsp_image_create(bbmsp_image_t **image, const bbmsp_image_type_t type, const char *data, const unsigned int data_size)

Since:

BlackBerry 10.0.0

Arguments:

image: An updated a pointer to the bbmsp_image_t.

type: The image type. If an invalid MIME type is provided, the behaviour of this method is undefined.

data: A pointer to the image data. Cannot be null.

data_size: The size of the image data in bytes. Must be > 0.

Library:

libbbmsp (For the qcc command, use the -l bbmsp option to link against this library)

Description:

Images should be constructed by using the complete image file data that is read from the image source file, not just the canvas data. The image size must be > 0 and < 32 KB (32 * 1024). Pixel size should be 333 x 333.

Returns:

BBMSP_SUCCESS if successful, BBMSP_FAILURE otherwise.