T2 - Implementation of a tier-2 coding

Data Structures
struct	opj_t2
	Tier-2 coding. More...

Typedefs
typedef struct opj_t2	opj_t2_t
	Tier-2 coding. More...

Local static functions
static void	opj_t2_putcommacode (opj_bio_t *bio, OPJ_INT32 n)
static OPJ_UINT32	opj_t2_getcommacode (opj_bio_t *bio)
static void	opj_t2_putnumpasses (opj_bio_t *bio, OPJ_UINT32 n)
	Variable length code for signalling delta Zil (truncation point) More...
static OPJ_UINT32	opj_t2_getnumpasses (opj_bio_t *bio)
static OPJ_BOOL	opj_t2_encode_packet (OPJ_UINT32 tileno, opj_tcd_tile_t *tile, opj_tcp_t *tcp, opj_pi_iterator_t *pi, OPJ_BYTE *dest, OPJ_UINT32 *p_data_written, OPJ_UINT32 len, opj_codestream_info_t *cstr_info)
	Encode a packet of a tile to a destination buffer. More...
static OPJ_BOOL	opj_t2_decode_packet (opj_t2_t *t2, opj_tcd_tile_t *tile, opj_tcp_t *tcp, opj_pi_iterator_t *pi, OPJ_BYTE *src, OPJ_UINT32 *data_read, OPJ_UINT32 max_length, opj_packet_info_t *pack_info, opj_event_mgr_t *p_manager)
	Decode a packet of a tile from a source buffer. More...
static OPJ_BOOL	opj_t2_skip_packet (opj_t2_t *p_t2, opj_tcd_tile_t *p_tile, opj_tcp_t *p_tcp, opj_pi_iterator_t *p_pi, OPJ_BYTE *p_src, OPJ_UINT32 *p_data_read, OPJ_UINT32 p_max_length, opj_packet_info_t *p_pack_info, opj_event_mgr_t *p_manager)
static OPJ_BOOL	opj_t2_read_packet_header (opj_t2_t *p_t2, opj_tcd_tile_t *p_tile, opj_tcp_t *p_tcp, opj_pi_iterator_t *p_pi, OPJ_BOOL *p_is_data_present, OPJ_BYTE *p_src_data, OPJ_UINT32 *p_data_read, OPJ_UINT32 p_max_length, opj_packet_info_t *p_pack_info, opj_event_mgr_t *p_manager)
static OPJ_BOOL	opj_t2_read_packet_data (opj_t2_t *p_t2, opj_tcd_tile_t *p_tile, opj_pi_iterator_t *p_pi, OPJ_BYTE *p_src_data, OPJ_UINT32 *p_data_read, OPJ_UINT32 p_max_length, opj_packet_info_t *pack_info, opj_event_mgr_t *p_manager)
static OPJ_BOOL	opj_t2_skip_packet_data (opj_t2_t *p_t2, opj_tcd_tile_t *p_tile, opj_pi_iterator_t *p_pi, OPJ_UINT32 *p_data_read, OPJ_UINT32 p_max_length, opj_packet_info_t *pack_info, opj_event_mgr_t *p_manager)
static OPJ_BOOL	opj_t2_init_seg (opj_tcd_cblk_dec_t *cblk, OPJ_UINT32 index, OPJ_UINT32 cblksty, OPJ_UINT32 first)

Exported functions
OPJ_BOOL	opj_t2_encode_packets (opj_t2_t *t2, OPJ_UINT32 tileno, opj_tcd_tile_t *tile, OPJ_UINT32 maxlayers, OPJ_BYTE *dest, OPJ_UINT32 *p_data_written, OPJ_UINT32 len, opj_codestream_info_t *cstr_info, OPJ_UINT32 tpnum, OPJ_INT32 tppos, OPJ_UINT32 pino, J2K_T2_MODE t2_mode)
	Encode the packets of a tile to a destination buffer. More...
OPJ_BOOL	opj_t2_decode_packets (opj_t2_t *t2, OPJ_UINT32 tileno, opj_tcd_tile_t *tile, OPJ_BYTE *src, OPJ_UINT32 *p_data_read, OPJ_UINT32 len, opj_codestream_index_t *cstr_info, opj_event_mgr_t *p_manager)
	Decode the packets of a tile from a source buffer. More...
opj_t2_t *	opj_t2_create (opj_image_t *p_image, opj_cp_t *p_cp)
	Creates a Tier 2 handle. More...
void	opj_t2_destroy (opj_t2_t *t2)
	Destroy a T2 handle. More...

Detailed Description

Typedef Documentation

typedef struct opj_t2 opj_t2_t

Tier-2 coding.

Function Documentation

opj_t2_t* opj_t2_create	(	opj_image_t *	p_image,
		opj_cp_t *	p_cp
	)

Creates a Tier 2 handle.

Parameters

p_image	Source or destination image
p_cp	Image coding parameters.

Returns

a new T2 handle if successful, NULL otherwise.

References opj_t2::cp, opj_t2::image, and opj_calloc().

Referenced by opj_tcd_rateallocate(), opj_tcd_t2_decode(), and opj_tcd_t2_encode().

static OPJ_BOOL opj_t2_decode_packet ( opj_t2_t *  t2, opj_tcd_tile_t *  tile, opj_tcp_t *  tcp, opj_pi_iterator_t *  pi, OPJ_BYTE *  src, OPJ_UINT32 *  data_read, OPJ_UINT32  max_length, opj_packet_info_t *  pack_info, opj_event_mgr_t *  p_manager  )

static

Decode a packet of a tile from a source buffer.

Parameters

t2	T2 handle
tile	Tile for which to write the packets
tcp	Tile coding parameters
pi	Packet identity
src	Source buffer
data_read	FIXME DOC
max_length	FIXME DOC
pack_info	Packet information
p_manager	the user event manager

Returns

FIXME DOC

References OPJ_FALSE, opj_t2_read_packet_data(), opj_t2_read_packet_header(), and OPJ_TRUE.

Referenced by opj_t2_decode_packets().

OPJ_BOOL opj_t2_decode_packets	(	opj_t2_t *	t2,
		OPJ_UINT32	tileno,
		opj_tcd_tile_t *	tile,
		OPJ_BYTE *	src,
		OPJ_UINT32 *	p_data_read,
		OPJ_UINT32	len,
		opj_codestream_index_t *	cstr_info,
		opj_event_mgr_t *	p_manager
	)

Decode the packets of a tile from a source buffer.

Parameters

t2	T2 handle
tileno	number that identifies the tile for which to decode the packets
tile	tile for which to decode the packets
src	FIXME DOC
p_data_read	the source buffer
len	length of the source buffer
cstr_info	FIXME DOC
p_manager	the user event manager

Returns

FIXME DOC

References opj_pi_iterator::compno, opj_tcd_tile::comps, opj_image::comps, opj_t2::cp, opj_packet_info::end_ph_pos, opj_packet_info::end_pos, opj_t2::image, JAS_FPRINTF, opj_pi_iterator::layno, opj_cp::m_enc, opj_cp::m_specific_param, opj_encoding_param::m_tp_on, opj_tcd_tilecomp::minimum_num_resolutions, opj_tcp::num_layers_to_decode, opj_image::numcomps, opj_tcp::numpocs, OPJ_ARG_NOT_USED, OPJ_FALSE, opj_free(), opj_malloc(), opj_pi_create_decode(), opj_pi_destroy(), opj_pi_next(), OPJ_PROG_UNKNOWN, opj_t2_decode_packet(), opj_t2_skip_packet(), OPJ_TRUE, opj_uint_max(), opj_pi_iterator::poc, opj_pi_iterator::precno, opj_poc::prg, opj_poc::prg1, opj_pi_iterator::resno, opj_image_comp::resno_decoded, opj_packet_info::start_pos, opj_cp::tcps, and opj_codestream_index::tile_index.

Referenced by opj_tcd_t2_decode().

void opj_t2_destroy

(

opj_t2_t *

t2

)

Destroy a T2 handle.

Parameters

t2	T2 handle to destroy

References opj_free().

Referenced by opj_tcd_rateallocate(), opj_tcd_t2_decode(), and opj_tcd_t2_encode().

static OPJ_BOOL opj_t2_encode_packet ( OPJ_UINT32  tileno, opj_tcd_tile_t *  tile, opj_tcp_t *  tcp, opj_pi_iterator_t *  pi, OPJ_BYTE *  dest, OPJ_UINT32 *  p_data_written, OPJ_UINT32  len, opj_codestream_info_t *  cstr_info  )

static

Encode a packet of a tile to a destination buffer.

Parameters

tileno	Number of the tile encoded
tile	Tile for which to write the packets
tcp	Tile coding parameters
pi	Packet identity
dest	Destination buffer
p_data_written	FIXME DOC
len	Length of the destination buffer
cstr_info	Codestream information structure

Returns

References opj_tcd_resolution::bands, opj_tcd_precinct::cblks, opj_tcd_precinct::ch, opj_pi_iterator::compno, opj_tcd_tile::comps, opj_tcp::csty, opj_tcd_precinct::cw, opj_codestream_info::D_max, opj_tcd_layer::data, opj_tcd_layer::disto, opj_packet_info::disto, opj_tcd_precinct::enc, opj_packet_info::end_ph_pos, opj_tcd_precinct::imsbtree, opj_tcd_precinct::incltree, opj_codestream_info::index_write, J2K_CP_CSTY_EPH, J2K_CP_CSTY_SOP, opj_tcd_cblk_enc::layers, opj_pi_iterator::layno, opj_tcd_pass::len, opj_tcd_layer::len, opj_tcd_resolution::numbands, opj_tcd_cblk_enc::numbps, opj_tcd_band::numbps, opj_tcd_cblk_enc::numlenbits, opj_tcd_layer::numpasses, opj_tcd_cblk_enc::numpasses, opj_bio_create(), opj_bio_destroy(), opj_bio_flush(), opj_bio_init_enc(), opj_bio_numbytes(), opj_bio_write(), OPJ_FALSE, opj_int_floorlog2(), opj_int_max(), opj_t2_putcommacode(), opj_t2_putnumpasses(), opj_tcd_is_band_empty(), opj_tgt_encode(), opj_tgt_reset(), opj_tgt_setvalue(), OPJ_TRUE, opj_tile_info::packet, opj_tcd_tile::packno, opj_codestream_info::packno, opj_tcd_cblk_enc::passes, opj_tcd_band::precincts, opj_pi_iterator::precno, opj_pi_iterator::resno, opj_tcd_tilecomp::resolutions, opj_tcd_pass::term, and opj_codestream_info::tile.

Referenced by opj_t2_encode_packets().

OPJ_BOOL opj_t2_encode_packets	(	opj_t2_t *	t2,
		OPJ_UINT32	tileno,
		opj_tcd_tile_t *	tile,
		OPJ_UINT32	maxlayers,
		OPJ_BYTE *	dest,
		OPJ_UINT32 *	p_data_written,
		OPJ_UINT32	len,
		opj_codestream_info_t *	cstr_info,
		OPJ_UINT32	tpnum,
		OPJ_INT32	tppos,
		OPJ_UINT32	pino,
		J2K_T2_MODE	t2_mode
	)

Encode the packets of a tile to a destination buffer.

Parameters

t2	T2 handle
tileno	number of the tile encoded
tile	the tile for which to write the packets
maxlayers	maximum number of layers
dest	the destination buffer
p_data_written	FIXME DOC
len	the length of the destination buffer
cstr_info	Codestream information structure
tpnum	Tile part number of the current tile
tppos	The position of the tile part flag in the progression order
pino	FIXME DOC
t2_mode	If == 0 In Threshold calculation ,If == 1 Final pass

References opj_t2::cp, opj_tile_info::end_header, opj_packet_info::end_ph_pos, opj_packet_info::end_pos, opj_t2::image, opj_codestream_info::index_write, opj_pi_iterator::layno, opj_cp::m_enc, opj_encoding_param::m_max_comp_size, opj_cp::m_specific_param, opj_encoding_param::m_tp_on, opj_image::numcomps, opj_tcp::numpocs, OPJ_FALSE, opj_pi_create_encode(), opj_pi_destroy(), opj_pi_initialise_encode(), opj_pi_next(), OPJ_PROFILE_CINEMA_4K, OPJ_PROG_UNKNOWN, opj_t2_encode_packet(), OPJ_TRUE, opj_tile_info::packet, opj_tcd_tile::packno, opj_codestream_info::packno, opj_pi_iterator::poc, opj_tcp::POC, opj_poc::prg, opj_cp::rsiz, opj_packet_info::start_pos, opj_cp::tcps, THRESH_CALC, and opj_codestream_info::tile.

Referenced by opj_tcd_rateallocate(), and opj_tcd_t2_encode().

static OPJ_UINT32 opj_t2_getcommacode ( opj_bio_t *  bio )

static

References opj_bio_read().

Referenced by opj_t2_read_packet_header().

static OPJ_UINT32 opj_t2_getnumpasses ( opj_bio_t *  bio )

static

References opj_bio_read().

Referenced by opj_t2_read_packet_header().

static OPJ_BOOL opj_t2_init_seg ( opj_tcd_cblk_dec_t *  cblk, OPJ_UINT32  index, OPJ_UINT32  cblksty, OPJ_UINT32  first  )

static

Parameters

cblk
index
cblksty
first

References J2K_CCP_CBLKSTY_LAZY, J2K_CCP_CBLKSTY_TERMALL, opj_tcd_cblk_dec::m_current_max_segs, opj_tcd_seg::maxpasses, OPJ_FALSE, OPJ_J2K_DEFAULT_NB_SEGS, opj_realloc(), opj_tcd_reinit_segment(), OPJ_TRUE, and opj_tcd_cblk_dec::segs.

Referenced by opj_t2_read_packet_header().

static void opj_t2_putcommacode ( opj_bio_t *  bio, OPJ_INT32  n  )

static

References opj_bio_write().

Referenced by opj_t2_encode_packet().

static void opj_t2_putnumpasses ( opj_bio_t *  bio, OPJ_UINT32  n  )

static

Variable length code for signalling delta Zil (truncation point)

Parameters

bio	Bit Input/Output component
n	delta Zil

References opj_bio_write().

Referenced by opj_t2_encode_packet().

static OPJ_BOOL opj_t2_read_packet_data ( opj_t2_t *  p_t2, opj_tcd_tile_t *  p_tile, opj_pi_iterator_t *  p_pi, OPJ_BYTE *  p_src_data, OPJ_UINT32 *  p_data_read, OPJ_UINT32  p_max_length, opj_packet_info_t *  pack_info, opj_event_mgr_t *  p_manager  )

static

References opj_tcd_resolution::bands, opj_tcd_precinct::cblks, opj_tcd_precinct::ch, opj_tcd_cblk_dec::chunks, opj_pi_iterator::compno, opj_tcd_tile::comps, opj_tcd_precinct::cw, opj_tcd_seg_data_chunk::data, opj_tcd_precinct::dec, EVT_ERROR, EVT_WARNING, opj_tcd_seg_data_chunk::len, opj_tcd_seg::len, opj_tcd_seg::maxpasses, opj_tcd_seg::newlen, opj_tcd_resolution::numbands, opj_tcd_cblk_dec::numchunks, opj_tcd_cblk_dec::numchunksalloc, opj_tcd_seg::numnewpasses, opj_tcd_cblk_dec::numnewpasses, opj_tcd_seg::numpasses, opj_tcd_cblk_dec::numsegs, OPJ_ARG_NOT_USED, opj_event_msg(), OPJ_FALSE, opj_realloc(), OPJ_TRUE, opj_tcd_band::precincts, opj_pi_iterator::precno, opj_tcd_seg::real_num_passes, opj_tcd_cblk_dec::real_num_segs, opj_pi_iterator::resno, opj_tcd_tilecomp::resolutions, opj_tcd_cblk_dec::segs, opj_tcd_band::x0, opj_tcd_band::x1, opj_tcd_band::y0, and opj_tcd_band::y1.

Referenced by opj_t2_decode_packet().

static OPJ_BOOL opj_t2_read_packet_header ( opj_t2_t *  p_t2, opj_tcd_tile_t *  p_tile, opj_tcp_t *  p_tcp, opj_pi_iterator_t *  p_pi, OPJ_BOOL *  p_is_data_present, OPJ_BYTE *  p_src_data, OPJ_UINT32 *  p_data_read, OPJ_UINT32  p_max_length, opj_packet_info_t *  p_pack_info, opj_event_mgr_t *  p_manager  )

static

TODO : check the Nsop value

References opj_tcd_resolution::bands, opj_tcd_precinct::cblks, opj_tccp::cblksty, opj_tcd_precinct::ch, opj_pi_iterator::compno, opj_tcd_tile::comps, opj_t2::cp, opj_tcp::csty, opj_tcd_precinct::cw, opj_tcd_precinct::dec, opj_packet_info::end_ph_pos, EVT_ERROR, EVT_WARNING, opj_tcd_precinct::imsbtree, opj_tcd_precinct::incltree, J2K_CP_CSTY_EPH, J2K_CP_CSTY_SOP, JAS_FPRINTF, opj_pi_iterator::layno, opj_tcd_seg::maxpasses, opj_tcd_seg::newlen, opj_tcd_resolution::numbands, opj_tcd_cblk_dec::numbps, opj_tcd_band::numbps, opj_tcd_cblk_dec::numlenbits, opj_tcd_seg::numnewpasses, opj_tcd_cblk_dec::numnewpasses, opj_tcd_seg::numpasses, opj_tcd_cblk_dec::numsegs, opj_bio_create(), opj_bio_destroy(), opj_bio_inalign(), opj_bio_init_dec(), opj_bio_numbytes(), opj_bio_read(), opj_event_msg(), OPJ_FALSE, opj_int_min(), opj_t2_getcommacode(), opj_t2_getnumpasses(), opj_t2_init_seg(), opj_tcd_is_band_empty(), opj_tgt_decode(), opj_tgt_reset(), OPJ_TRUE, opj_uint_floorlog2(), opj_cp::ppm, opj_cp::ppm_data, opj_cp::ppm_len, opj_tcp::ppt, opj_tcp::ppt_data, opj_tcp::ppt_len, opj_tcd_band::precincts, opj_tcd_band::precincts_data_size, opj_pi_iterator::precno, opj_tcd_cblk_dec::real_num_segs, opj_pi_iterator::resno, opj_tcd_tilecomp::resolutions, opj_tcd_cblk_dec::segs, and opj_tcp::tccps.

Referenced by opj_t2_decode_packet(), and opj_t2_skip_packet().

static OPJ_BOOL opj_t2_skip_packet ( opj_t2_t *  p_t2, opj_tcd_tile_t *  p_tile, opj_tcp_t *  p_tcp, opj_pi_iterator_t *  p_pi, OPJ_BYTE *  p_src, OPJ_UINT32 *  p_data_read, OPJ_UINT32  p_max_length, opj_packet_info_t *  p_pack_info, opj_event_mgr_t *  p_manager  )

static

References OPJ_FALSE, opj_t2_read_packet_header(), opj_t2_skip_packet_data(), and OPJ_TRUE.

Referenced by opj_t2_decode_packets().

static OPJ_BOOL opj_t2_skip_packet_data ( opj_t2_t *  p_t2, opj_tcd_tile_t *  p_tile, opj_pi_iterator_t *  p_pi, OPJ_UINT32 *  p_data_read, OPJ_UINT32  p_max_length, opj_packet_info_t *  pack_info, opj_event_mgr_t *  p_manager  )

static

References opj_tcd_resolution::bands, opj_tcd_precinct::cblks, opj_tcd_precinct::ch, opj_pi_iterator::compno, opj_tcd_tile::comps, opj_tcd_precinct::cw, opj_tcd_precinct::dec, EVT_ERROR, EVT_WARNING, JAS_FPRINTF, opj_tcd_seg::maxpasses, opj_tcd_seg::newlen, opj_tcd_resolution::numbands, opj_tcd_seg::numnewpasses, opj_tcd_cblk_dec::numnewpasses, opj_tcd_seg::numpasses, opj_tcd_cblk_dec::numsegs, OPJ_ARG_NOT_USED, opj_event_msg(), OPJ_FALSE, OPJ_TRUE, opj_tcd_band::precincts, opj_pi_iterator::precno, opj_pi_iterator::resno, opj_tcd_tilecomp::resolutions, opj_tcd_cblk_dec::segs, opj_tcd_band::x0, opj_tcd_band::x1, opj_tcd_band::y0, and opj_tcd_band::y1.

Referenced by opj_t2_skip_packet().