libhb/hb.h

   1 #ifndef HB_HB_H
   2 #define HB_HB_H
   3
   4 #ifdef __cplusplus
   5 extern "C" {
   6 #endif
   7
   8 #include "project.h"
   9 #include "common.h"
  10
  11 /* hb_init()
  12    Initializes a libhb session (launches his own thread, detects CPUs,
  13    etc) */
  14 #define HB_DEBUG_NONE 0
  15 #define HB_DEBUG_ALL  1
  16 void          hb_register( hb_work_object_t * );
  17 void          hb_register_logger( void (*log_cb)(const char* message) );
  18 hb_handle_t * hb_init( int verbose, int update_check );
  19 hb_handle_t * hb_init_dl ( int verbose, int update_check ); // hb_init for use with dylib
  20
  21 /* hb_get_version() */
  22 char        * hb_get_version( hb_handle_t * );
  23 int           hb_get_build( hb_handle_t * );
  24
  25 /* hb_check_update()
  26    Checks for an update on the website. If there is, returns the build
  27    number and points 'version' to a version description. Returns a
  28    negative value otherwise. */
  29 int           hb_check_update( hb_handle_t * h, char ** version );
  30
  31
  32 char *        hb_dvd_name( char * path );
  33 void          hb_dvd_set_dvdnav( int enable );
  34
  35 /* hb_scan()
  36    Scan the specified path. Can be a DVD device, a VIDEO_TS folder or
  37    a VOB file. If title_index is 0, scan all titles. */
  38 void          hb_scan( hb_handle_t *, const char * path,
  39                        int title_index, int preview_count,
  40                        int store_previews, uint64_t min_duration );
  41 void          hb_scan_stop( hb_handle_t * );
  42 hb_filter_object_t * hb_get_filter_object(int filter_id, const char * settings);
  43 uint64_t      hb_first_duration( hb_handle_t * );
  44
  45 /* hb_get_titles()
  46    Returns the list of valid titles detected by the latest scan. */
  47 hb_list_t   * hb_get_titles( hb_handle_t * );
  48
  49 /* hb_detect_comb()
  50    Analyze a frame for interlacing artifacts, returns true if they're found.
  51    Taken from Thomas Oestreich's 32detect filter in the Transcode project.  */
  52 int hb_detect_comb( hb_buffer_t * buf, int width, int height, int color_equal, int color_diff, int threshold, int prog_equal, int prog_diff, int prog_threshold );
  53
  54 void          hb_get_preview_by_index( hb_handle_t *, int, int, uint8_t * );
  55 void          hb_get_preview( hb_handle_t *, hb_title_t *, int,
  56                               uint8_t * );
  57 void          hb_set_size( hb_job_t *, double ratio, int pixels );
  58 void          hb_set_anamorphic_size_by_index( hb_handle_t *, int,
  59                 int *output_width, int *output_height,
  60                 int *output_par_width, int *output_par_height );
  61 void          hb_set_anamorphic_size( hb_job_t *,
  62                 int *output_width, int *output_height,
  63                 int *output_par_width, int *output_par_height );
  64
  65 /* Handling jobs */
  66 int           hb_count( hb_handle_t * );
  67 hb_job_t *    hb_job( hb_handle_t *, int );
  68 void          hb_set_chapter_name( hb_handle_t *, int, int, const char * );
  69 void          hb_set_job( hb_handle_t *, int, hb_job_t * );
  70 void          hb_add( hb_handle_t *, hb_job_t * );
  71 void          hb_rem( hb_handle_t *, hb_job_t * );
  72
  73 void          hb_start( hb_handle_t * );
  74 void          hb_pause( hb_handle_t * );
  75 void          hb_resume( hb_handle_t * );
  76 void          hb_stop( hb_handle_t * );
  77
  78 /* Persistent data between jobs. */
  79 typedef struct hb_interjob_s
  80 {
  81     int last_job;          /* job->sequence_id & 0xFFFFFF */
  82     int frame_count;       /* number of frames counted by sync */
  83     uint64_t total_time;   /* real length in 90khz (i.e. / 90000 */
  84     int render_dropped;    /* frames droped by telecine */
  85     int vrate;             /* initial assigned vrate */
  86     int vrate_base;        /* initial assigned vrate_base */
  87
  88     hb_subtitle_t *select_subtitle; /* foreign language scan subtitle */
  89 } hb_interjob_t;
  90
  91 hb_interjob_t * hb_interjob_get( hb_handle_t * );
  92
  93 /* hb_get_state()
  94    Should be regularly called by the UI (like 5 or 10 times a second).
  95    Look at test/test.c to see how to use it. */
  96 void hb_get_state( hb_handle_t *, hb_state_t * );
  97 void hb_get_state2( hb_handle_t *, hb_state_t * );
  98 /* hb_get_scancount() is called by the MacGui in UpdateUI to
  99    check for a new scan during HB_STATE_WORKING phase  */
 100 int hb_get_scancount( hb_handle_t * );
 101
 102 /* hb_close()
 103    Aborts all current jobs if any, frees memory. */
 104 void          hb_close( hb_handle_t ** );
 105
 106 /* hb_global_close()
 107    Performs final cleanup for the process. */
 108 void          hb_global_close();
 109
 110 /* hb_get_instance_id()
 111    Return the unique instance id of an libhb instance created by hb_init. */
 112 int hb_get_instance_id( hb_handle_t * h );
 113
 114 #ifdef __cplusplus
 115 }
 116 #endif
 117
 118 #endif