mlib_ImageCreateSubimage (3MLIB)

Name

mlib_ImageCreateSubimage - subimage creation

Synopsis

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

mlib_image *mlib_ImageCreateSubimage(mlib_image *img, mlib_s32 x,
     mlib_s32 y, mlib_s32 w, mlib_s32 h);

Description

The mlib_ImageCreateSubimage() function creates a mediaLib image data structure for a subimage based on a source image. Note that the memory space of the source image data is used for the subimage data. The data type of the image can be MLIB_BIT, MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or MLIB_DOUBLE.

Parameters

The function takes the following arguments:

img

Pointer to source image.

x

X coordinate of subimage origin in the source.

y

Y coordinate of subimage origin in the source.

w

Width of the subimage in pixels.

h

Height of the subimage 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_ImageCreate(3MLIB), mlib_ImageCreateStruct(3MLIB), mlib_ImageDelete(3MLIB), mlib_ImageSetPaddings(3MLIB), attributes(5)