The Image Util APIs provides functions for common of images .

Required Header

#include <image_util.h>

Overview

Image Util API provides support for common functions of images. The API allows :

Calculate the size of the image buffer for the specified resolution and colorspace to be used in the image util module.
Extracts representative color from an image buffer.

The API consists of Image Util Transform,Image Util Encode/Decode.

Functions
int	image_util_calculate_buffer_size (int width, int height, image_util_colorspace_e colorspace, unsigned int *size) TIZEN_DEPRECATED_API
	Calculates the size of the image buffer for the specified resolution and colorspace.
int	image_util_extract_color_from_memory (const unsigned char image_buffer, int width, int height, unsigned char rgb_r, unsigned char rgb_g, unsigned char rgb_b)
	Extracts representative color from an image buffer.
Typedefs
typedef void *	image_util_image_h
	Image handle.

Typedef Documentation

typedef void* image_util_image_h

Image handle.

Since :: 5.5

Enumeration Type Documentation

enum image_util_colorspace_e

Enumeration for colorspace.

Since :: 2.3.1

Enumerator:

IMAGE_UTIL_COLORSPACE_YV12	YV12 - YCrCb planar format
IMAGE_UTIL_COLORSPACE_YUV422	YUV422 - planar
IMAGE_UTIL_COLORSPACE_I420	YUV420 - planar
IMAGE_UTIL_COLORSPACE_NV12	NV12- planar
IMAGE_UTIL_COLORSPACE_UYVY	UYVY - packed
IMAGE_UTIL_COLORSPACE_YUYV	YUYV - packed
IMAGE_UTIL_COLORSPACE_RGB565	RGB565, high-byte is Blue
IMAGE_UTIL_COLORSPACE_RGB888	RGB888, high-byte is Blue
IMAGE_UTIL_COLORSPACE_ARGB8888	ARGB8888, high-byte is Blue
IMAGE_UTIL_COLORSPACE_BGRA8888	BGRA8888, high-byte is Alpha
IMAGE_UTIL_COLORSPACE_RGBA8888	RGBA8888, high-byte is Alpha
IMAGE_UTIL_COLORSPACE_BGRX8888	BGRX8888, high-byte is X
IMAGE_UTIL_COLORSPACE_NV21	NV21- planar
IMAGE_UTIL_COLORSPACE_NV16	NV16- planar
IMAGE_UTIL_COLORSPACE_NV61	NV61- planar

enum image_util_error_e

Enumeration for error.

Since :: 2.3.1

Enumerator:

IMAGE_UTIL_ERROR_NONE	Successful
IMAGE_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
IMAGE_UTIL_ERROR_OUT_OF_MEMORY	Out of memory
IMAGE_UTIL_ERROR_NO_SUCH_FILE	No such file
IMAGE_UTIL_ERROR_INVALID_OPERATION	Internal error
IMAGE_UTIL_ERROR_NOT_SUPPORTED_FORMAT	Not supported format
IMAGE_UTIL_ERROR_PERMISSION_DENIED	Permission denied
IMAGE_UTIL_ERROR_NOT_SUPPORTED	Not supported

Function Documentation

int image_util_calculate_buffer_size	(	int	width,
		int	height,
		image_util_colorspace_e	colorspace,
		unsigned int *	size
	)

Calculates the size of the image buffer for the specified resolution and colorspace.

Deprecated:: Deprecated since 5.5.

Since :: 2.3.1

Parameters:

[in]	width	The image width
[in]	height	The image height
[in]	colorspace	The image colorspace
[out]	size	The Calculated buffer size

Returns:: 0 on success, otherwise a negative error value

Return values:

IMAGE_UTIL_ERROR_NONE	Successful
IMAGE_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: image_util_transform_run()

int image_util_extract_color_from_memory	(	const unsigned char *	image_buffer,
		int	width,
		int	height,
		unsigned char *	rgb_r,
		unsigned char *	rgb_g,
		unsigned char *	rgb_b
	)

Extracts representative color from an image buffer.

Since :: 3.0

Remarks:: image_buffer should be RGB888 colorspace.