This file contains functions and data shared by both Indeo4 and Indeo5 decoders. More...

#include <inttypes.h>
#include "libavutil/attributes.h"
#include "libavutil/imgutils.h"
#include "libavutil/timer.h"
#include "avcodec.h"
#include "get_bits.h"
#include "internal.h"
#include "mathops.h"
#include "ivi.h"
#include "ivi_dsp.h"

Macros
#define	BITSTREAM_READER_LE

Typedefs
typedef void(*	ivi_mc_func) (int16_t buf, const int16_t ref_buf, ptrdiff_t pitch, int mc_type)

typedef void(*	ivi_mc_avg_func) (int16_t buf, const int16_t ref_buf1, const int16_t *ref_buf2, ptrdiff_t pitch, int mc_type, int mc_type2)

Functions
static int	ivi_mc (IVIBandDesc *band, ivi_mc_func mc, ivi_mc_avg_func mc_avg, int offs, int mv_x, int mv_y, int mv_x2, int mv_y2, int mc_type, int mc_type2)

static uint16_t	inv_bits (uint16_t val, int nbits)
	Reverse "nbits" bits of the value "val" and return the result in the least significant bits. More...

static int	ivi_create_huff_from_desc (const IVIHuffDesc cb, VLC vlc, int flag)

av_cold void	ff_ivi_init_static_vlc (void)
	Initialize static codes used for macroblock and block decoding. More...

static void	ivi_huff_desc_copy (IVIHuffDesc dst, const IVIHuffDesc src)

static int	ivi_huff_desc_cmp (const IVIHuffDesc desc1, const IVIHuffDesc desc2)

int	ff_ivi_dec_huff_desc (GetBitContext gb, int desc_coded, int which_tab, IVIHuffTab huff_tab, AVCodecContext *avctx)
	Decode a huffman codebook descriptor from the bitstream and select specified huffman table. More...

static av_cold void	ivi_free_buffers (IVIPlaneDesc *planes)

av_cold int	ff_ivi_init_planes (AVCodecContext avctx, IVIPlaneDesc planes, const IVIPicConfig *cfg, int is_indeo4)
	Initialize planes (prepares descriptors, allocates buffers etc). More...

static int	ivi_init_tiles (IVIBandDesc band, IVITile ref_tile, int p, int b, int t_height, int t_width)

av_cold int	ff_ivi_init_tiles (IVIPlaneDesc *planes, int tile_width, int tile_height)
	Initialize tile and macroblock descriptors. More...

static int	ivi_dec_tile_data_size (GetBitContext *gb)

static int	ivi_dc_transform (IVIBandDesc band, int prev_dc, int buf_offs, int blk_size)

static int	ivi_decode_coded_blocks (GetBitContext gb, IVIBandDesc band, ivi_mc_func mc, ivi_mc_avg_func mc_avg, int mv_x, int mv_y, int mv_x2, int mv_y2, int prev_dc, int is_intra, int mc_type, int mc_type2, uint32_t quant, int offs, AVCodecContext avctx)

static int	ivi_decode_blocks (GetBitContext gb, IVIBandDesc band, IVITile tile, AVCodecContext avctx)

static int	ivi_process_empty_tile (AVCodecContext avctx, IVIBandDesc band, IVITile *tile, int32_t mv_scale)
	Handle empty tiles by performing data copying and motion compensation respectively. More...

static void	ivi_output_plane (IVIPlaneDesc plane, uint8_t dst, ptrdiff_t dst_pitch)

static int	decode_band (IVI45DecContext ctx, IVIBandDesc band, AVCodecContext *avctx)
	Decode an Indeo 4 or 5 band. More...

int	ff_ivi_decode_frame (AVCodecContext avctx, void data, int got_frame, AVPacket avpkt)

av_cold int	ff_ivi_decode_close (AVCodecContext *avctx)
	Close Indeo5 decoder and clean up its context. More...

Variables
static const IVIHuffDesc	ivi_mb_huff_desc [8]
	These are 2x8 predefined Huffman codebooks for coding macroblock/block signals. More...

static const IVIHuffDesc	ivi_blk_huff_desc [8]
	static block huffman tables More...

static VLC	ivi_mb_vlc_tabs [8]
	static macroblock Huffman tables More...

static VLC	ivi_blk_vlc_tabs [8]
	static block Huffman tables More...

const uint8_t	ff_ivi_vertical_scan_8x8 [64]
	Scan patterns shared between indeo4 and indeo5. More...

const uint8_t	ff_ivi_horizontal_scan_8x8 [64]

const uint8_t	ff_ivi_direct_scan_4x4 [16]

const RVMapDesc	ff_ivi_rvmap_tabs [9]
	Run-value (RLE) tables. More...

Detailed Description

This file contains functions and data shared by both Indeo4 and Indeo5 decoders.

Definition in file ivi.c.

Macro Definition Documentation

◆ BITSTREAM_READER_LE

#define BITSTREAM_READER_LE

Definition at line 35 of file ivi.c.

Typedef Documentation

◆ ivi_mc_func

typedef void(* ivi_mc_func) (int16_t *buf, const int16_t *ref_buf, ptrdiff_t pitch, int mc_type)

Definition at line 76 of file ivi.c.

◆ ivi_mc_avg_func

typedef void(* ivi_mc_avg_func) (int16_t *buf, const int16_t *ref_buf1, const int16_t *ref_buf2, ptrdiff_t pitch, int mc_type, int mc_type2)

Definition at line 78 of file ivi.c.

Function Documentation

◆ ivi_mc()

static int ivi_mc	(	IVIBandDesc *	band,
		ivi_mc_func	mc,
		ivi_mc_avg_func	mc_avg,
		int	offs,
		int	mv_x,
		int	mv_y,
		int	mv_x2,
		int	mv_y2,
		int	mc_type,
		int	mc_type2
	)

static

Definition at line 82 of file ivi.c.

Referenced by ivi_decode_blocks(), ivi_decode_coded_blocks(), and ivi_process_empty_tile().

◆ inv_bits()

static uint16_t inv_bits	(	uint16_t	val,
		int	nbits
	)

static

Reverse "nbits" bits of the value "val" and return the result in the least significant bits.

Definition at line 123 of file ivi.c.

Referenced by ivi_create_huff_from_desc().

◆ ivi_create_huff_from_desc()

static int ivi_create_huff_from_desc	(	const IVIHuffDesc *	cb,
		VLC *	vlc,
		int	flag
	)

static

Definition at line 145 of file ivi.c.

Referenced by ff_ivi_dec_huff_desc(), and ff_ivi_init_static_vlc().

◆ ff_ivi_init_static_vlc()

av_cold void ff_ivi_init_static_vlc ( void )

Initialize static codes used for macroblock and block decoding.

Definition at line 179 of file ivi.c.

Referenced by decode_init(), and ivi_scale_mv().

◆ ivi_huff_desc_copy()

static void ivi_huff_desc_copy	(	IVIHuffDesc *	dst,
		const IVIHuffDesc *	src
	)

static

Definition at line 206 of file ivi.c.

Referenced by ff_ivi_dec_huff_desc().

◆ ivi_huff_desc_cmp()

static int ivi_huff_desc_cmp	(	const IVIHuffDesc *	desc1,
		const IVIHuffDesc *	desc2
	)

static

Definition at line 219 of file ivi.c.

Referenced by ff_ivi_dec_huff_desc().

◆ ff_ivi_dec_huff_desc()

int ff_ivi_dec_huff_desc	(	GetBitContext *	gb,
		int	desc_coded,
		int	which_tab,
		IVIHuffTab *	huff_tab,
		AVCodecContext *	avctx
	)

Decode a huffman codebook descriptor from the bitstream and select specified huffman table.

Parameters

[in,out]	gb	the GetBit context
[in]	desc_coded	flag signalling if table descriptor was coded
[in]	which_tab	codebook purpose (IVI_MB_HUFF or IVI_BLK_HUFF)
[out]	huff_tab	pointer to the descriptor of the selected table
[in]	avctx	AVCodecContext pointer

Returns: zero on success, negative value otherwise

Definition at line 226 of file ivi.c.

Referenced by decode_band_hdr(), decode_pic_hdr(), and ivi_scale_mv().

◆ ivi_free_buffers()

static av_cold void ivi_free_buffers ( IVIPlaneDesc * planes )

static

Definition at line 282 of file ivi.c.

Referenced by ff_ivi_decode_close(), and ff_ivi_init_planes().

◆ ff_ivi_init_planes()

av_cold int ff_ivi_init_planes	(	AVCodecContext *	avctx,
		IVIPlaneDesc *	planes,
		const IVIPicConfig *	cfg,
		int	is_indeo4
	)

Initialize planes (prepares descriptors, allocates buffers etc).

Parameters

[in,out]	planes	pointer to the array of the plane descriptors
[in]	cfg	pointer to the ivi_pic_config structure describing picture layout
[in]	is_indeo4	flag signalling if it is Indeo 4 or not

Returns: result code: 0 - OK

Definition at line 305 of file ivi.c.

Referenced by decode_gop_header(), decode_init(), decode_pic_hdr(), and ivi_scale_mv().

◆ ivi_init_tiles()

static int ivi_init_tiles	(	IVIBandDesc *	band,
		IVITile *	ref_tile,
		int	p,
		int	b,
		int	t_height,
		int	t_width
	)

static

Definition at line 382 of file ivi.c.

Referenced by ff_ivi_init_tiles().

◆ ff_ivi_init_tiles()

av_cold int ff_ivi_init_tiles	(	IVIPlaneDesc *	planes,
		int	tile_width,
		int	tile_height
	)

Initialize tile and macroblock descriptors.

Parameters

[in,out]	planes	pointer to the array of the plane descriptors
[in]	tile_width	tile width
[in]	tile_height	tile height

Returns: result code: 0 - OK

Definition at line 421 of file ivi.c.

Referenced by decode_gop_header(), decode_pic_hdr(), and ivi_scale_mv().

◆ ivi_dec_tile_data_size()

static int ivi_dec_tile_data_size ( GetBitContext * gb )

static

Definition at line 471 of file ivi.c.

Referenced by decode_band().

◆ ivi_dc_transform()

static int ivi_dc_transform	(	IVIBandDesc *	band,
		int *	prev_dc,
		int	buf_offs,
		int	blk_size
	)

static

Definition at line 488 of file ivi.c.

Referenced by ivi_decode_blocks().

◆ ivi_decode_coded_blocks()

static int ivi_decode_coded_blocks	(	GetBitContext *	gb,
		IVIBandDesc *	band,
		ivi_mc_func	mc,
		ivi_mc_avg_func	mc_avg,
		int	mv_x,
		int	mv_y,
		int	mv_x2,
		int	mv_y2,
		int *	prev_dc,
		int	is_intra,
		int	mc_type,
		int	mc_type2,
		uint32_t	quant,
		int	offs,
		AVCodecContext *	avctx
	)

static

Definition at line 503 of file ivi.c.

Referenced by ivi_decode_blocks().

◆ ivi_decode_blocks()

static int ivi_decode_blocks	(	GetBitContext *	gb,
		IVIBandDesc *	band,
		IVITile *	tile,
		AVCodecContext *	avctx
	)

static

Definition at line 614 of file ivi.c.

Referenced by decode_band().

◆ ivi_process_empty_tile()

static int ivi_process_empty_tile	(	AVCodecContext *	avctx,
		IVIBandDesc *	band,
		IVITile *	tile,
		int32_t	mv_scale
	)

static

Handle empty tiles by performing data copying and motion compensation respectively.

Parameters

[in]	avctx	ptr to the AVCodecContext
[in]	band	pointer to the band descriptor
[in]	tile	pointer to the tile descriptor
[in]	mv_scale	scaling factor for motion vectors

Definition at line 761 of file ivi.c.

Referenced by decode_band().

◆ ivi_output_plane()

static void ivi_output_plane	(	IVIPlaneDesc *	plane,
		uint8_t *	dst,
		ptrdiff_t	dst_pitch
	)

static

Definition at line 906 of file ivi.c.

Referenced by ff_ivi_decode_frame().

◆ decode_band()

static int decode_band	(	IVI45DecContext *	ctx,
		IVIBandDesc *	band,
		AVCodecContext *	avctx
	)

static

Decode an Indeo 4 or 5 band.

Parameters

[in,out]	ctx	ptr to the decoder context
[in,out]	band	ptr to the band descriptor
[in]	avctx	ptr to the AVCodecContext

Returns: result code: 0 = OK, -1 = error

Definition at line 931 of file ivi.c.

Referenced by ff_ivi_decode_frame().

◆ ff_ivi_decode_frame()

int ff_ivi_decode_frame	(	AVCodecContext *	avctx,
		void *	data,
		int *	got_frame,
		AVPacket *	avpkt
	)

Definition at line 1054 of file ivi.c.

Referenced by ff_ivi_decode_frame(), and ivi_scale_mv().

◆ ff_ivi_decode_close()

av_cold int ff_ivi_decode_close ( AVCodecContext * avctx )

Close Indeo5 decoder and clean up its context.

Definition at line 1200 of file ivi.c.

Referenced by ivi_scale_mv().

Variable Documentation

◆ ivi_mb_huff_desc

const IVIHuffDesc ivi_mb_huff_desc[8]

static

Initial value:

= {
    {8,  {0, 4, 5, 4, 4, 4, 6, 6}},
    {12, {0, 2, 2, 3, 3, 3, 3, 5, 3, 2, 2, 2}},
    {12, {0, 2, 3, 4, 3, 3, 3, 3, 4, 3, 2, 2}},
    {12, {0, 3, 4, 4, 3, 3, 3, 3, 3, 2, 2, 2}},
    {13, {0, 4, 4, 3, 3, 3, 3, 2, 3, 3, 2, 1, 1}},
    {9,  {0, 4, 4, 4, 4, 3, 3, 3, 2}},
    {10, {0, 4, 4, 4, 4, 3, 3, 2, 2, 2}},
    {12, {0, 4, 4, 4, 3, 3, 2, 3, 2, 2, 2, 2}}
}

These are 2x8 predefined Huffman codebooks for coding macroblock/block signals.

They are specified using "huffman descriptors" in order to avoid huge static tables. The decoding tables will be generated at startup from these descriptors.static macroblock huffman tables

Definition at line 50 of file ivi.c.

◆ ivi_blk_huff_desc

const IVIHuffDesc ivi_blk_huff_desc[8]

static

Initial value:

= {
    {10, {1, 2, 3, 4, 4, 7, 5, 5, 4, 1}},
    {11, {2, 3, 4, 4, 4, 7, 5, 4, 3, 3, 2}},
    {12, {2, 4, 5, 5, 5, 5, 6, 4, 4, 3, 1, 1}},
    {13, {3, 3, 4, 4, 5, 6, 6, 4, 4, 3, 2, 1, 1}},
    {11, {3, 4, 4, 5, 5, 5, 6, 5, 4, 2, 2}},
    {13, {3, 4, 5, 5, 5, 5, 6, 4, 3, 3, 2, 1, 1}},
    {13, {3, 4, 5, 5, 5, 6, 5, 4, 3, 3, 2, 1, 1}},
    {9,  {3, 4, 4, 5, 5, 5, 6, 5, 5}}
}

static block huffman tables

Definition at line 62 of file ivi.c.

◆ ivi_mb_vlc_tabs

VLC ivi_mb_vlc_tabs[8]

static

static macroblock Huffman tables

Definition at line 73 of file ivi.c.

◆ ivi_blk_vlc_tabs

VLC ivi_blk_vlc_tabs[8]

static

static block Huffman tables

Definition at line 74 of file ivi.c.

◆ ff_ivi_vertical_scan_8x8

const uint8_t ff_ivi_vertical_scan_8x8[64]

Initial value:

= {
    0,  8, 16, 24, 32, 40, 48, 56,
    1,  9, 17, 25, 33, 41, 49, 57,
    2, 10, 18, 26, 34, 42, 50, 58,
    3, 11, 19, 27, 35, 43, 51, 59,
    4, 12, 20, 28, 36, 44, 52, 60,
    5, 13, 21, 29, 37, 45, 53, 61,
    6, 14, 22, 30, 38, 46, 54, 62,
    7, 15, 23, 31, 39, 47, 55, 63
}

Scan patterns shared between indeo4 and indeo5.

Common scan patterns (defined in ivi_common.c)

Definition at line 1221 of file ivi.c.

Referenced by decode_gop_header().

◆ ff_ivi_horizontal_scan_8x8

const uint8_t ff_ivi_horizontal_scan_8x8[64]

Initial value:

= {
     0,  1,  2,  3,  4,  5,  6,  7,
     8,  9, 10, 11, 12, 13, 14, 15,
    16, 17, 18, 19, 20, 21, 22, 23,
    24, 25, 26, 27, 28, 29, 30, 31,
    32, 33, 34, 35, 36, 37, 38, 39,
    40, 41, 42, 43, 44, 45, 46, 47,
    48, 49, 50, 51, 52, 53, 54, 55,
    56, 57, 58, 59, 60, 61, 62, 63
}

Definition at line 1232 of file ivi.c.

Referenced by decode_gop_header().

◆ ff_ivi_direct_scan_4x4

const uint8_t ff_ivi_direct_scan_4x4[16]

Initial value:

= {
    0, 1, 4, 8, 5, 2, 3, 6, 9, 12, 13, 10, 7, 11, 14, 15
}

Definition at line 1243 of file ivi.c.

Referenced by decode_gop_header().

◆ ff_ivi_rvmap_tabs

const RVMapDesc ff_ivi_rvmap_tabs[9]

Run-value (RLE) tables.

Definition at line 1251 of file ivi.c.

Referenced by decode_init().

Macros

Typedefs

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ BITSTREAM_READER_LE

Typedef Documentation

◆ ivi_mc_func

◆ ivi_mc_avg_func

Function Documentation

◆ ivi_mc()

◆ inv_bits()

◆ ivi_create_huff_from_desc()

◆ ff_ivi_init_static_vlc()

◆ ivi_huff_desc_copy()

◆ ivi_huff_desc_cmp()

◆ ff_ivi_dec_huff_desc()

◆ ivi_free_buffers()

◆ ff_ivi_init_planes()

◆ ivi_init_tiles()

◆ ff_ivi_init_tiles()

◆ ivi_dec_tile_data_size()

◆ ivi_dc_transform()

◆ ivi_decode_coded_blocks()

◆ ivi_decode_blocks()

◆ ivi_process_empty_tile()

◆ ivi_output_plane()

◆ decode_band()

◆ ff_ivi_decode_frame()

◆ ff_ivi_decode_close()

Variable Documentation

◆ ivi_mb_huff_desc

◆ ivi_blk_huff_desc

◆ ivi_mb_vlc_tabs

◆ ivi_blk_vlc_tabs

◆ ff_ivi_vertical_scan_8x8

◆ ff_ivi_horizontal_scan_8x8

◆ ff_ivi_direct_scan_4x4

◆ ff_ivi_rvmap_tabs