1 /*****************************************************************************
2 * frame.h: h264 encoder library
3 *****************************************************************************
4 * Copyright (C) 2003-2008 x264 project
6 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
7 * Loren Merritt <lorenm@u.washington.edu>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111, USA.
22 *****************************************************************************/
27 /* number of pixels past the edge of the frame, for motion estimation/compensation */
31 typedef struct x264_frame
38 int64_t i_reordered_pts;
41 int i_frame; /* Presentation frame number */
42 int i_coded; /* Coded frame number */
43 int i_frame_num; /* 7.4.3 frame_num */
47 uint8_t b_last_minigop_bframe; /* this frame is the last b in a sequence of bframes */
48 uint8_t i_bframes; /* number of bframes following this nonb in coded order */
49 float f_qp_avg_rc; /* QPs as decided by ratecontrol */
50 float f_qp_avg_aq; /* QPs as decided by AQ in addition to ratecontrol */
61 uint8_t *filtered[4]; /* plane[0], H, V, HV */
62 uint8_t *lowres[4]; /* half-size copy of input frame: Orig, H, V, HV */
65 /* for unrestricted mv we allocate more data than needed
66 * allocated data are stored in buffer */
68 uint8_t *buffer_lowres[4];
70 x264_weight_t weight[16][3]; /* [ref_index][plane] */
71 uint8_t *weighted[16]; /* plane[0] weighted of the reference frames */
73 struct x264_frame *orig;
78 int16_t (*lowres_mvs[2][X264_BFRAME_MAX+1])[2];
79 uint16_t (*lowres_costs[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2]);
80 /* Actually a width-2 bitfield with 4 values per uint8_t. */
81 uint8_t (*lowres_inter_types[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2]);
82 int *lowres_mv_costs[2][X264_BFRAME_MAX+1];
86 int inv_ref_poc[16]; // inverse values (list0 only) to avoid divisions in MB encoding
88 /* for adaptive B-frame decision.
89 * contains the SATD cost of the lowres frame encoded in various modes
90 * FIXME: how big an array do we need? */
91 int i_cost_est[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2];
92 int i_cost_est_aq[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2];
93 int i_satd; // the i_cost_est of the selected frametype
94 int i_intra_mbs[X264_BFRAME_MAX+2];
95 int *i_row_satds[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2];
100 float *f_qp_offset_aq;
101 int b_intra_calculated;
102 uint16_t *i_intra_cost;
103 uint16_t *i_propagate_cost;
104 uint16_t *i_inv_qscale_factor;
105 int b_scenecut; /* Set to zero if the frame cannot possibly be part of a real scenecut. */
106 float f_weighted_cost_delta[X264_BFRAME_MAX+2];
107 uint32_t i_pixel_sum;
108 uint64_t i_pixel_ssd;
111 uint8_t i_planned_type[X264_LOOKAHEAD_MAX+1];
112 int i_planned_satd[X264_LOOKAHEAD_MAX+1];
115 int i_lines_completed; /* in pixels */
116 int i_lines_weighted; /* FIXME: this only supports weighting of one reference frame */
117 int i_reference_count; /* number of threads using this frame (not necessarily the number of pointers) */
118 x264_pthread_mutex_t mutex;
119 x264_pthread_cond_t cv;
121 /* periodic intra refresh */
122 float f_pir_position;
127 /* synchronized frame list */
133 x264_pthread_mutex_t mutex;
134 x264_pthread_cond_t cv_fill; /* event signaling that the list became fuller */
135 x264_pthread_cond_t cv_empty; /* event signaling that the list became emptier */
136 } x264_synch_frame_list_t;
138 typedef void (*x264_deblock_inter_t)( uint8_t *pix, int stride, int alpha, int beta, int8_t *tc0 );
139 typedef void (*x264_deblock_intra_t)( uint8_t *pix, int stride, int alpha, int beta );
142 x264_deblock_inter_t deblock_v_luma;
143 x264_deblock_inter_t deblock_h_luma;
144 x264_deblock_inter_t deblock_v_chroma;
145 x264_deblock_inter_t deblock_h_chroma;
146 x264_deblock_intra_t deblock_v_luma_intra;
147 x264_deblock_intra_t deblock_h_luma_intra;
148 x264_deblock_intra_t deblock_v_chroma_intra;
149 x264_deblock_intra_t deblock_h_chroma_intra;
150 } x264_deblock_function_t;
152 x264_frame_t *x264_frame_new( x264_t *h, int b_fdec );
153 void x264_frame_delete( x264_frame_t *frame );
155 int x264_frame_copy_picture( x264_t *h, x264_frame_t *dst, x264_picture_t *src );
157 void x264_frame_expand_border( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
158 void x264_frame_expand_border_filtered( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
159 void x264_frame_expand_border_lowres( x264_frame_t *frame );
160 void x264_frame_expand_border_mod16( x264_t *h, x264_frame_t *frame );
162 void x264_frame_deblock( x264_t *h );
163 void x264_frame_deblock_row( x264_t *h, int mb_y );
165 void x264_frame_filter( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
166 void x264_frame_init_lowres( x264_t *h, x264_frame_t *frame );
168 void x264_deblock_init( int cpu, x264_deblock_function_t *pf );
170 void x264_frame_cond_broadcast( x264_frame_t *frame, int i_lines_completed );
171 void x264_frame_cond_wait( x264_frame_t *frame, int i_lines_completed );
173 void x264_frame_push( x264_frame_t **list, x264_frame_t *frame );
174 x264_frame_t *x264_frame_pop( x264_frame_t **list );
175 void x264_frame_unshift( x264_frame_t **list, x264_frame_t *frame );
176 x264_frame_t *x264_frame_shift( x264_frame_t **list );
177 void x264_frame_push_unused( x264_t *h, x264_frame_t *frame );
178 void x264_frame_push_blank_unused( x264_t *h, x264_frame_t *frame );
179 x264_frame_t *x264_frame_pop_blank_unused( x264_t *h );
180 void x264_weight_scale_plane( x264_t *h, uint8_t *dst, int i_dst_stride, uint8_t *src, int i_src_stride,
181 int i_width, int i_height, x264_weight_t *w );
182 x264_frame_t *x264_frame_pop_unused( x264_t *h, int b_fdec );
183 void x264_frame_sort( x264_frame_t **list, int b_dts );
184 void x264_frame_delete_list( x264_frame_t **list );
186 int x264_synch_frame_list_init( x264_synch_frame_list_t *slist, int nelem );
187 void x264_synch_frame_list_delete( x264_synch_frame_list_t *slist );
188 void x264_synch_frame_list_push( x264_synch_frame_list_t *slist, x264_frame_t *frame );
190 #define x264_frame_sort_dts(list) x264_frame_sort(list, 1)
191 #define x264_frame_sort_pts(list) x264_frame_sort(list, 0)