image.c File Reference

#include "opj_includes.h"

Functions
opj_image_t *	opj_image_create0 (void)
	Create an empty image. More...
opj_image_t *OPJ_CALLCONV	opj_image_create (OPJ_UINT32 numcmpts, opj_image_cmptparm_t *cmptparms, OPJ_COLOR_SPACE clrspc)
	Create an image. More...
void OPJ_CALLCONV	opj_image_destroy (opj_image_t *image)
	Deallocate any resources associated with an image. More...
void	opj_image_comp_header_update (opj_image_t *p_image_header, const struct opj_cp *p_cp)
	Updates the components characteristics of the image from the coding parameters. More...
void	opj_copy_image_header (const opj_image_t *p_image_src, opj_image_t *p_image_dest)
	Copy only header of image and its component header (no data are copied) if dest image have data, they will be freed. More...
opj_image_t *OPJ_CALLCONV	opj_image_tile_create (OPJ_UINT32 numcmpts, opj_image_cmptparm_t *cmptparms, OPJ_COLOR_SPACE clrspc)
	Creates an image without allocating memory for the image (used in the new version of the library). More...

Function Documentation

opj_image_t* OPJ_CALLCONV opj_image_create	(	OPJ_UINT32	numcmpts,
		opj_image_cmptparm_t *	cmptparms,
		OPJ_COLOR_SPACE	clrspc
	)

Create an image.

Parameters

numcmpts	number of components
cmptparms	components parameters
clrspc	image color space

Returns

returns a new image structure if successful, returns NULL otherwise

References opj_image_comp::bpp, opj_image_comptparm::bpp, opj_image::color_space, opj_image::comps, opj_image_comp::data, opj_image_comp::dx, opj_image_comptparm::dx, opj_image_comp::dy, opj_image_comptparm::dy, opj_image_comp::h, opj_image_comptparm::h, opj_image::numcomps, opj_calloc(), opj_image_destroy(), opj_image_comp::prec, opj_image_comptparm::prec, opj_image_comp::sgnd, opj_image_comptparm::sgnd, opj_image_comp::w, opj_image_comptparm::w, opj_image_comp::x0, opj_image_comptparm::x0, opj_image_comp::y0, and opj_image_comptparm::y0.

void OPJ_CALLCONV opj_image_destroy

(

opj_image_t *

image

)

Deallocate any resources associated with an image.

Parameters

image

image to be destroyed

References opj_image::comps, opj_image_comp::data, opj_image::icc_profile_buf, opj_image::numcomps, and opj_free().

Referenced by j2k_to_pnm(), opj_image_create(), opj_image_tile_create(), opj_j2k_decode(), opj_j2k_destroy(), opj_j2k_get_tile(), and opj_j2k_read_header().

opj_image_t* OPJ_CALLCONV opj_image_tile_create	(	OPJ_UINT32	numcmpts,
		opj_image_cmptparm_t *	cmptparms,
		OPJ_COLOR_SPACE	clrspc
	)

Creates an image without allocating memory for the image (used in the new version of the library).

Parameters

numcmpts	the number of components
cmptparms	the components parameters
clrspc	the image color space

Returns

a new image structure if successful, NULL otherwise.

References opj_image::color_space, opj_image::comps, opj_image_comp::data, opj_image_comp::dx, opj_image_comptparm::dx, opj_image_comp::dy, opj_image_comptparm::dy, opj_image_comp::h, opj_image_comptparm::h, opj_image::numcomps, opj_calloc(), opj_image_destroy(), opj_image_comp::prec, opj_image_comptparm::prec, opj_image_comp::sgnd, opj_image_comptparm::sgnd, opj_image_comp::w, opj_image_comptparm::w, opj_image_comp::x0, opj_image_comptparm::x0, opj_image_comp::y0, and opj_image_comptparm::y0.