frame.h 6.95 KB
Newer Older
1 2 3
/*****************************************************************************
 * frame.h: h264 encoder library
 *****************************************************************************
4
 * Copyright (C) 2003-2008 x264 project
5 6
 *
 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
7
 *          Loren Merritt <lorenm@u.washington.edu>
8 9 10 11 12 13 14 15 16 17 18 19 20
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
21
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111, USA.
22 23
 *****************************************************************************/

24 25
#ifndef X264_FRAME_H
#define X264_FRAME_H
26

27 28 29 30
/* number of pixels past the edge of the frame, for motion estimation/compensation */
#define PADH 32
#define PADV 32

31 32 33 34 35 36 37
typedef struct
{
    /* */
    int     i_poc;
    int     i_type;
    int     i_qpplus1;
    int64_t i_pts;
38 39
    x264_param_t *param;

40
    int     i_frame;    /* Presentation frame number */
41 42
    int     i_dts; /* Coded frame number */
    int     i_frame_num; /* 7.4.3 frame_num */
43
    int     b_kept_as_ref;
Steven Walters's avatar
Steven Walters committed
44 45 46
    uint8_t b_fdec;
    uint8_t b_last_minigop_bframe; /* this frame is the last b in a sequence of bframes */
    uint8_t i_bframes;   /* number of bframes following this nonb in coded order */
47 48
    float   f_qp_avg_rc; /* QPs as decided by ratecontrol */
    float   f_qp_avg_aq; /* QPs as decided by AQ in addition to ratecontrol */
49 50 51

    /* YUV buffer */
    int     i_plane;
52 53 54
    int     i_stride[3];
    int     i_width[3];
    int     i_lines[3];
55
    int     i_stride_lowres;
56
    int     i_width_lowres;
57
    int     i_lines_lowres;
58
    uint8_t *plane[3];
59
    uint8_t *filtered[4]; /* plane[0], H, V, HV */
60
    uint8_t *lowres[4]; /* half-size copy of input frame: Orig, H, V, HV */
61
    uint16_t *integral;
62 63 64

    /* for unrestricted mv we allocate more data than needed
     * allocated data are stored in buffer */
65 66
    uint8_t *buffer[4];
    uint8_t *buffer_lowres[4];
67

68
    /* motion data */
69
    int8_t  *mb_type;
70
    int16_t (*mv[2])[2];
71
    int16_t (*lowres_mvs[2][X264_BFRAME_MAX+1])[2];
72
    uint16_t (*lowres_costs[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2]);
73
    /* Actually a width-2 bitfield with 4 values per uint8_t. */
74
    uint8_t  (*lowres_inter_types[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2]);
75
    int     *lowres_mv_costs[2][X264_BFRAME_MAX+1];
76 77 78
    int8_t  *ref[2];
    int     i_ref[2];
    int     ref_poc[2][16];
79
    int     inv_ref_poc[16]; // inverse values (list0 only) to avoid divisions in MB encoding
80

81 82 83
    /* for adaptive B-frame decision.
     * contains the SATD cost of the lowres frame encoded in various modes
     * FIXME: how big an array do we need? */
84
    int     i_cost_est[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2];
85
    int     i_cost_est_aq[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2];
86 87 88 89 90 91
    int     i_satd; // the i_cost_est of the selected frametype
    int     i_intra_mbs[X264_BFRAME_MAX+2];
    int     *i_row_satds[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2];
    int     *i_row_satd;
    int     *i_row_bits;
    int     *i_row_qp;
92
    float   *f_qp_offset;
Fiona Glaser's avatar
Fiona Glaser committed
93
    float   *f_qp_offset_aq;
94 95
    int     b_intra_calculated;
    uint16_t *i_intra_cost;
Loren Merritt's avatar
Loren Merritt committed
96
    uint16_t *i_propagate_cost;
97
    uint16_t *i_inv_qscale_factor;
98
    int     b_scenecut; /* Set to zero if the frame cannot possibly be part of a real scenecut. */
99

Fiona Glaser's avatar
Fiona Glaser committed
100 101 102 103
    /* vbv */
    uint8_t i_planned_type[X264_LOOKAHEAD_MAX+1];
    int i_planned_satd[X264_LOOKAHEAD_MAX+1];

Loren Merritt's avatar
Loren Merritt committed
104 105 106
    /* threading */
    int     i_lines_completed; /* in pixels */
    int     i_reference_count; /* number of threads using this frame (not necessarily the number of pointers) */
Loren Merritt's avatar
Loren Merritt committed
107
    x264_pthread_mutex_t mutex;
108
    x264_pthread_cond_t  cv;
Loren Merritt's avatar
Loren Merritt committed
109

110 111
} x264_frame_t;

Steven Walters's avatar
Steven Walters committed
112 113 114 115 116 117 118 119 120 121 122
/* synchronized frame list */
typedef struct
{
   x264_frame_t **list;
   int i_max_size;
   int i_size;
   x264_pthread_mutex_t     mutex;
   x264_pthread_cond_t      cv_fill;  /* event signaling that the list became fuller */
   x264_pthread_cond_t      cv_empty; /* event signaling that the list became emptier */
} x264_synch_frame_list_t;

Loren Merritt's avatar
Loren Merritt committed
123 124 125 126 127 128 129 130 131 132 133 134 135 136
typedef void (*x264_deblock_inter_t)( uint8_t *pix, int stride, int alpha, int beta, int8_t *tc0 );
typedef void (*x264_deblock_intra_t)( uint8_t *pix, int stride, int alpha, int beta );
typedef struct
{
    x264_deblock_inter_t deblock_v_luma;
    x264_deblock_inter_t deblock_h_luma;
    x264_deblock_inter_t deblock_v_chroma;
    x264_deblock_inter_t deblock_h_chroma;
    x264_deblock_intra_t deblock_v_luma_intra;
    x264_deblock_intra_t deblock_h_luma_intra;
    x264_deblock_intra_t deblock_v_chroma_intra;
    x264_deblock_intra_t deblock_h_chroma_intra;
} x264_deblock_function_t;

Steven Walters's avatar
Steven Walters committed
137
x264_frame_t *x264_frame_new( x264_t *h, int b_fdec );
138 139
void          x264_frame_delete( x264_frame_t *frame );

140
int           x264_frame_copy_picture( x264_t *h, x264_frame_t *dst, x264_picture_t *src );
141

Loren Merritt's avatar
Loren Merritt committed
142 143
void          x264_frame_expand_border( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
void          x264_frame_expand_border_filtered( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
144
void          x264_frame_expand_border_lowres( x264_frame_t *frame );
145
void          x264_frame_expand_border_mod16( x264_t *h, x264_frame_t *frame );
146

Loren Merritt's avatar
Loren Merritt committed
147 148
void          x264_frame_deblock( x264_t *h );
void          x264_frame_deblock_row( x264_t *h, int mb_y );
149

150 151
void          x264_frame_filter( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
void          x264_frame_init_lowres( x264_t *h, x264_frame_t *frame );
152

Loren Merritt's avatar
Loren Merritt committed
153 154
void          x264_deblock_init( int cpu, x264_deblock_function_t *pf );

155
void          x264_frame_cond_broadcast( x264_frame_t *frame, int i_lines_completed );
156 157
void          x264_frame_cond_wait( x264_frame_t *frame, int i_lines_completed );

158 159 160 161 162
void          x264_frame_push( x264_frame_t **list, x264_frame_t *frame );
x264_frame_t *x264_frame_pop( x264_frame_t **list );
void          x264_frame_unshift( x264_frame_t **list, x264_frame_t *frame );
x264_frame_t *x264_frame_shift( x264_frame_t **list );
void          x264_frame_push_unused( x264_t *h, x264_frame_t *frame );
Steven Walters's avatar
Steven Walters committed
163
x264_frame_t *x264_frame_pop_unused( x264_t *h, int b_fdec );
164
void          x264_frame_sort( x264_frame_t **list, int b_dts );
Steven Walters's avatar
Steven Walters committed
165 166 167 168 169 170
void          x264_frame_delete_list( x264_frame_t **list );

int           x264_synch_frame_list_init( x264_synch_frame_list_t *slist, int nelem );
void          x264_synch_frame_list_delete( x264_synch_frame_list_t *slist );
void          x264_synch_frame_list_push( x264_synch_frame_list_t *slist, x264_frame_t *frame );

171 172 173
#define x264_frame_sort_dts(list) x264_frame_sort(list, 1)
#define x264_frame_sort_pts(list) x264_frame_sort(list, 0)

174
#endif