FFmpeg  4.3
h263.h
Go to the documentation of this file.
1 /*
2  * H.263 internal header
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 #ifndef AVCODEC_H263_H
21 #define AVCODEC_H263_H
22 
23 #include <stdint.h>
24 #include "libavutil/rational.h"
25 #include "get_bits.h"
26 #include "mpegvideo.h"
27 #include "h263data.h"
28 #include "rl.h"
29 
30 #define FF_ASPECT_EXTENDED 15
31 #define INT_BIT (CHAR_BIT * sizeof(int))
32 
33 // The defines below define the number of bits that are read at once for
34 // reading vlc values. Changing these may improve speed and data cache needs
35 // be aware though that decreasing them may need the number of stages that is
36 // passed to get_vlc* to be increased.
37 #define INTRA_MCBPC_VLC_BITS 6
38 #define INTER_MCBPC_VLC_BITS 7
39 #define CBPY_VLC_BITS 6
40 #define TEX_VLC_BITS 9
41 
42 #define H263_GOB_HEIGHT(h) ((h) <= 400 ? 1 : (h) <= 800 ? 2 : 4)
43 
46 extern VLC ff_h263_cbpy_vlc;
47 
49 
50 
51 int ff_h263_decode_motion(MpegEncContext * s, int pred, int f_code);
55  void *data, int *got_frame,
56  AVPacket *avpkt);
59  int16_t block[6][64],
60  int motion_x, int motion_y);
61 void ff_h263_encode_picture_header(MpegEncContext *s, int picture_number);
62 void ff_h263_encode_gob_header(MpegEncContext * s, int mb_line);
63 int16_t *ff_h263_pred_motion(MpegEncContext * s, int block, int dir,
64  int *px, int *py);
66 void ff_h263_decode_init_vlc(void);
74 int ff_h263_pred_dc(MpegEncContext * s, int n, int16_t **dc_val_ptr);
75 void ff_h263_pred_acdc(MpegEncContext * s, int16_t *block, int n);
76 
77 
78 /**
79  * Print picture info if FF_DEBUG_PICT_INFO is set.
80  */
82 
85  int16_t block[6][64]);
86 
87 /**
88  * Return the value of the 3-bit "source format" syntax element.
89  * This represents some standard picture dimensions or indicates that
90  * width&height are explicitly stored later.
91  */
93 
96 void ff_h263_encode_motion(PutBitContext *pb, int val, int f_code);
97 
98 
99 static inline int h263_get_motion_length(int val, int f_code){
100  int l, bit_size, code;
101 
102  if (val == 0) {
103  return ff_mvtab[0][1];
104  } else {
105  bit_size = f_code - 1;
106  /* modulo encoding */
107  l= INT_BIT - 6 - bit_size;
108  val = (val<<l)>>l;
109  val--;
110  code = (val >> bit_size) + 1;
111 
112  return ff_mvtab[code][1] + 1 + bit_size;
113  }
114 }
115 
116 static inline void ff_h263_encode_motion_vector(MpegEncContext * s, int x, int y, int f_code){
117  if (s->avctx->flags2 & AV_CODEC_FLAG2_NO_OUTPUT) {
118  skip_put_bits(&s->pb,
119  h263_get_motion_length(x, f_code)
120  +h263_get_motion_length(y, f_code));
121  }else{
122  ff_h263_encode_motion(&s->pb, x, f_code);
123  ff_h263_encode_motion(&s->pb, y, f_code);
124  }
125 }
126 
127 static inline int get_p_cbp(MpegEncContext * s,
128  int16_t block[6][64],
129  int motion_x, int motion_y){
130  int cbp, i;
131 
132  if (s->mpv_flags & FF_MPV_FLAG_CBP_RD) {
133  int best_cbpy_score= INT_MAX;
134  int best_cbpc_score= INT_MAX;
135  int cbpc = (-1), cbpy= (-1);
136  const int offset= (s->mv_type==MV_TYPE_16X16 ? 0 : 16) + (s->dquant ? 8 : 0);
137  const int lambda= s->lambda2 >> (FF_LAMBDA_SHIFT - 6);
138 
139  for(i=0; i<4; i++){
140  int score= ff_h263_inter_MCBPC_bits[i + offset] * lambda;
141  if(i&1) score += s->coded_score[5];
142  if(i&2) score += s->coded_score[4];
143 
144  if(score < best_cbpc_score){
145  best_cbpc_score= score;
146  cbpc= i;
147  }
148  }
149 
150  for(i=0; i<16; i++){
151  int score= ff_h263_cbpy_tab[i ^ 0xF][1] * lambda;
152  if(i&1) score += s->coded_score[3];
153  if(i&2) score += s->coded_score[2];
154  if(i&4) score += s->coded_score[1];
155  if(i&8) score += s->coded_score[0];
156 
157  if(score < best_cbpy_score){
158  best_cbpy_score= score;
159  cbpy= i;
160  }
161  }
162  cbp= cbpc + 4*cbpy;
163  if ((motion_x | motion_y | s->dquant) == 0 && s->mv_type==MV_TYPE_16X16){
164  if(best_cbpy_score + best_cbpc_score + 2*lambda >= 0)
165  cbp= 0;
166  }
167 
168  for (i = 0; i < 6; i++) {
169  if (s->block_last_index[i] >= 0 && ((cbp >> (5 - i))&1)==0 ){
170  s->block_last_index[i]= -1;
171  s->bdsp.clear_block(s->block[i]);
172  }
173  }
174  }else{
175  cbp= 0;
176  for (i = 0; i < 6; i++) {
177  if (s->block_last_index[i] >= 0)
178  cbp |= 1 << (5 - i);
179  }
180  }
181  return cbp;
182 }
183 
184 #endif /* AVCODEC_H263_H */
MV_TYPE_16X16
#define MV_TYPE_16X16
1 vector for the whole mb
Definition: mpegvideo.h:266
h263data.h
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
rational.h
ff_init_qscale_tab
void ff_init_qscale_tab(MpegEncContext *s)
init s->current_picture.qscale_table from s->lambda_table
Definition: mpegvideo_enc.c:218
av_const
#define av_const
Definition: attributes.h:84
data
const char data[16]
Definition: mxf.c:91
ff_h263_decode_mba
int ff_h263_decode_mba(MpegEncContext *s)
Definition: ituh263dec.c:139
h263_get_motion_length
static int h263_get_motion_length(int val, int f_code)
Definition: h263.h:99
mpegvideo.h
FF_LAMBDA_SHIFT
#define FF_LAMBDA_SHIFT
Definition: avutil.h:225
ff_h263_intra_MCBPC_vlc
VLC ff_h263_intra_MCBPC_vlc
Definition: ituh263dec.c:98
x
FFmpeg Automated Testing Environment ************************************Introduction Using FATE from your FFmpeg source directory Submitting the results to the FFmpeg result aggregation server Uploading new samples to the fate suite FATE makefile targets and variables Makefile targets Makefile variables Examples Introduction **************FATE is an extended regression suite on the client side and a means for results aggregation and presentation on the server side The first part of this document explains how you can use FATE from your FFmpeg source directory to test your ffmpeg binary The second part describes how you can run FATE to submit the results to FFmpeg’s FATE server In any way you can have a look at the publicly viewable FATE results by visiting this as it can be seen if some test on some platform broke with their recent contribution This usually happens on the platforms the developers could not test on The second part of this document describes how you can run FATE to submit your results to FFmpeg’s FATE server If you want to submit your results be sure to check that your combination of OS and compiler is not already listed on the above mentioned website In the third part you can find a comprehensive listing of FATE makefile targets and variables Using FATE from your FFmpeg source directory **********************************************If you want to run FATE on your machine you need to have the samples in place You can get the samples via the build target fate rsync Use this command from the top level source this will cause FATE to fail NOTE To use a custom wrapper to run the pass ‘ target exec’ to ‘configure’ or set the TARGET_EXEC Make variable Submitting the results to the FFmpeg result aggregation server ****************************************************************To submit your results to the server you should run fate through the shell script ‘tests fate sh’ from the FFmpeg sources This script needs to be invoked with a configuration file as its first argument tests fate sh path to fate_config A configuration file template with comments describing the individual configuration variables can be found at ‘doc fate_config sh template’ Create a configuration that suits your based on the configuration template The ‘slot’ configuration variable can be any string that is not yet but it is suggested that you name it adhering to the following pattern ‘ARCH OS COMPILER COMPILER VERSION’ The configuration file itself will be sourced in a shell therefore all shell features may be used This enables you to setup the environment as you need it for your build For your first test runs the ‘fate_recv’ variable should be empty or commented out This will run everything as normal except that it will omit the submission of the results to the server The following files should be present in $workdir as specified in the configuration it may help to try out the ‘ssh’ command with one or more ‘ v’ options You should get detailed output concerning your SSH configuration and the authentication process The only thing left is to automate the execution of the fate sh script and the synchronisation of the samples directory Uploading new samples to the fate suite *****************************************If you need a sample uploaded send a mail to samples request This is for developers who have an account on the fate suite server If you upload new please make sure they are as small as space on each network bandwidth and so on benefit from smaller test cases Also keep in mind older checkouts use existing sample that means in practice generally do not remove or overwrite files as it likely would break older checkouts or releases Also all needed samples for a commit should be ideally before the push If you need an account for frequently uploading samples or you wish to help others by doing that send a mail to ffmpeg devel rsync vauL Duo x
Definition: fate.txt:150
val
static double val(void *priv, double ch)
Definition: aeval.c:76
AV_CODEC_FLAG2_NO_OUTPUT
#define AV_CODEC_FLAG2_NO_OUTPUT
Skip bitstream encoding.
Definition: avcodec.h:352
ff_h263_pred_dc
int ff_h263_pred_dc(MpegEncContext *s, int n, int16_t **dc_val_ptr)
Definition: h263.c:94
h263_get_picture_format
int av_const h263_get_picture_format(int width, int height)
Return the value of the 3-bit "source format" syntax element.
ff_h263_decode_init_vlc
void ff_h263_decode_init_vlc(void)
Definition: ituh263dec.c:108
ff_h263_encode_init
void ff_h263_encode_init(MpegEncContext *s)
Definition: ituh263enc.c:761
width
#define width
s
#define s(width, name)
Definition: cbs_vp9.c:257
skip_put_bits
static void skip_put_bits(PutBitContext *s, int n)
Skip the given number of bits.
Definition: put_bits.h:346
get_p_cbp
static int get_p_cbp(MpegEncContext *s, int16_t block[6][64], int motion_x, int motion_y)
Definition: h263.h:127
get_bits.h
ff_h263_encode_picture_header
void ff_h263_encode_picture_header(MpegEncContext *s, int picture_number)
Definition: ituh263enc.c:103
ff_h263_encode_gob_header
void ff_h263_encode_gob_header(MpegEncContext *s, int mb_line)
Encode a group of blocks header.
Definition: ituh263enc.c:240
PutBitContext
Definition: put_bits.h:35
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
ff_h263_hwaccel_pixfmt_list_420
enum AVPixelFormat ff_h263_hwaccel_pixfmt_list_420[]
Definition: h263dec.c:729
ff_h263_update_motion_val
void ff_h263_update_motion_val(MpegEncContext *s)
Definition: h263.c:42
ff_h263_show_pict_info
void ff_h263_show_pict_info(MpegEncContext *s)
Print picture info if FF_DEBUG_PICT_INFO is set.
Definition: ituh263dec.c:76
ff_clean_h263_qscales
void ff_clean_h263_qscales(MpegEncContext *s)
modify qscale so that encoding is actually possible in H.263 (limit difference to -2....
Definition: ituh263enc.c:266
ff_h263_encode_mba
void ff_h263_encode_mba(MpegEncContext *s)
Definition: ituh263enc.c:825
ff_intel_h263_decode_picture_header
int ff_intel_h263_decode_picture_header(MpegEncContext *s)
Definition: intelh263dec.c:27
ff_h263_loop_filter
void ff_h263_loop_filter(MpegEncContext *s)
Definition: h263.c:135
ff_h263_decode_motion
int ff_h263_decode_motion(MpegEncContext *s, int pred, int f_code)
Definition: ituh263dec.c:270
ff_h263_resync
int ff_h263_resync(MpegEncContext *s)
Decode the group of blocks / video packet header / slice header (MPEG-4 Studio).
Definition: ituh263dec.c:213
ff_h263_cbpy_tab
const uint8_t ff_h263_cbpy_tab[16][2]
Definition: h263data.c:84
height
#define height
offset
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf offset
Definition: writing_filters.txt:86
ff_h263_inter_MCBPC_bits
const uint8_t ff_h263_inter_MCBPC_bits[28]
Definition: h263data.c:49
ff_h263_decode_init
int ff_h263_decode_init(AVCodecContext *avctx)
Definition: h263dec.c:68
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:269
code
and forward the test the status of outputs and forward it to the corresponding return FFERROR_NOT_READY If the filters stores internally one or a few frame for some it can consider them to be part of the FIFO and delay acknowledging a status change accordingly Example code
Definition: filter_design.txt:178
ff_h263_decode_end
int ff_h263_decode_end(AVCodecContext *avctx)
Definition: h263dec.c:155
ff_h263_cbpy_vlc
VLC ff_h263_cbpy_vlc
Definition: ituh263dec.c:100
ff_h263_decode_gob_header
int ff_h263_decode_gob_header(MpegEncContext *s)
ff_h263_aspect_to_info
av_const int ff_h263_aspect_to_info(AVRational aspect)
Return the 4 bit value that specifies the given aspect ratio.
Definition: ituh263enc.c:89
pred
static const float pred[4]
Definition: siprdata.h:259
FF_MPV_FLAG_CBP_RD
#define FF_MPV_FLAG_CBP_RD
Definition: mpegvideo.h:591
ff_h263_decode_picture_header
int ff_h263_decode_picture_header(MpegEncContext *s)
Definition: ituh263dec.c:999
ff_mvtab
const uint8_t ff_mvtab[33][2]
Definition: h263data.c:90
AVCodecContext
main external API structure.
Definition: avcodec.h:526
VLC
Definition: vlc.h:26
ff_h263_pred_motion
int16_t * ff_h263_pred_motion(MpegEncContext *s, int block, int dir, int *px, int *py)
Definition: h263.c:307
ff_h263_pred_acdc
void ff_h263_pred_acdc(MpegEncContext *s, int16_t *block, int n)
Definition: h263.c:220
INT_BIT
#define INT_BIT
Definition: h263.h:31
ff_h263_encode_motion_vector
static void ff_h263_encode_motion_vector(MpegEncContext *s, int x, int y, int f_code)
Definition: h263.h:116
ff_h263_decode_frame
int ff_h263_decode_frame(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
Definition: h263dec.c:421
AVPacket
This structure stores compressed data.
Definition: packet.h:332
rl.h
block
The exact code depends on how similar the blocks are and how related they are to the block
Definition: filter_design.txt:207
ff_h263_decode_mb
int ff_h263_decode_mb(MpegEncContext *s, int16_t block[6][64])
Definition: ituh263dec.c:697
MpegEncContext
MpegEncContext.
Definition: mpegvideo.h:81
ff_h263_encode_mb
void ff_h263_encode_mb(MpegEncContext *s, int16_t block[6][64], int motion_x, int motion_y)
Definition: ituh263enc.c:447
ff_h263_encode_motion
void ff_h263_encode_motion(PutBitContext *pb, int val, int f_code)
Definition: ituh263enc.c:646
ff_h263_inter_MCBPC_vlc
VLC ff_h263_inter_MCBPC_vlc
Definition: ituh263dec.c:99