libhb/internal.h

   1 /* $Id: internal.h,v 1.41 2005/11/25 15:05:25 titer Exp $
   2
   3    This file is part of the HandBrake source code.
   4    Homepage: <http://handbrake.fr/>.
   5    It may be used under the terms of the GNU General Public License. */
   6
   7 /***********************************************************************
   8  * common.c
   9  **********************************************************************/
  10 void hb_log( char * log, ... ) HB_WPRINTF(1,2);
  11 extern int global_verbosity_level; // Global variable for hb_deep_log
  12 typedef enum hb_debug_level_s
  13 {
  14     HB_SUPPORT_LOG      = 1, // helpful in tech support
  15     HB_HOUSEKEEPING_LOG = 2, // stuff we hate scrolling through
  16     HB_GRANULAR_LOG     = 3  // sample-by-sample
  17 } hb_debug_level_t;
  18 void hb_deep_log( hb_debug_level_t level, char * log, ... ) HB_WPRINTF(2,3);
  19 void hb_error( char * fmt, ...) HB_WPRINTF(1,2);
  20
  21 int  hb_list_bytes( hb_list_t * );
  22 void hb_list_seebytes( hb_list_t * l, uint8_t * dst, int size );
  23 void hb_list_getbytes( hb_list_t * l, uint8_t * dst, int size,
  24                        uint64_t * pts, uint64_t * pos );
  25 void hb_list_empty( hb_list_t ** );
  26
  27 hb_title_t * hb_title_init( char * dvd, int index );
  28 void         hb_title_close( hb_title_t ** );
  29
  30 void         hb_filter_close( hb_filter_object_t ** );
  31
  32 /***********************************************************************
  33  * hb.c
  34  **********************************************************************/
  35 int  hb_get_pid( hb_handle_t * );
  36 void hb_set_state( hb_handle_t *, hb_state_t * );
  37
  38 /***********************************************************************
  39  * fifo.c
  40  **********************************************************************/
  41 struct hb_buffer_s
  42 {
  43     int           size;
  44     int           alloc;
  45     uint8_t *     data;
  46     int           cur;
  47
  48     int64_t       sequence;
  49
  50     int           id;
  51     int64_t       start;
  52     int64_t       stop;
  53     int           new_chap;
  54
  55 #define HB_FRAME_IDR    0x01
  56 #define HB_FRAME_I      0x02
  57 #define HB_FRAME_AUDIO  0x04
  58 #define HB_FRAME_P      0x10
  59 #define HB_FRAME_B      0x20
  60 #define HB_FRAME_BREF   0x40
  61 #define HB_FRAME_KEY    0x0F
  62 #define HB_FRAME_REF    0xF0
  63     uint8_t       frametype;
  64     uint16_t       flags;
  65
  66     /* Holds the output PTS from x264, for use by b-frame offsets in muxmp4.c */
  67     int64_t     renderOffset;
  68
  69     int           x;
  70     int           y;
  71     int           width;
  72     int           height;
  73
  74     hb_buffer_t * sub;
  75
  76     hb_buffer_t * next;
  77 };
  78
  79 void hb_buffer_pool_init( void );
  80 void hb_buffer_pool_free( void );
  81
  82 hb_buffer_t * hb_buffer_init( int size );
  83 void          hb_buffer_realloc( hb_buffer_t *, int size );
  84 void          hb_buffer_close( hb_buffer_t ** );
  85 void          hb_buffer_copy_settings( hb_buffer_t * dst,
  86                                        const hb_buffer_t * src );
  87
  88 hb_fifo_t   * hb_fifo_init( int capacity, int thresh );
  89 int           hb_fifo_size( hb_fifo_t * );
  90 int           hb_fifo_is_full( hb_fifo_t * );
  91 float         hb_fifo_percent_full( hb_fifo_t * f );
  92 hb_buffer_t * hb_fifo_get( hb_fifo_t * );
  93 hb_buffer_t * hb_fifo_get_wait( hb_fifo_t * );
  94 hb_buffer_t * hb_fifo_see( hb_fifo_t * );
  95 hb_buffer_t * hb_fifo_see_wait( hb_fifo_t * );
  96 hb_buffer_t * hb_fifo_see2( hb_fifo_t * );
  97 void          hb_fifo_push( hb_fifo_t *, hb_buffer_t * );
  98 void          hb_fifo_push_wait( hb_fifo_t *, hb_buffer_t * );
  99 void          hb_fifo_push_head( hb_fifo_t *, hb_buffer_t * );
 100 void          hb_fifo_close( hb_fifo_t ** );
 101 void          hb_fifo_flush( hb_fifo_t * f );
 102
 103 // this routine gets a buffer for an uncompressed YUV420 video frame
 104 // with dimensions width x height.
 105 static inline hb_buffer_t * hb_video_buffer_init( int width, int height )
 106 {
 107     // Y requires w x h bytes. U & V each require (w+1)/2 x
 108     // (h+1)/2 bytes (the "+1" is to round up). We shift rather
 109     // than divide by 2 since the compiler can't know these ints
 110     // are positive so it generates very expensive integer divides
 111     // if we do "/2". The code here matches the calculation for
 112     // PIX_FMT_YUV420P in ffmpeg's avpicture_fill() which is required
 113     // for most of HB's filters to work right.
 114     return hb_buffer_init( width * height + ( ( width+1 ) >> 1 ) *
 115                            ( ( height+1 ) >> 1 ) * 2 );
 116 }
 117
 118 // this routine 'moves' data from src to dst by interchanging 'data',
 119 // 'size' & 'alloc' between them and copying the rest of the fields
 120 // from src to dst.
 121 static inline void hb_buffer_swap_copy( hb_buffer_t *src, hb_buffer_t *dst )
 122 {
 123     uint8_t *data  = dst->data;
 124     int      size  = dst->size;
 125     int      alloc = dst->alloc;
 126
 127     *dst = *src;
 128
 129     src->data  = data;
 130     src->size  = size;
 131     src->alloc = alloc;
 132 }
 133
 134 /***********************************************************************
 135  * Threads: update.c, scan.c, work.c, reader.c, muxcommon.c
 136  **********************************************************************/
 137 hb_thread_t * hb_update_init( int * build, char * version );
 138 hb_thread_t * hb_scan_init( hb_handle_t *, volatile int * die,
 139                             const char * path, int title_index,
 140                             hb_list_t * list_title, int preview_count,
 141                             int store_previews );
 142 hb_thread_t * hb_work_init( hb_list_t * jobs, int cpu_count,
 143                             volatile int * die, int * error, hb_job_t ** job );
 144 hb_thread_t  * hb_reader_init( hb_job_t * );
 145 hb_work_object_t * hb_muxer_init( hb_job_t * );
 146 hb_work_object_t * hb_get_work( int );
 147 hb_work_object_t * hb_codec_decoder( int );
 148 hb_work_object_t * hb_codec_encoder( int );
 149
 150 /***********************************************************************
 151  * sync.c
 152  **********************************************************************/
 153 int hb_sync_init( hb_job_t * job );
 154
 155 /***********************************************************************
 156  * mpegdemux.c
 157  **********************************************************************/
 158 typedef struct {
 159     int64_t last_scr;       /* unadjusted SCR from most recent pack */
 160     int64_t last_pts;       /* last pts we saw */
 161     int     scr_changes;    /* number of SCR discontinuities */
 162     int     dts_drops;      /* number of drops because DTS too far from SCR */
 163 } hb_psdemux_t;
 164
 165 typedef int (*hb_muxer_t)(hb_buffer_t *, hb_list_t *, hb_psdemux_t*);
 166
 167 int hb_demux_ps( hb_buffer_t * ps_buf, hb_list_t * es_list, hb_psdemux_t * );
 168 int hb_demux_ss( hb_buffer_t * ps_buf, hb_list_t * es_list, hb_psdemux_t * );
 169 int hb_demux_null( hb_buffer_t * ps_buf, hb_list_t * es_list, hb_psdemux_t * );
 170
 171 extern const hb_muxer_t hb_demux[];
 172
 173 /***********************************************************************
 174  * decmetadata.c
 175  **********************************************************************/
 176 extern void decmetadata( hb_title_t *title );
 177
 178 /***********************************************************************
 179  * batch.c
 180  **********************************************************************/
 181 typedef struct hb_batch_s hb_batch_t;
 182
 183 hb_batch_t  * hb_batch_init( char * path );
 184 void          hb_batch_close( hb_batch_t ** _d );
 185 int           hb_batch_title_count( hb_batch_t * d );
 186 hb_title_t  * hb_batch_title_scan( hb_batch_t * d, int t );
 187
 188 /***********************************************************************
 189  * dvd.c
 190  **********************************************************************/
 191 typedef union  hb_dvd_s hb_dvd_t;
 192 typedef struct hb_stream_s hb_stream_t;
 193
 194 hb_dvd_t *   hb_dvd_init( char * path );
 195 int          hb_dvd_title_count( hb_dvd_t * );
 196 hb_title_t * hb_dvd_title_scan( hb_dvd_t *, int title );
 197 int          hb_dvd_start( hb_dvd_t *, hb_title_t *title, int chapter );
 198 void         hb_dvd_stop( hb_dvd_t * );
 199 int          hb_dvd_seek( hb_dvd_t *, float );
 200 int          hb_dvd_read( hb_dvd_t *, hb_buffer_t * );
 201 int          hb_dvd_chapter( hb_dvd_t * );
 202 int          hb_dvd_is_break( hb_dvd_t * d );
 203 void         hb_dvd_close( hb_dvd_t ** );
 204 int          hb_dvd_angle_count( hb_dvd_t * d );
 205 void         hb_dvd_set_angle( hb_dvd_t * d, int angle );
 206
 207 hb_stream_t * hb_stream_open( char * path, hb_title_t *title );
 208 void             hb_stream_close( hb_stream_t ** );
 209 hb_title_t * hb_stream_title_scan( hb_stream_t *);
 210 int          hb_stream_read( hb_stream_t *, hb_buffer_t *);
 211 int          hb_stream_seek( hb_stream_t *, float );
 212 int          hb_stream_seek_chapter( hb_stream_t *, int );
 213 int          hb_stream_chapter( hb_stream_t * );
 214
 215
 216 void       * hb_ffmpeg_context( int codec_param );
 217 void       * hb_ffmpeg_avstream( int codec_param );
 218
 219 /***********************************************************************
 220  * Work objects
 221  **********************************************************************/
 222 #define HB_CONFIG_MAX_SIZE 8192
 223 union hb_esconfig_u
 224 {
 225
 226     struct
 227     {
 228         uint8_t bytes[HB_CONFIG_MAX_SIZE];
 229         int     length;
 230     } mpeg4;
 231
 232         struct
 233         {
 234             uint8_t  sps[HB_CONFIG_MAX_SIZE];
 235             int       sps_length;
 236             uint8_t  pps[HB_CONFIG_MAX_SIZE];
 237             int       pps_length;
 238         uint32_t init_delay;
 239         } h264;
 240
 241     struct
 242     {
 243         uint8_t headers[3][HB_CONFIG_MAX_SIZE];
 244     } theora;
 245
 246     struct
 247     {
 248         uint8_t bytes[HB_CONFIG_MAX_SIZE];
 249         int     length;
 250     } aac;
 251
 252     struct
 253     {
 254         uint8_t headers[3][HB_CONFIG_MAX_SIZE];
 255         char *language;
 256     } vorbis;
 257
 258     struct
 259     {
 260         /* ac3flags stores the flags from the AC3 source, as found in scan.c */
 261         int     ac3flags;
 262         // next two items are used by the bsinfo routine to accumulate small
 263         // frames until we have enough to validate the crc.
 264         int     len;        // space currently used in 'buf'
 265         uint8_t buf[HB_CONFIG_MAX_SIZE-sizeof(int)];
 266     } a52;
 267
 268     struct
 269     {
 270         /* dcaflags stores the flags from the DCA source, as found in scan.c */
 271         int  dcaflags;
 272     } dca;
 273
 274 };
 275
 276 enum
 277 {
 278     WORK_SYNC_VIDEO = 1,
 279     WORK_SYNC_AUDIO,
 280     WORK_DECMPEG2,
 281     WORK_DECCC608,
 282     WORK_DECVOBSUB,
 283     WORK_DECSRTSUB,
 284     WORK_ENCVOBSUB,
 285     WORK_RENDER,
 286     WORK_ENCAVCODEC,
 287     WORK_ENCX264,
 288     WORK_ENCTHEORA,
 289     WORK_DECA52,
 290     WORK_DECDCA,
 291     WORK_DECAVCODEC,
 292     WORK_DECAVCODECV,
 293     WORK_DECAVCODECVI,
 294     WORK_DECAVCODECAI,
 295     WORK_DECLPCM,
 296     WORK_ENCFAAC,
 297     WORK_ENCLAME,
 298     WORK_ENCVORBIS,
 299     WORK_ENC_CA_AAC,
 300     WORK_MUX
 301 };
 302
 303 enum
 304 {
 305     FILTER_DEINTERLACE = 1,
 306     FILTER_DEBLOCK,
 307     FILTER_DENOISE,
 308     FILTER_DETELECINE,
 309     FILTER_DECOMB
 310 };
 311
 312 extern hb_work_object_t * hb_objects;
 313
 314 #define HB_WORK_IDLE     0
 315 #define HB_WORK_OK       1
 316 #define HB_WORK_ERROR    2
 317 #define HB_WORK_DONE     3
 318
 319 /***********************************************************************
 320  * Muxers
 321  **********************************************************************/
 322 typedef struct hb_mux_object_s hb_mux_object_t;
 323 typedef struct hb_mux_data_s   hb_mux_data_t;
 324
 325 #define HB_MUX_COMMON \
 326     int (*init)      ( hb_mux_object_t * ); \
 327     int (*mux)       ( hb_mux_object_t *, hb_mux_data_t *, \
 328                        hb_buffer_t * ); \
 329     int (*end)       ( hb_mux_object_t * );
 330
 331 #define DECLARE_MUX( a ) \
 332     hb_mux_object_t  * hb_mux_##a##_init( hb_job_t * );
 333
 334 DECLARE_MUX( mp4 );
 335 DECLARE_MUX( avi );
 336 DECLARE_MUX( ogm );
 337 DECLARE_MUX( mkv );
 338