rate_control.h revision 59f566c4ec3dfc097ad8163523e522280b27e5c3 
1/* ------------------------------------------------------------------
2 * Copyright (C) 1998-2009 PacketVideo
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
13 * express or implied.
14 * See the License for the specific language governing permissions
15 * and limitations under the License.
16 * -------------------------------------------------------------------
17 */
18#ifndef _RATE_CONTROL_H_
19#define _RATE_CONTROL_H_
20
21#include "mp4def.h"
22
23typedef struct tagdataPointArray
24{
25    Int Qp;
26    Int Rp;
27    float Mp;   /* for MB-based RC, 3/14/01 */
28    struct tagdataPointArray *next;
29    struct tagdataPointArray *prev;
30} dataPointArray;
31
32
33typedef struct
34{
35    Int alpha;  /* weight for I frame */
36    Int Rs;     /*bit rate for the sequence (or segment) e.g., 24000 bits/sec */
37    Int Rc;     /*bits used for the current frame. It is the bit count obtained after encoding. */
38    Int Rp;     /*bits to be removed from the buffer per picture. */
39    /*? is this the average one, or just the bits coded for the previous frame */
40    Int Rps;    /*bit to be removed from buffer per src frame */
41    float Ts;   /*number of seconds for the sequence  (or segment). e.g., 10 sec */
42    float Ep;
43    float Ec;   /*mean absolute difference for the current frame after motion compensation.*/
44    /*If the macroblock is intra coded, the original spatial pixel values are summed.*/
45    Int Qc;     /*quantization level used for the current frame. */
46    Int Nr;     /*number of P frames remaining for encoding.*/
47    Int Rr; /*number of bits remaining for encoding this sequence (or segment).*/
48    Int Rr_Old;/* 12/24/00 */
49    Int T;      /*target bit to be used for the current frame.*/
50    Int S;      /*number of bits used for encoding the previous frame.*/
51    Int Hc; /*header and motion vector bits used in the current frame. It includes all the  information except to the residual information.*/
52    Int Hp; /*header and motion vector bits used in the previous frame. It includes all the     information except to the residual information.*/
53    Int Ql; /*quantization level used in the previous frame */
54    Int Bs; /*buffer size e.g., R/2 */
55    Int B;      /*current buffer level e.g., R/4 - start from the middle of the buffer */
56    float X1;
57    float X2;
58    float X11;
59    float M;            /*safe margin for the buffer */
60    float smTick;    /*ratio of src versus enc frame rate */
61    double remnant;  /*remainder frame of src/enc frame for fine frame skipping */
62    Int timeIncRes; /* vol->timeIncrementResolution */
63
64    dataPointArray   *end; /*quantization levels for the past (20) frames */
65
66    Int     frameNumber; /* ranging from 0 to 20 nodes*/
67    Int     w;
68    Int     Nr_Original;
69    Int     Nr_Old, Nr_Old2;
70    Int     skip_next_frame;
71    Int     Qdep;       /* smooth Q adjustment */
72    Int     fine_frame_skip;
73    Int     VBR_Enabled;
74    Int     no_frame_skip;
75    Int     no_pre_skip;
76
77    Int totalFrameNumber; /* total coded frames, for debugging!!*/
78
79    char    oFirstTime;
80
81    /* BX rate control */
82    Int     TMN_W;
83    Int     TMN_TH;
84    Int     VBV_fullness;
85    Int     max_BitVariance_num; /* the number of the maximum bit variance within the given buffer with the unit of 10% of bitrate/framerate*/
86    Int     encoded_frames; /* counter for all encoded frames */
87    float   framerate;
88    Int     bitrate;
89    Int     low_bound;              /* bound for underflow detection, usually low_bound=-Bs/2, but could be changed in H.263 mode */
90    Int     VBV_fullness_offset;    /* offset of VBV_fullness, usually is zero, but can be changed in H.263 mode*/
91    /* End BX */
92
93} rateControl;
94
95
96#endif /* _RATE_CONTROL_H_ */
97