FFmpeg
ffv1.h
Go to the documentation of this file.
1 /*
2  * FFV1 codec for libavcodec
3  *
4  * Copyright (c) 2003-2012 Michael Niedermayer <michaelni@gmx.at>
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #ifndef AVCODEC_FFV1_H
24 #define AVCODEC_FFV1_H
25 
26 /**
27  * @file
28  * FF Video Codec 1 (a lossless codec)
29  */
30 
31 #include "libavutil/avassert.h"
32 #include "libavutil/crc.h"
33 #include "libavutil/opt.h"
34 #include "libavutil/imgutils.h"
35 #include "libavutil/pixdesc.h"
36 #include "libavutil/timer.h"
37 #include "avcodec.h"
38 #include "get_bits.h"
39 #include "internal.h"
40 #include "mathops.h"
41 #include "put_bits.h"
42 #include "rangecoder.h"
43 #include "thread.h"
44 
45 #ifdef __INTEL_COMPILER
46 #undef av_flatten
47 #define av_flatten
48 #endif
49 
50 #define MAX_PLANES 4
51 #define CONTEXT_SIZE 32
52 
53 #define MAX_QUANT_TABLES 8
54 #define MAX_CONTEXT_INPUTS 5
55 
56 #define AC_GOLOMB_RICE 0
57 #define AC_RANGE_DEFAULT_TAB 1
58 #define AC_RANGE_CUSTOM_TAB 2
59 #define AC_RANGE_DEFAULT_TAB_FORCE -2
60 
61 typedef struct VlcState {
62  int16_t drift;
63  uint16_t error_sum;
64  int8_t bias;
66 } VlcState;
67 
68 typedef struct PlaneContext {
75 } PlaneContext;
76 
77 #define MAX_SLICES 1024
78 
79 typedef struct FFV1Context {
80  AVClass *class;
85  uint64_t rc_stat[256][2];
86  uint64_t (*rc_stat2[MAX_QUANT_TABLES])[32][2];
87  int version;
89  int width, height;
93  int flags;
95  int key_frame;
97  struct FFV1Context *fsrc;
98 
101  int ac; ///< 1=range coder <-> 0=golomb rice
102  int ac_byte_count; ///< number of bytes used for AC coding
111  int16_t *sample_buffer;
113 
114  int use32bit;
115 
116  int ec;
117  int intra;
121 
124 
127 
135  int slice_x;
136  int slice_y;
141 } FFV1Context;
142 
150 
151 static av_always_inline int fold(int diff, int bits)
152 {
153  if (bits == 8)
154  diff = (int8_t)diff;
155  else {
157  }
158 
159  return diff;
160 }
161 
162 static inline void update_vlc_state(VlcState *const state, const int v)
163 {
164  int drift = state->drift;
165  int count = state->count;
166  state->error_sum += FFABS(v);
167  drift += v;
168 
169  if (count == 128) { // FIXME: variable
170  count >>= 1;
171  drift >>= 1;
172  state->error_sum >>= 1;
173  }
174  count++;
175 
176  if (drift <= -count) {
177  state->bias = FFMAX(state->bias - 1, -128);
178 
179  drift = FFMAX(drift + count, -count + 1);
180  } else if (drift > 0) {
181  state->bias = FFMIN(state->bias + 1, 127);
182 
183  drift = FFMIN(drift - count, 0);
184  }
185 
186  state->drift = drift;
187  state->count = count;
188 }
189 
190 #define TYPE int16_t
191 #define RENAME(name) name
192 #include "ffv1_template.c"
193 #undef TYPE
194 #undef RENAME
195 
196 #define TYPE int32_t
197 #define RENAME(name) name ## 32
198 #include "ffv1_template.c"
199 #undef TYPE
200 #undef RENAME
201 
202 #endif /* AVCODEC_FFV1_H */
FFV1Context::chroma_v_shift
int chroma_v_shift
Definition: ffv1.h:91
FFV1Context::flags
int flags
Definition: ffv1.h:93
FFV1Context::key_frame_ok
int key_frame_ok
Definition: ffv1.h:119
update_vlc_state
static void update_vlc_state(VlcState *const state, const int v)
Definition: ffv1.h:162
opt.h
FFV1Context::context_count
int context_count[MAX_QUANT_TABLES]
Definition: ffv1.h:106
FFV1Context::ec
int ec
Definition: ffv1.h:116
FFV1Context::gb
GetBitContext gb
Definition: ffv1.h:83
count
void INT64 INT64 count
Definition: avisynth_c.h:767
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:295
pixdesc.h
internal.h
FFV1Context::last_picture
ThreadFrame last_picture
Definition: ffv1.h:96
FFV1Context::slice_x
int slice_x
Definition: ffv1.h:135
rangecoder.h
FFV1Context::slice_coding_mode
int slice_coding_mode
Definition: ffv1.h:138
PlaneContext::state
uint8_t(* state)[CONTEXT_SIZE]
Definition: ffv1.h:72
FFV1Context::num_h_slices
int num_h_slices
Definition: ffv1.h:132
FFV1Context::slice_context
struct FFV1Context * slice_context[MAX_SLICES]
Definition: ffv1.h:128
thread.h
FFV1Context::chroma_h_shift
int chroma_h_shift
Definition: ffv1.h:91
crc.h
FFV1Context::slice_rct_ry_coef
int slice_rct_ry_coef
Definition: ffv1.h:140
GetBitContext
Definition: get_bits.h:61
FFV1Context::sample_buffer32
int32_t * sample_buffer32
Definition: ffv1.h:112
CONTEXT_SIZE
#define CONTEXT_SIZE
Definition: ffv1.h:51
ff_ffv1_common_init
int ff_ffv1_common_init(AVCodecContext *avctx)
Definition: ffv1.c:42
FFV1Context::chroma_planes
int chroma_planes
Definition: ffv1.h:90
PlaneContext::context_count
int context_count
Definition: ffv1.h:71
FFV1Context::c
RangeCoder c
Definition: ffv1.h:82
avassert.h
FFV1Context::quant_tables
int16_t quant_tables[MAX_QUANT_TABLES][MAX_CONTEXT_INPUTS][256]
Definition: ffv1.h:105
state
static struct @313 state
FFV1Context::bits_per_raw_sample
int bits_per_raw_sample
Definition: ffv1.h:122
FFV1Context::use32bit
int use32bit
Definition: ffv1.h:114
FFV1Context::quant_table_count
int quant_table_count
Definition: ffv1.h:126
MAX_PLANES
#define MAX_PLANES
Definition: ffv1.h:50
FFV1Context::slice_count
int slice_count
Definition: ffv1.h:129
ff_ffv1_init_slice_state
int ff_ffv1_init_slice_state(FFV1Context *f, FFV1Context *fs)
Definition: ffv1.c:67
FFV1Context::ac_byte_count
int ac_byte_count
number of bytes used for AC coding
Definition: ffv1.h:102
FFV1Context::plane
PlaneContext plane[MAX_PLANES]
Definition: ffv1.h:103
FFV1Context::max_slice_count
int max_slice_count
Definition: ffv1.h:130
FFV1Context::slice_damaged
int slice_damaged
Definition: ffv1.h:118
bits
uint8_t bits
Definition: vp3data.h:202
FFV1Context::intra
int intra
Definition: ffv1.h:117
FFV1Context::quant_table
int16_t quant_table[MAX_CONTEXT_INPUTS][256]
Definition: ffv1.h:104
FFV1Context::fsrc
struct FFV1Context * fsrc
Definition: ffv1.h:97
FFV1Context::rc_stat
uint64_t rc_stat[256][2]
Definition: ffv1.h:85
ffv1_template.c
VlcState::error_sum
uint16_t error_sum
Definition: ffv1.h:63
get_bits.h
fold
static av_always_inline int fold(int diff, int bits)
Definition: ffv1.h:151
FFV1Context::ac
int ac
1=range coder <-> 0=golomb rice
Definition: ffv1.h:101
FFV1Context::plane_count
int plane_count
Definition: ffv1.h:100
f
#define f(width, name)
Definition: cbs_vp9.c:255
PutBitContext
Definition: put_bits.h:35
PlaneContext::interlace_bit_state
uint8_t interlace_bit_state[2]
Definition: ffv1.h:74
int32_t
int32_t
Definition: audio_convert.c:194
FFABS
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Definition: common.h:72
FFV1Context::slice_height
int slice_height
Definition: ffv1.h:134
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
PlaneContext::vlc_state
VlcState * vlc_state
Definition: ffv1.h:73
fs
#define fs(width, name, subs,...)
Definition: cbs_vp9.c:259
FFV1Context::num_v_slices
int num_v_slices
Definition: ffv1.h:131
FFV1Context::colorspace
int colorspace
Definition: ffv1.h:110
ff_ffv1_clear_slice_state
void ff_ffv1_clear_slice_state(FFV1Context *f, FFV1Context *fs)
Definition: ffv1.c:182
FFV1Context::state_transition
uint8_t state_transition[256]
Definition: ffv1.h:107
mathops.h
timer.h
PlaneContext
Definition: ffv1.h:68
FFV1Context::width
int width
Definition: ffv1.h:89
FFV1Context::slice_reset_contexts
int slice_reset_contexts
Definition: ffv1.h:137
VlcState
Definition: ffv1.h:61
FFV1Context::height
int height
Definition: ffv1.h:89
FFV1Context::slice_width
int slice_width
Definition: ffv1.h:133
FFV1Context::slice_rct_by_coef
int slice_rct_by_coef
Definition: ffv1.h:139
FFMAX
#define FFMAX(a, b)
Definition: common.h:94
FFV1Context::picture
ThreadFrame picture
Definition: ffv1.h:96
VlcState::count
uint8_t count
Definition: ffv1.h:65
FFV1Context::sample_buffer
int16_t * sample_buffer
Definition: ffv1.h:111
FFMIN
#define FFMIN(a, b)
Definition: common.h:96
ff_ffv1_init_slices_state
int ff_ffv1_init_slices_state(FFV1Context *f)
Definition: ffv1.c:106
PlaneContext::quant_table_index
int quant_table_index
Definition: ffv1.h:70
VlcState::drift
int16_t drift
Definition: ffv1.h:62
FFV1Context::initial_states
uint8_t(*[MAX_QUANT_TABLES] initial_states)[32]
Definition: ffv1.h:108
ff_ffv1_allocate_initial_states
int ff_ffv1_allocate_initial_states(FFV1Context *f)
Definition: ffv1.c:167
FFV1Context::gob_count
int gob_count
Definition: ffv1.h:125
av_always_inline
#define av_always_inline
Definition: attributes.h:43
FFV1Context::slice_y
int slice_y
Definition: ffv1.h:136
uint8_t
uint8_t
Definition: audio_convert.c:194
MAX_CONTEXT_INPUTS
#define MAX_CONTEXT_INPUTS
Definition: ffv1.h:54
ff_ffv1_close
int ff_ffv1_close(AVCodecContext *avctx)
Definition: ffv1.c:210
FFV1Context::packed_at_lsb
int packed_at_lsb
Definition: ffv1.h:123
avcodec.h
FFV1Context::avctx
AVCodecContext * avctx
Definition: ffv1.h:81
FFV1Context::picture_number
int picture_number
Definition: ffv1.h:94
FFV1Context::rc_stat2
uint64_t(*[MAX_QUANT_TABLES] rc_stat2)[32][2]
Definition: ffv1.h:86
AVCodecContext
main external API structure.
Definition: avcodec.h:1565
VlcState::bias
int8_t bias
Definition: ffv1.h:64
ThreadFrame
Definition: thread.h:34
FFV1Context::context_model
int context_model
Definition: ffv1.h:120
FFV1Context::pb
PutBitContext pb
Definition: ffv1.h:84
sign_extend
static av_const int sign_extend(int val, unsigned bits)
Definition: mathops.h:130
FFV1Context::key_frame
int key_frame
Definition: ffv1.h:95
ff_ffv1_init_slice_contexts
int ff_ffv1_init_slice_contexts(FFV1Context *f)
Definition: ffv1.c:117
MAX_QUANT_TABLES
#define MAX_QUANT_TABLES
Definition: ffv1.h:53
FFV1Context
Definition: ffv1.h:79
diff
static av_always_inline int diff(const uint32_t a, const uint32_t b)
Definition: vf_palettegen.c:136
FFV1Context::transparency
int transparency
Definition: ffv1.h:92
imgutils.h
FFV1Context::micro_version
int micro_version
Definition: ffv1.h:88
MAX_SLICES
#define MAX_SLICES
Definition: ffv1.h:77
FFV1Context::cur
AVFrame * cur
Definition: ffv1.h:99
RangeCoder
Definition: mss3.c:61
PlaneContext::quant_table
int16_t quant_table[MAX_CONTEXT_INPUTS][256]
Definition: ffv1.h:69
put_bits.h
FFV1Context::run_index
int run_index
Definition: ffv1.h:109
FFV1Context::version
int version
Definition: ffv1.h:87