This is a decoder for Intel Indeo Video v3. More...

#include "libavutil/attributes.h"
#include "libavutil/imgutils.h"
#include "libavutil/intreadwrite.h"
#include "libavutil/mem.h"
#include "libavutil/thread.h"
#include "avcodec.h"
#include "codec_internal.h"
#include "decode.h"
#include "copy_block.h"
#include "bytestream.h"
#include "get_bits.h"
#include "hpeldsp.h"
#include "indeo3data.h"

Data Structures
struct	Plane

struct	Cell

struct	Indeo3DecodeContext

Macros
#define	BS_8BIT_PEL (1 << 1)
	8-bit pixel bitdepth indicator

#define	BS_KEYFRAME (1 << 2)
	intra frame indicator

#define	BS_MV_Y_HALF (1 << 4)
	vertical mv halfpel resolution indicator

#define	BS_MV_X_HALF (1 << 5)
	horizontal mv halfpel resolution indicator

#define	BS_NONREF (1 << 8)
	nonref (discardable) frame indicator

#define	BS_BUFFER 9
	indicates which of two frame buffers should be used

#define	CELL_STACK_MAX 20

#define	AVG_32(dst, src, ref)

#define	AVG_64(dst, src, ref)

#define	BUFFER_PRECHECK

#define	RLE_BLOCK_COPY

#define	RLE_BLOCK_COPY_8

#define	RLE_LINES_COPY copy_block4(dst, ref, row_offset, row_offset, num_lines << v_zoom)

#define	RLE_LINES_COPY_M10

#define	APPLY_DELTA_4

#define	APPLY_DELTA_8

#define	APPLY_DELTA_1011_INTER

#define	SPLIT_CELL(size, new_size)

#define	UPDATE_BITPOS(n)

#define	RESYNC_BITSTREAM

#define	CHECK_CELL

#define	OS_HDR_ID MKBETAG('F', 'R', 'M', 'H')

Enumerations
enum	{ RLE_ESC_F9 = 249 , RLE_ESC_FA = 250 , RLE_ESC_FB = 251 , RLE_ESC_FC = 252 , RLE_ESC_FD = 253 , RLE_ESC_FE = 254 , RLE_ESC_FF = 255 }

enum	{ IV3_NOERR = 0 , IV3_BAD_RLE = 1 , IV3_BAD_DATA = 2 , IV3_BAD_COUNTER = 3 , IV3_UNSUPPORTED = 4 , IV3_OUT_OF_DATA = 5 }

enum	{ H_SPLIT = 0 , V_SPLIT = 1 , INTRA_NULL = 2 , INTER_DATA = 3 }

Functions
static av_cold void	build_requant_tab (void)

static av_cold void	free_frame_buffers (Indeo3DecodeContext *ctx)

static av_cold int	allocate_frame_buffers (Indeo3DecodeContext ctx, AVCodecContext avctx, int luma_width, int luma_height)

static int	copy_cell (Indeo3DecodeContext ctx, Plane plane, Cell *cell)
	Copy pixels of the cell(x + mv_x, y + mv_y) from the previous frame into the cell(x, y) in the current frame.

static uint64_t	replicate64 (uint64_t a)

static uint32_t	replicate32 (uint32_t a)

static void	fill_64 (uint8_t *dst, const uint64_t pix, int32_t n, ptrdiff_t row_offset)

static int	decode_cell_data (Indeo3DecodeContext ctx, Cell cell, uint8_t block, const uint8_t ref_block, ptrdiff_t row_offset, int h_zoom, int v_zoom, int mode, const vqEntry delta[2], int swap_quads[2], const uint8_t data_ptr, const uint8_t last_ptr)

static int	decode_cell (Indeo3DecodeContext ctx, AVCodecContext avctx, Plane plane, Cell cell, const uint8_t data_ptr, const uint8_t last_ptr)
	Decode a vector-quantized cell.

static int	parse_bintree (Indeo3DecodeContext ctx, AVCodecContext avctx, Plane plane, int code, Cell ref_cell, const int depth, const int strip_width)

static int	decode_plane (Indeo3DecodeContext ctx, AVCodecContext avctx, Plane plane, const uint8_t data, int32_t data_size, int32_t strip_width)

static int	decode_frame_headers (Indeo3DecodeContext ctx, AVCodecContext avctx, const uint8_t *buf, int buf_size)

static void	output_plane (const Plane plane, int buf_sel, uint8_t dst, ptrdiff_t dst_pitch, int dst_height)
	Convert and output the current plane.

static av_cold int	decode_init (AVCodecContext *avctx)

static int	decode_frame (AVCodecContext avctx, AVFrame frame, int got_frame, AVPacket avpkt)

static av_cold int	decode_close (AVCodecContext *avctx)

Variables
static uint8_t	requant_tab [8][128]

const FFCodec	ff_indeo3_decoder

Detailed Description

This is a decoder for Intel Indeo Video v3.

It is based on vector quantization, run-length coding and motion compensation. Known container formats: .avi and .mov Known FOURCCs: 'IV31', 'IV32'

See also: http://wiki.multimedia.cx/index.php?title=Indeo_3

Definition in file indeo3.c.

Macro Definition Documentation

◆ BS_8BIT_PEL

#define BS_8BIT_PEL (1 << 1)

8-bit pixel bitdepth indicator

Definition at line 60 of file indeo3.c.

Referenced by decode_frame_headers().

◆ BS_KEYFRAME

#define BS_KEYFRAME (1 << 2)

intra frame indicator

Definition at line 61 of file indeo3.c.

Referenced by decode_frame().

◆ BS_MV_Y_HALF

#define BS_MV_Y_HALF (1 << 4)

vertical mv halfpel resolution indicator

Definition at line 62 of file indeo3.c.

Referenced by decode_frame_headers().

◆ BS_MV_X_HALF

#define BS_MV_X_HALF (1 << 5)

horizontal mv halfpel resolution indicator

Definition at line 63 of file indeo3.c.

Referenced by decode_frame_headers().

◆ BS_NONREF

#define BS_NONREF (1 << 8)

nonref (discardable) frame indicator

Definition at line 64 of file indeo3.c.

Referenced by decode_frame().

◆ BS_BUFFER

#define BS_BUFFER 9

indicates which of two frame buffers should be used

Definition at line 65 of file indeo3.c.

Referenced by decode_frame().

◆ CELL_STACK_MAX

#define CELL_STACK_MAX 20

Definition at line 76 of file indeo3.c.

Referenced by decode_plane().

◆ AVG_32

#define AVG_32	(	dst,
		src,
		ref )

Value:

AV_WN32A(dst, ((AV_RN32(src) + AV_RN32(ref)) >> 1) & 0x7F7F7F7FUL)

dst

uint8_t ptrdiff_t const uint8_t ptrdiff_t int intptr_t intptr_t int int16_t * dst

Definition dsp.h:87

AV_RN32

#define AV_RN32(p)

Definition intreadwrite.h:360

AV_WN32A

#define AV_WN32A(p, v)

Definition intreadwrite.h:534

src

#define src

Definition vp8dsp.c:248

ref

static int ref[MAX_W *MAX_W]

Definition jpeg2000dwt.c:117

Definition at line 292 of file indeo3.c.

◆ AVG_64

#define AVG_64	(	dst,
		src,
		ref )

Value:

AV_WN64A(dst, ((AV_RN64(src) + AV_RN64(ref)) >> 1) & 0x7F7F7F7F7F7F7F7FULL)

AV_RN64

#define AV_RN64(p)

Definition intreadwrite.h:364

AV_WN64A

#define AV_WN64A(p, v)

Definition intreadwrite.h:538

Definition at line 295 of file indeo3.c.

◆ BUFFER_PRECHECK

#define BUFFER_PRECHECK

Value:

if (*data_ptr >= last_ptr) \

return IV3_OUT_OF_DATA; \

IV3_OUT_OF_DATA

@ IV3_OUT_OF_DATA

Definition indeo3.c:342

Definition at line 346 of file indeo3.c.

Referenced by decode_cell_data().

◆ RLE_BLOCK_COPY

#define RLE_BLOCK_COPY

Value:

if (cell->mv_ptr || !skip_flag) \

copy_block4(dst, ref, row_offset, row_offset, 4 << v_zoom)

cell

In the ELBG jargon, a cell is the set of points that are closest to a codebook entry.

Definition elbg.c:39

Definition at line 350 of file indeo3.c.

Referenced by decode_cell_data().

◆ RLE_BLOCK_COPY_8

#define RLE_BLOCK_COPY_8

Value:

    pix64 = AV_RN64(ref);\
    if (is_first_row) {/* special prediction case: top line of a cell */\
        pix64 = replicate64(pix64);\
        fill_64(dst + row_offset, pix64, 7, row_offset);\
        AVG_64(dst, ref, dst + row_offset);\
    } else \
        fill_64(dst, pix64, 8, row_offset)

Definition at line 354 of file indeo3.c.

Referenced by decode_cell_data().

◆ RLE_LINES_COPY

#define RLE_LINES_COPY copy_block4(dst, ref, row_offset, row_offset, num_lines << v_zoom)

Definition at line 363 of file indeo3.c.

Referenced by decode_cell_data().

◆ RLE_LINES_COPY_M10

#define RLE_LINES_COPY_M10

Value:

    pix64 = AV_RN64(ref);\
    if (is_top_of_cell) {\
        pix64 = replicate64(pix64);\
        fill_64(dst + row_offset, pix64, (num_lines << 1) - 1, row_offset);\
        AVG_64(dst, ref, dst + row_offset);\
    } else \
        fill_64(dst, pix64, num_lines << 1, row_offset)

Definition at line 366 of file indeo3.c.

Referenced by decode_cell_data().

◆ APPLY_DELTA_4

#define APPLY_DELTA_4

Value:

    AV_WN16A(dst + line_offset    ,\
             (AV_RN16(ref    ) + delta_tab->deltas[dyad1]) & 0x7F7F);\
    AV_WN16A(dst + line_offset + 2,\
             (AV_RN16(ref + 2) + delta_tab->deltas[dyad2]) & 0x7F7F);\
    if (mode >= 3) {\
        if (is_top_of_cell && !cell->ypos) {\
            AV_COPY32U(dst, dst + row_offset);\
        } else {\
            AVG_32(dst, ref, dst + row_offset);\
        }\
    }

Definition at line 375 of file indeo3.c.

Referenced by decode_cell_data().

◆ APPLY_DELTA_8

#define APPLY_DELTA_8

Value:

    /* apply two 32-bit VQ deltas to next even line */\
    if (is_top_of_cell) { \
        AV_WN32A(dst + row_offset    , \
                 (replicate32(AV_RN32(ref    )) + delta_tab->deltas_m10[dyad1]) & 0x7F7F7F7F);\
        AV_WN32A(dst + row_offset + 4, \
                 (replicate32(AV_RN32(ref + 4)) + delta_tab->deltas_m10[dyad2]) & 0x7F7F7F7F);\
    } else { \
        AV_WN32A(dst + row_offset    , \
                 (AV_RN32(ref    ) + delta_tab->deltas_m10[dyad1]) & 0x7F7F7F7F);\
        AV_WN32A(dst + row_offset + 4, \
                 (AV_RN32(ref + 4) + delta_tab->deltas_m10[dyad2]) & 0x7F7F7F7F);\
    } \
    /* odd lines are not coded but rather interpolated/replicated */\
    /* first line of the cell on the top of image? - replicate */\
    /* otherwise - interpolate */\
    if (is_top_of_cell && !cell->ypos) {\
        AV_COPY64U(dst, dst + row_offset);\
    } else \
        AVG_64(dst, ref, dst + row_offset);

Definition at line 388 of file indeo3.c.

Referenced by decode_cell_data().

◆ APPLY_DELTA_1011_INTER

#define APPLY_DELTA_1011_INTER

Value:

    if (mode == 10) { \
        AV_WN32A(dst                 , \
                 (AV_RN32(dst                 ) + delta_tab->deltas_m10[dyad1]) & 0x7F7F7F7F);\
        AV_WN32A(dst + 4             , \
                 (AV_RN32(dst + 4             ) + delta_tab->deltas_m10[dyad2]) & 0x7F7F7F7F);\
        AV_WN32A(dst + row_offset    , \
                 (AV_RN32(dst + row_offset    ) + delta_tab->deltas_m10[dyad1]) & 0x7F7F7F7F);\
        AV_WN32A(dst + row_offset + 4, \
                 (AV_RN32(dst + row_offset + 4) + delta_tab->deltas_m10[dyad2]) & 0x7F7F7F7F);\
    } else { \
        AV_WN16A(dst                 , \
                 (AV_RN16(dst                 ) + delta_tab->deltas[dyad1]) & 0x7F7F);\
        AV_WN16A(dst + 2             , \
                 (AV_RN16(dst + 2             ) + delta_tab->deltas[dyad2]) & 0x7F7F);\
        AV_WN16A(dst + row_offset    , \
                 (AV_RN16(dst + row_offset    ) + delta_tab->deltas[dyad1]) & 0x7F7F);\
        AV_WN16A(dst + row_offset + 2, \
                 (AV_RN16(dst + row_offset + 2) + delta_tab->deltas[dyad2]) & 0x7F7F);\
    }

Definition at line 410 of file indeo3.c.

Referenced by decode_cell_data().

◆ SPLIT_CELL

#define SPLIT_CELL	(		size,
			new_size )

Value:

(new_size) = ((size) > 2) ? ((((size) + 2) >> 2) << 1) : 1

size

int size

Definition twinvq_data.h:10344

Definition at line 737 of file indeo3.c.

Referenced by parse_bintree().

◆ UPDATE_BITPOS

#define UPDATE_BITPOS ( n )

Value:

ctx->skip_bits += (n); \

ctx->need_resync = 1

ctx

static AVFormatContext * ctx

Definition movenc.c:49

Definition at line 739 of file indeo3.c.

Referenced by parse_bintree().

◆ RESYNC_BITSTREAM

#define RESYNC_BITSTREAM

Value:

    if (ctx->need_resync && !(get_bits_count(&ctx->gb) & 7)) { \
        skip_bits_long(&ctx->gb, ctx->skip_bits);              \
        ctx->skip_bits   = 0;                                  \
        ctx->need_resync = 0;                                  \
    }

Definition at line 743 of file indeo3.c.

Referenced by parse_bintree().

◆ CHECK_CELL

#define CHECK_CELL

Value:

    if (curr_cell.xpos + curr_cell.width > (plane->width >> 2) ||               \
        curr_cell.ypos + curr_cell.height > (plane->height >> 2)) {             \
        av_log(avctx, AV_LOG_ERROR, "Invalid cell: x=%d, y=%d, w=%d, h=%d\n",   \
               curr_cell.xpos, curr_cell.ypos, curr_cell.width, curr_cell.height); \
        return AVERROR_INVALIDDATA;                                                              \
    }

Definition at line 750 of file indeo3.c.

Referenced by parse_bintree().

◆ OS_HDR_ID

#define OS_HDR_ID MKBETAG('F', 'R', 'M', 'H')

Definition at line 899 of file indeo3.c.

Referenced by decode_frame_headers().

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Enumerator
RLE_ESC_F9	same as RLE_ESC_FA + do the same with next block
RLE_ESC_FA	INTRA: skip block, INTER: copy data from reference.
RLE_ESC_FB	apply null delta to N blocks / skip N blocks
RLE_ESC_FC	same as RLE_ESC_FD + do the same with next block
RLE_ESC_FD	apply null delta to all remaining lines of this block
RLE_ESC_FE	apply null delta to all lines up to the 3rd line
RLE_ESC_FF	apply null delta to all lines up to the 2nd line

Definition at line 48 of file indeo3.c.

◆ anonymous enum

anonymous enum

Enumerator
IV3_NOERR
IV3_BAD_RLE
IV3_BAD_DATA
IV3_BAD_COUNTER
IV3_UNSUPPORTED
IV3_OUT_OF_DATA

Definition at line 336 of file indeo3.c.

◆ anonymous enum

anonymous enum

Enumerator
H_SPLIT
V_SPLIT
INTRA_NULL
INTER_DATA

Definition at line 729 of file indeo3.c.

Function Documentation

◆ build_requant_tab()

static av_cold void build_requant_tab ( void )

static

Definition at line 123 of file indeo3.c.

Referenced by decode_init().

◆ free_frame_buffers()

static av_cold void free_frame_buffers ( Indeo3DecodeContext * ctx )

static

Definition at line 155 of file indeo3.c.

Referenced by decode_close(), and decode_frame_headers().

◆ allocate_frame_buffers()

static av_cold int allocate_frame_buffers	(	Indeo3DecodeContext *	ctx,
		AVCodecContext *	avctx,
		int	luma_width,
		int	luma_height )

static

Definition at line 169 of file indeo3.c.

Referenced by decode_frame_headers(), and decode_init().

◆ copy_cell()

static int copy_cell	(	Indeo3DecodeContext *	ctx,
		Plane *	plane,
		Cell *	cell )

static

Copy pixels of the cell(x + mv_x, y + mv_y) from the previous frame into the cell(x, y) in the current frame.

Parameters

ctx	pointer to the decoder context
plane	pointer to the plane descriptor
cell	pointer to the cell descriptor

Definition at line 238 of file indeo3.c.

Referenced by decode_cell(), and parse_bintree().

◆ replicate64()

static uint64_t replicate64 ( uint64_t a )

inlinestatic

Definition at line 303 of file indeo3.c.

◆ replicate32()

static uint32_t replicate32 ( uint32_t a )

inlinestatic

Definition at line 314 of file indeo3.c.

◆ fill_64()

static void fill_64	(	uint8_t *	dst,
		const uint64_t	pix,
		int32_t	n,
		ptrdiff_t	row_offset )

inlinestatic

Definition at line 327 of file indeo3.c.

◆ decode_cell_data()

static int decode_cell_data	(	Indeo3DecodeContext *	ctx,
		Cell *	cell,
		uint8_t *	block,
		const uint8_t *	ref_block,
		ptrdiff_t	row_offset,
		int	h_zoom,
		int	v_zoom,
		int	mode,
		const vqEntry *	delta[2],
		int	swap_quads[2],
		const uint8_t **	data_ptr,
		const uint8_t *	last_ptr )

static

Definition at line 432 of file indeo3.c.

Referenced by decode_cell().

◆ decode_cell()

static int decode_cell	(	Indeo3DecodeContext *	ctx,
		AVCodecContext *	avctx,
		Plane *	plane,
		Cell *	cell,
		const uint8_t *	data_ptr,
		const uint8_t *	last_ptr )

static

Decode a vector-quantized cell.

It consists of several routines, each of which handles one or more "modes" with which a cell can be encoded.

Parameters

ctx	pointer to the decoder context
avctx	ptr to the AVCodecContext
plane	pointer to the plane descriptor
cell	pointer to the cell descriptor
data_ptr	pointer to the compressed data
last_ptr	pointer to the last byte to catch reads past end of buffer

Returns: number of consumed bytes or negative number in case of error

Definition at line 586 of file indeo3.c.

Referenced by parse_bintree().

◆ parse_bintree()

static int parse_bintree	(	Indeo3DecodeContext *	ctx,
		AVCodecContext *	avctx,
		Plane *	plane,
		int	code,
		Cell *	ref_cell,
		const int	depth,
		const int	strip_width )

static

Definition at line 759 of file indeo3.c.

Referenced by decode_plane(), and parse_bintree().

◆ decode_plane()

static int decode_plane	(	Indeo3DecodeContext *	ctx,
		AVCodecContext *	avctx,
		Plane *	plane,
		const uint8_t *	data,
		int32_t	data_size,
		int32_t	strip_width )

static

Definition at line 860 of file indeo3.c.

Referenced by decode_frame().

◆ decode_frame_headers()

static int decode_frame_headers	(	Indeo3DecodeContext *	ctx,
		AVCodecContext *	avctx,
		const uint8_t *	buf,
		int	buf_size )

static

Definition at line 901 of file indeo3.c.

Referenced by decode_frame().

◆ output_plane()

static void output_plane	(	const Plane *	plane,
		int	buf_sel,
		uint8_t *	dst,
		ptrdiff_t	dst_pitch,
		int	dst_height )

static

Convert and output the current plane.

All pixel values will be upsampled by shifting right by one bit.

Parameters

[in]	plane	pointer to the descriptor of the plane being processed
[in]	buf_sel	indicates which frame buffer the input data stored in
[out]	dst	pointer to the buffer receiving converted pixels
[in]	dst_pitch	pitch for moving to the next y line
[in]	dst_height	output plane height

Definition at line 1032 of file indeo3.c.

Referenced by decode_frame(), and render_slice().

◆ decode_init()

static av_cold int decode_init ( AVCodecContext * avctx )

static

Definition at line 1057 of file indeo3.c.

◆ decode_frame()

static int decode_frame	(	AVCodecContext *	avctx,
		AVFrame *	frame,
		int *	got_frame,
		AVPacket *	avpkt )

static

Definition at line 1073 of file indeo3.c.

◆ decode_close()

static av_cold int decode_close ( AVCodecContext * avctx )

static

Definition at line 1134 of file indeo3.c.

Variable Documentation

◆ requant_tab

uint8_t requant_tab[8][128]

static

Definition at line 116 of file indeo3.c.

Referenced by build_requant_tab(), and decode_cell().

◆ ff_indeo3_decoder

const FFCodec ff_indeo3_decoder

Initial value:

= {
    .p.name         = "indeo3",
    CODEC_LONG_NAME("Intel Indeo 3"),
    .p.type         = AVMEDIA_TYPE_VIDEO,
    .p.id           = AV_CODEC_ID_INDEO3,
    .priv_data_size = sizeof(Indeo3DecodeContext),
    .init           = decode_init,
    .close          = decode_close,
    FF_CODEC_DECODE_CB(decode_frame),
    .p.capabilities = AV_CODEC_CAP_DR1,
    .caps_internal  = FF_CODEC_CAP_INIT_CLEANUP,
}

Definition at line 1141 of file indeo3.c.

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ BS_8BIT_PEL

◆ BS_KEYFRAME

◆ BS_MV_Y_HALF

◆ BS_MV_X_HALF

◆ BS_NONREF

◆ BS_BUFFER

◆ CELL_STACK_MAX

◆ AVG_32

◆ AVG_64

◆ BUFFER_PRECHECK

◆ RLE_BLOCK_COPY

◆ RLE_BLOCK_COPY_8

◆ RLE_LINES_COPY

◆ RLE_LINES_COPY_M10

◆ APPLY_DELTA_4

◆ APPLY_DELTA_8

◆ APPLY_DELTA_1011_INTER

◆ SPLIT_CELL

◆ UPDATE_BITPOS

◆ RESYNC_BITSTREAM

◆ CHECK_CELL

◆ OS_HDR_ID

Enumeration Type Documentation

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

Function Documentation

◆ build_requant_tab()

◆ free_frame_buffers()

◆ allocate_frame_buffers()

◆ copy_cell()

◆ replicate64()

◆ replicate32()

◆ fill_64()

◆ decode_cell_data()

◆ decode_cell()

◆ parse_bintree()

◆ decode_plane()

◆ decode_frame_headers()

◆ output_plane()

◆ decode_init()

◆ decode_frame()

◆ decode_close()

Variable Documentation

◆ requant_tab

◆ ff_indeo3_decoder