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 "avcodec.h"
37 #include "get_bits.h"
38 #include "internal.h"
39 #include "mathops.h"
40 #include "put_bits.h"
41 #include "rangecoder.h"
42 #include "thread.h"
43 
44 #ifdef __INTEL_COMPILER
45 #undef av_flatten
46 #define av_flatten
47 #endif
48 
49 #define MAX_PLANES 4
50 #define CONTEXT_SIZE 32
51 
52 #define MAX_QUANT_TABLES 8
53 #define MAX_CONTEXT_INPUTS 5
54 
55 #define AC_GOLOMB_RICE 0
56 #define AC_RANGE_DEFAULT_TAB 1
57 #define AC_RANGE_CUSTOM_TAB 2
58 #define AC_RANGE_DEFAULT_TAB_FORCE -2
59 
60 typedef struct VlcState {
61  int16_t drift;
62  uint16_t error_sum;
63  int8_t bias;
65 } VlcState;
66 
67 typedef struct PlaneContext {
74 } PlaneContext;
75 
76 #define MAX_SLICES 1024
77 
78 typedef struct FFV1Context {
79  AVClass *class;
84  uint64_t rc_stat[256][2];
85  uint64_t (*rc_stat2[MAX_QUANT_TABLES])[32][2];
86  int version;
88  int width, height;
92  int flags;
94  int key_frame;
96  struct FFV1Context *fsrc;
97 
100  int ac; ///< 1=range coder <-> 0=golomb rice
101  int ac_byte_count; ///< number of bytes used for AC coding
110  int16_t *sample_buffer;
112 
113  int use32bit;
114 
115  int ec;
116  int intra;
120 
123 
126 
134  int slice_x;
135  int slice_y;
140 } FFV1Context;
141 
149 
150 static av_always_inline int fold(int diff, int bits)
151 {
152  if (bits == 8)
153  diff = (int8_t)diff;
154  else {
156  }
157 
158  return diff;
159 }
160 
161 static inline void update_vlc_state(VlcState *const state, const int v)
162 {
163  int drift = state->drift;
164  int count = state->count;
165  state->error_sum += FFABS(v);
166  drift += v;
167 
168  if (count == 128) { // FIXME: variable
169  count >>= 1;
170  drift >>= 1;
171  state->error_sum >>= 1;
172  }
173  count++;
174 
175  if (drift <= -count) {
176  state->bias = FFMAX(state->bias - 1, -128);
177 
178  drift = FFMAX(drift + count, -count + 1);
179  } else if (drift > 0) {
180  state->bias = FFMIN(state->bias + 1, 127);
181 
182  drift = FFMIN(drift - count, 0);
183  }
184 
185  state->drift = drift;
186  state->count = count;
187 }
188 
189 #define TYPE int16_t
190 #define RENAME(name) name
191 #include "ffv1_template.c"
192 #undef TYPE
193 #undef RENAME
194 
195 #define TYPE int32_t
196 #define RENAME(name) name ## 32
197 #include "ffv1_template.c"
198 #undef TYPE
199 #undef RENAME
200 
201 #endif /* AVCODEC_FFV1_H */
FFV1Context::chroma_v_shift
int chroma_v_shift
Definition: ffv1.h:90
FFV1Context::flags
int flags
Definition: ffv1.h:92
FFV1Context::key_frame_ok
int key_frame_ok
Definition: ffv1.h:118
update_vlc_state
static void update_vlc_state(VlcState *const state, const int v)
Definition: ffv1.h:161
opt.h
FFV1Context::context_count
int context_count[MAX_QUANT_TABLES]
Definition: ffv1.h:105
FFV1Context::ec
int ec
Definition: ffv1.h:115
FFV1Context::gb
GetBitContext gb
Definition: ffv1.h:82
state
static struct @321 state
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:318
pixdesc.h
internal.h
FFV1Context::last_picture
ThreadFrame last_picture
Definition: ffv1.h:95
FFV1Context::slice_x
int slice_x
Definition: ffv1.h:134
rangecoder.h
FFV1Context::slice_coding_mode
int slice_coding_mode
Definition: ffv1.h:137
PlaneContext::state
uint8_t(* state)[CONTEXT_SIZE]
Definition: ffv1.h:71
FFV1Context::num_h_slices
int num_h_slices
Definition: ffv1.h:131
FFV1Context::slice_context
struct FFV1Context * slice_context[MAX_SLICES]
Definition: ffv1.h:127
thread.h
FFV1Context::chroma_h_shift
int chroma_h_shift
Definition: ffv1.h:90
crc.h
FFV1Context::slice_rct_ry_coef
int slice_rct_ry_coef
Definition: ffv1.h:139
GetBitContext
Definition: get_bits.h:61
FFV1Context::sample_buffer32
int32_t * sample_buffer32
Definition: ffv1.h:111
CONTEXT_SIZE
#define CONTEXT_SIZE
Definition: ffv1.h:50
ff_ffv1_common_init
int ff_ffv1_common_init(AVCodecContext *avctx)
Definition: ffv1.c:41
FFV1Context::chroma_planes
int chroma_planes
Definition: ffv1.h:89
PlaneContext::context_count
int context_count
Definition: ffv1.h:70
FFV1Context::c
RangeCoder c
Definition: ffv1.h:81
avassert.h
FFV1Context::quant_tables
int16_t quant_tables[MAX_QUANT_TABLES][MAX_CONTEXT_INPUTS][256]
Definition: ffv1.h:104
FFV1Context::bits_per_raw_sample
int bits_per_raw_sample
Definition: ffv1.h:121
FFV1Context::use32bit
int use32bit
Definition: ffv1.h:113
FFV1Context::quant_table_count
int quant_table_count
Definition: ffv1.h:125
MAX_PLANES
#define MAX_PLANES
Definition: ffv1.h:49
FFV1Context::slice_count
int slice_count
Definition: ffv1.h:128
ff_ffv1_init_slice_state
int ff_ffv1_init_slice_state(FFV1Context *f, FFV1Context *fs)
Definition: ffv1.c:66
FFV1Context::ac_byte_count
int ac_byte_count
number of bytes used for AC coding
Definition: ffv1.h:101
FFV1Context::plane
PlaneContext plane[MAX_PLANES]
Definition: ffv1.h:102
FFV1Context::max_slice_count
int max_slice_count
Definition: ffv1.h:129
FFV1Context::slice_damaged
int slice_damaged
Definition: ffv1.h:117
bits
uint8_t bits
Definition: vp3data.h:141
FFV1Context::intra
int intra
Definition: ffv1.h:116
FFV1Context::quant_table
int16_t quant_table[MAX_CONTEXT_INPUTS][256]
Definition: ffv1.h:103
FFV1Context::fsrc
struct FFV1Context * fsrc
Definition: ffv1.h:96
FFV1Context::rc_stat
uint64_t rc_stat[256][2]
Definition: ffv1.h:84
ffv1_template.c
VlcState::error_sum
uint16_t error_sum
Definition: ffv1.h:62
get_bits.h
fold
static av_always_inline int fold(int diff, int bits)
Definition: ffv1.h:150
FFV1Context::ac
int ac
1=range coder <-> 0=golomb rice
Definition: ffv1.h:100
FFV1Context::plane_count
int plane_count
Definition: ffv1.h:99
f
#define f(width, name)
Definition: cbs_vp9.c:255
PutBitContext
Definition: put_bits.h:44
PlaneContext::interlace_bit_state
uint8_t interlace_bit_state[2]
Definition: ffv1.h:73
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:133
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
PlaneContext::vlc_state
VlcState * vlc_state
Definition: ffv1.h:72
fs
#define fs(width, name, subs,...)
Definition: cbs_vp9.c:259
FFV1Context::num_v_slices
int num_v_slices
Definition: ffv1.h:130
FFV1Context::colorspace
int colorspace
Definition: ffv1.h:109
ff_ffv1_clear_slice_state
void ff_ffv1_clear_slice_state(FFV1Context *f, FFV1Context *fs)
Definition: ffv1.c:173
FFV1Context::state_transition
uint8_t state_transition[256]
Definition: ffv1.h:106
mathops.h
PlaneContext
Definition: ffv1.h:67
FFV1Context::width
int width
Definition: ffv1.h:88
FFV1Context::slice_reset_contexts
int slice_reset_contexts
Definition: ffv1.h:136
VlcState
Definition: ffv1.h:60
FFV1Context::height
int height
Definition: ffv1.h:88
FFV1Context::slice_width
int slice_width
Definition: ffv1.h:132
FFV1Context::slice_rct_by_coef
int slice_rct_by_coef
Definition: ffv1.h:138
FFMAX
#define FFMAX(a, b)
Definition: common.h:103
FFV1Context::picture
ThreadFrame picture
Definition: ffv1.h:95
VlcState::count
uint8_t count
Definition: ffv1.h:64
FFV1Context::sample_buffer
int16_t * sample_buffer
Definition: ffv1.h:110
FFMIN
#define FFMIN(a, b)
Definition: common.h:105
ff_ffv1_init_slices_state
int ff_ffv1_init_slices_state(FFV1Context *f)
Definition: ffv1.c:105
PlaneContext::quant_table_index
int quant_table_index
Definition: ffv1.h:69
VlcState::drift
int16_t drift
Definition: ffv1.h:61
FFV1Context::initial_states
uint8_t(*[MAX_QUANT_TABLES] initial_states)[32]
Definition: ffv1.h:107
ff_ffv1_allocate_initial_states
int ff_ffv1_allocate_initial_states(FFV1Context *f)
Definition: ffv1.c:158
FFV1Context::gob_count
int gob_count
Definition: ffv1.h:124
av_always_inline
#define av_always_inline
Definition: attributes.h:49
FFV1Context::slice_y
int slice_y
Definition: ffv1.h:135
uint8_t
uint8_t
Definition: audio_convert.c:194
MAX_CONTEXT_INPUTS
#define MAX_CONTEXT_INPUTS
Definition: ffv1.h:53
ff_ffv1_close
int ff_ffv1_close(AVCodecContext *avctx)
Definition: ffv1.c:201
FFV1Context::packed_at_lsb
int packed_at_lsb
Definition: ffv1.h:122
avcodec.h
FFV1Context::avctx
AVCodecContext * avctx
Definition: ffv1.h:80
FFV1Context::picture_number
int picture_number
Definition: ffv1.h:93
FFV1Context::rc_stat2
uint64_t(*[MAX_QUANT_TABLES] rc_stat2)[32][2]
Definition: ffv1.h:85
AVCodecContext
main external API structure.
Definition: avcodec.h:536
VlcState::bias
int8_t bias
Definition: ffv1.h:63
ThreadFrame
Definition: thread.h:34
FFV1Context::context_model
int context_model
Definition: ffv1.h:119
FFV1Context::pb
PutBitContext pb
Definition: ffv1.h:83
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:94
ff_ffv1_init_slice_contexts
int ff_ffv1_init_slice_contexts(FFV1Context *f)
Definition: ffv1.c:116
MAX_QUANT_TABLES
#define MAX_QUANT_TABLES
Definition: ffv1.h:52
FFV1Context
Definition: ffv1.h:78
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:91
imgutils.h
FFV1Context::micro_version
int micro_version
Definition: ffv1.h:87
MAX_SLICES
#define MAX_SLICES
Definition: ffv1.h:76
FFV1Context::cur
AVFrame * cur
Definition: ffv1.h:98
RangeCoder
Definition: mss3.c:61
PlaneContext::quant_table
int16_t quant_table[MAX_CONTEXT_INPUTS][256]
Definition: ffv1.h:68
put_bits.h
FFV1Context::run_index
int run_index
Definition: ffv1.h:108
FFV1Context::version
int version
Definition: ffv1.h:86