Go to main content

man pages section 3: Multimedia Library Functions

Exit Print View

Updated: July 2017
 
 

mlib_ImageCreate(3MLIB)

Name

mlib_ImageCreate - image creation

Synopsis

cc [ flag... ] file... –lmlib [ library... ]
#include <mlib.h>

mlib_image *mlib_ImageCreate(mlib_type type, mlib_s32 channels,
     mlib_s32 width, mlib_s32 height);

Description

The mlib_ImageCreate() function creates a mediaLib image data structure and allocates memory space for image data. The data type of the image can be MLIB_BIT, MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or MLIB_DOUBLE.

To obtain the best performance, it is recommended that you use this function to create a mediaLib image whenever possible, as this guarantees alignment.

Parameters

The function takes the following arguments:

type

Image data type.

channels

Number of channels in the image.

width

Width of image in pixels.

height

Height of image in pixels.

Return Values

The function returns a pointer to the mlib_image data structure.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe

See Also

mlib_ImageCreateStruct(3MLIB), mlib_ImageCreateSubimage(3MLIB), mlib_ImageDelete(3MLIB), mlib_ImageSetPaddings(3MLIB), attributes(5)