FFmpeg
Data Structures | Macros | Enumerations | Functions | Variables
indeo3.c File Reference
#include "libavutil/imgutils.h"
#include "libavutil/intreadwrite.h"
#include "libavutil/thread.h"
#include "avcodec.h"
#include "copy_block.h"
#include "bytestream.h"
#include "get_bits.h"
#include "hpeldsp.h"
#include "internal.h"
#include "indeo3data.h"

Go to the source code of this file.

Data Structures

struct  Plane
 
struct  Cell
 
struct  Indeo3DecodeContext
 

Macros

#define BS_8BIT_PEL   (1 << 1)
 8-bit pixel bitdepth indicator More...
 
#define BS_KEYFRAME   (1 << 2)
 intra frame indicator More...
 
#define BS_MV_Y_HALF   (1 << 4)
 vertical mv halfpel resolution indicator More...
 
#define BS_MV_X_HALF   (1 << 5)
 horizontal mv halfpel resolution indicator More...
 
#define BS_NONREF   (1 << 8)
 nonref (discardable) frame indicator More...
 
#define BS_BUFFER   9
 indicates which of two frame buffers should be used More...
 
#define CELL_STACK_MAX   20
 
#define AVG_32(dst, src, ref)   AV_WN32A(dst, ((AV_RN32(src) + AV_RN32(ref)) >> 1) & 0x7F7F7F7FUL)
 
#define AVG_64(dst, src, ref)   AV_WN64A(dst, ((AV_RN64(src) + AV_RN64(ref)) >> 1) & 0x7F7F7F7F7F7F7F7FULL)
 
#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)   (new_size) = ((size) > 2) ? ((((size) + 2) >> 2) << 1) : 1
 
#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. More...
 
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, int32_t row_offset)
 
static int decode_cell_data (Indeo3DecodeContext *ctx, Cell *cell, uint8_t *block, 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. More...
 
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. More...
 
static av_cold int decode_init (AVCodecContext *avctx)
 
static int decode_frame (AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
 
static av_cold int decode_close (AVCodecContext *avctx)
 

Variables

static uint8_t requant_tab [8][128]
 
const AVCodec 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 57 of file indeo3.c.

◆ BS_KEYFRAME

#define BS_KEYFRAME   (1 << 2)

intra frame indicator

Definition at line 58 of file indeo3.c.

◆ BS_MV_Y_HALF

#define BS_MV_Y_HALF   (1 << 4)

vertical mv halfpel resolution indicator

Definition at line 59 of file indeo3.c.

◆ BS_MV_X_HALF

#define BS_MV_X_HALF   (1 << 5)

horizontal mv halfpel resolution indicator

Definition at line 60 of file indeo3.c.

◆ BS_NONREF

#define BS_NONREF   (1 << 8)

nonref (discardable) frame indicator

Definition at line 61 of file indeo3.c.

◆ BS_BUFFER

#define BS_BUFFER   9

indicates which of two frame buffers should be used

Definition at line 62 of file indeo3.c.

◆ CELL_STACK_MAX

#define CELL_STACK_MAX   20

Definition at line 73 of file indeo3.c.

◆ AVG_32

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

Definition at line 286 of file indeo3.c.

◆ AVG_64

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

Definition at line 289 of file indeo3.c.

◆ BUFFER_PRECHECK

#define BUFFER_PRECHECK
Value:
if (*data_ptr >= last_ptr) \
return IV3_OUT_OF_DATA; \

Definition at line 340 of file indeo3.c.

◆ 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)

Definition at line 344 of file indeo3.c.

◆ 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);\
fill_64(dst, pix64, 8, row_offset)

Definition at line 348 of file indeo3.c.

◆ RLE_LINES_COPY

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

Definition at line 357 of file indeo3.c.

◆ 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);\
fill_64(dst, pix64, num_lines << 1, row_offset)

Definition at line 360 of file indeo3.c.

◆ 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 369 of file indeo3.c.

◆ 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);\
AVG_64(dst, ref, dst + row_offset);

Definition at line 382 of file indeo3.c.

◆ 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 404 of file indeo3.c.

◆ SPLIT_CELL

#define SPLIT_CELL (   size,
  new_size 
)    (new_size) = ((size) > 2) ? ((((size) + 2) >> 2) << 1) : 1

Definition at line 731 of file indeo3.c.

◆ UPDATE_BITPOS

#define UPDATE_BITPOS (   n)
Value:
ctx->skip_bits += (n); \
ctx->need_resync = 1

Definition at line 733 of file indeo3.c.

◆ 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 737 of file indeo3.c.

◆ 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); \
}

Definition at line 744 of file indeo3.c.

◆ OS_HDR_ID

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

Definition at line 893 of file indeo3.c.

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 45 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 330 of file indeo3.c.

◆ anonymous enum

anonymous enum
Enumerator
H_SPLIT 
V_SPLIT 
INTRA_NULL 
INTER_DATA 

Definition at line 723 of file indeo3.c.

Function Documentation

◆ build_requant_tab()

static av_cold void build_requant_tab ( void  )
static

Definition at line 120 of file indeo3.c.

Referenced by decode_init().

◆ free_frame_buffers()

static av_cold void free_frame_buffers ( Indeo3DecodeContext ctx)
static

Definition at line 152 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 166 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
ctxpointer to the decoder context
planepointer to the plane descriptor
cellpointer to the cell descriptor

Definition at line 232 of file indeo3.c.

Referenced by decode_cell(), and parse_bintree().

◆ replicate64()

static uint64_t replicate64 ( uint64_t  a)
inlinestatic

Definition at line 297 of file indeo3.c.

◆ replicate32()

static uint32_t replicate32 ( uint32_t  a)
inlinestatic

Definition at line 308 of file indeo3.c.

◆ fill_64()

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

Definition at line 321 of file indeo3.c.

◆ decode_cell_data()

static int decode_cell_data ( Indeo3DecodeContext ctx,
Cell cell,
uint8_t *  block,
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 426 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
ctxpointer to the decoder context
avctxptr to the AVCodecContext
planepointer to the plane descriptor
cellpointer to the cell descriptor
data_ptrpointer to the compressed data
last_ptrpointer 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 582 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 753 of file indeo3.c.

Referenced by decode_plane().

◆ 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 854 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 895 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]planepointer to the descriptor of the plane being processed
[in]buf_selindicates which frame buffer the input data stored in
[out]dstpointer to the buffer receiving converted pixels
[in]dst_pitchpitch for moving to the next y line
[in]dst_heightoutput plane height

Definition at line 1026 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 1051 of file indeo3.c.

◆ decode_frame()

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

Definition at line 1067 of file indeo3.c.

◆ decode_close()

static av_cold int decode_close ( AVCodecContext avctx)
static

Definition at line 1129 of file indeo3.c.

Variable Documentation

◆ requant_tab

uint8_t requant_tab[8][128]
static

Definition at line 113 of file indeo3.c.

Referenced by build_requant_tab(), and decode_cell().

◆ ff_indeo3_decoder

const AVCodec ff_indeo3_decoder
Initial value:
= {
.name = "indeo3",
.long_name = NULL_IF_CONFIG_SMALL("Intel Indeo 3"),
.priv_data_size = sizeof(Indeo3DecodeContext),
.close = decode_close,
.capabilities = AV_CODEC_CAP_DR1,
}

Definition at line 1136 of file indeo3.c.

FF_CODEC_CAP_INIT_THREADSAFE
#define FF_CODEC_CAP_INIT_THREADSAFE
The codec does not modify any global variables in the init function, allowing to call the init functi...
Definition: internal.h:42
get_bits_count
static int get_bits_count(const GetBitContext *s)
Definition: get_bits.h:220
decode_close
static av_cold int decode_close(AVCodecContext *avctx)
Definition: indeo3.c:1129
AV_RN16
#define AV_RN16(p)
Definition: intreadwrite.h:360
AV_RN64
#define AV_RN64(p)
Definition: intreadwrite.h:368
AV_CODEC_ID_INDEO3
@ AV_CODEC_ID_INDEO3
Definition: codec_id.h:78
init
static int init
Definition: av_tx.c:47
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
decode
static void decode(AVCodecContext *dec_ctx, AVPacket *pkt, AVFrame *frame, FILE *outfile)
Definition: decode_audio.c:71
ctx
AVFormatContext * ctx
Definition: movenc.c:48
decode_init
static av_cold int decode_init(AVCodecContext *avctx)
Definition: indeo3.c:1051
AV_WN16A
#define AV_WN16A(p, v)
Definition: intreadwrite.h:534
decode_frame
static int decode_frame(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
Definition: indeo3.c:1067
AV_RN32
#define AV_RN32(p)
Definition: intreadwrite.h:364
Indeo3DecodeContext
Definition: indeo3.c:84
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:52
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:117
IV3_OUT_OF_DATA
@ IV3_OUT_OF_DATA
Definition: indeo3.c:336
FF_CODEC_CAP_INIT_CLEANUP
#define FF_CODEC_CAP_INIT_CLEANUP
The codec allows calling the close function for deallocation even if the init function returned a fai...
Definition: internal.h:50
replicate64
static uint64_t replicate64(uint64_t a)
Definition: indeo3.c:297
mode
mode
Definition: ebur128.h:83
ref
static int ref[MAX_W *MAX_W]
Definition: jpeg2000dwt.c:107
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
replicate32
static uint32_t replicate32(uint32_t a)
Definition: indeo3.c:308
AVG_64
#define AVG_64(dst, src, ref)
Definition: indeo3.c:289
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
fill_64
static void fill_64(uint8_t *dst, const uint64_t pix, int32_t n, int32_t row_offset)
Definition: indeo3.c:321