]> git.sesse.net Git - x264/blob - common/frame.h
e7693af68f258cf6fc0ed4df22a731196643a9a6
[x264] / common / frame.h
1 /*****************************************************************************
2  * frame.h: h264 encoder library
3  *****************************************************************************
4  * Copyright (C) 2003 Laurent Aimar
5  * $Id: frame.h,v 1.1 2004/06/03 19:27:06 fenrir Exp $
6  *
7  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
8  *
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.
13  *
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.
18  *
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., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
22  *****************************************************************************/
23
24 #ifndef _FRAME_H
25 #define _FRAME_H 1
26
27 /* number of pixels past the edge of the frame, for motion estimation/compensation */
28 #define PADH 32
29 #define PADV 32
30
31 typedef struct
32 {
33     /* */
34     int     i_poc;
35     int     i_type;
36     int     i_qpplus1;
37     int64_t i_pts;
38     int     i_frame;    /* Presentation frame number */
39     int     i_frame_num; /* Coded frame number */
40     int     b_kept_as_ref;
41     float   f_qp_avg;
42
43     /* YUV buffer */
44     int     i_plane;
45     int     i_stride[3];
46     int     i_width[3];
47     int     i_lines[3];
48     int     i_stride_lowres;
49     int     i_width_lowres;
50     int     i_lines_lowres;
51     uint8_t *plane[3];
52     uint8_t *filtered[4]; /* plane[0], H, V, HV */
53     uint8_t *lowres[4]; /* half-size copy of input frame: Orig, H, V, HV */
54     uint16_t *integral;
55
56     /* for unrestricted mv we allocate more data than needed
57      * allocated data are stored in buffer */
58     void    *buffer[8];
59     void    *buffer_lowres[4];
60
61     /* motion data */
62     int8_t  *mb_type;
63     int16_t (*mv[2])[2];
64     int8_t  *ref[2];
65     int     i_ref[2];
66     int     ref_poc[2][16];
67     int     inv_ref_poc[16]; // inverse values (list0 only) to avoid divisions in MB encoding
68
69     /* for adaptive B-frame decision.
70      * contains the SATD cost of the lowres frame encoded in various modes
71      * FIXME: how big an array do we need? */
72     int     i_cost_est[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2];
73     int     i_satd; // the i_cost_est of the selected frametype
74     int     i_intra_mbs[X264_BFRAME_MAX+2];
75     int     *i_row_satds[X264_BFRAME_MAX+2][X264_BFRAME_MAX+2];
76     int     *i_row_satd;
77     int     *i_row_bits;
78     int     *i_row_qp;
79
80     /* threading */
81     int     i_lines_completed; /* in pixels */
82     int     i_reference_count; /* number of threads using this frame (not necessarily the number of pointers) */
83     x264_pthread_mutex_t mutex;      
84     x264_pthread_cond_t  cv;
85
86 } x264_frame_t;
87
88 typedef void (*x264_deblock_inter_t)( uint8_t *pix, int stride, int alpha, int beta, int8_t *tc0 );
89 typedef void (*x264_deblock_intra_t)( uint8_t *pix, int stride, int alpha, int beta );
90 typedef struct
91 {
92     x264_deblock_inter_t deblock_v_luma;
93     x264_deblock_inter_t deblock_h_luma;
94     x264_deblock_inter_t deblock_v_chroma;
95     x264_deblock_inter_t deblock_h_chroma;
96     x264_deblock_intra_t deblock_v_luma_intra;
97     x264_deblock_intra_t deblock_h_luma_intra;
98     x264_deblock_intra_t deblock_v_chroma_intra;
99     x264_deblock_intra_t deblock_h_chroma_intra;
100 } x264_deblock_function_t;
101
102 x264_frame_t *x264_frame_new( x264_t *h );
103 void          x264_frame_delete( x264_frame_t *frame );
104
105 int           x264_frame_copy_picture( x264_t *h, x264_frame_t *dst, x264_picture_t *src );
106
107 void          x264_frame_expand_border( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
108 void          x264_frame_expand_border_filtered( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
109 void          x264_frame_expand_border_lowres( x264_frame_t *frame );
110 void          x264_frame_expand_border_mod16( x264_t *h, x264_frame_t *frame );
111
112 void          x264_frame_deblock( x264_t *h );
113 void          x264_frame_deblock_row( x264_t *h, int mb_y );
114
115 void          x264_frame_filter( x264_t *h, x264_frame_t *frame, int mb_y, int b_end );
116 void          x264_frame_init_lowres( x264_t *h, x264_frame_t *frame );
117
118 void          x264_deblock_init( int cpu, x264_deblock_function_t *pf );
119
120 void          x264_frame_cond_broadcast( x264_frame_t *frame, int i_lines_completed );
121 void          x264_frame_cond_wait( x264_frame_t *frame, int i_lines_completed );
122
123 void          x264_frame_push( x264_frame_t **list, x264_frame_t *frame );
124 x264_frame_t *x264_frame_pop( x264_frame_t **list );
125 void          x264_frame_unshift( x264_frame_t **list, x264_frame_t *frame );
126 x264_frame_t *x264_frame_shift( x264_frame_t **list );
127 void          x264_frame_push_unused( x264_t *h, x264_frame_t *frame );
128 x264_frame_t *x264_frame_pop_unused( x264_t *h );
129 void          x264_frame_sort( x264_frame_t **list, int b_dts );
130 #define x264_frame_sort_dts(list) x264_frame_sort(list, 1)
131 #define x264_frame_sort_pts(list) x264_frame_sort(list, 0)
132
133 #endif