static void thread_func( void * );
+/**
+ * Registers work objects, by adding the work object to a liked list.
+ * @param w Handle to hb_work_object_t to register.
+ */
void hb_register( hb_work_object_t * w )
{
w->next = hb_objects;
hb_objects = w;
}
+/**
+ * libhb initialization routine.
+ * @param verbose HB_DEBUG_NONE or HB_DEBUG_ALL.
+ * @param update_check signals libhb to check for updated version from HandBrake website.
+ * @return Handle to hb_handle_t for use on all subsequent calls to libhb.
+ */
hb_handle_t * hb_init_real( int verbose, int update_check )
{
hb_handle_t * h = calloc( sizeof( hb_handle_t ), 1 );
return h;
}
+/**
+ * Returns current version of libhb.
+ * @param h Handle to hb_handle_t.
+ * @return character array of version number.
+ */
char * hb_get_version( hb_handle_t * h )
{
return HB_VERSION;
}
+/**
+ * Returns current build of libhb.
+ * @param h Handle to hb_handle_t.
+ * @return character array of build number.
+ */
int hb_get_build( hb_handle_t * h )
{
return HB_BUILD;
}
+/**
+ * Checks for needed update.
+ * @param h Handle to hb_handle_t.
+ * @param version Pointer to handle where version will be copied.
+ * @return update indicator.
+ */
int hb_check_update( hb_handle_t * h, char ** version )
{
*version = ( h->build < 0 ) ? NULL : h->version;
return h->build;
}
+/**
+ * Sets the cpu count to the desired value.
+ * @param h Handle to hb_handle_t
+ * @param cpu_count Number of CPUs to use.
+ */
void hb_set_cpu_count( hb_handle_t * h, int cpu_count )
{
cpu_count = MAX( 1, cpu_count );
h->cpu_count = cpu_count;
}
+/**
+ * Initializes a scan of the by calling hb_scan_init
+ * @param h Handle to hb_handle_t
+ * @param path location of VIDEO_TS folder.
+ * @param title_index Desired title to scan. 0 for all titles.
+ */
void hb_scan( hb_handle_t * h, const char * path, int title_index )
{
hb_title_t * title;
h->scan_thread = hb_scan_init( h, path, title_index, h->list_title );
}
+/**
+ * Returns the list of titles found.
+ * @param h Handle to hb_handle_t
+ * @return Handle to hb_list_t of the title list.
+ */
hb_list_t * hb_get_titles( hb_handle_t * h )
{
return h->list_title;
}
+/**
+ * Create preview image of desired title a index of picture.
+ * @param h Handle to hb_handle_t.
+ * @param title Handle to hb_title_t of desired title.
+ * @param picture Index in title.
+ * @param buffer Handle to buufer were inage will be drawn.
+ */
void hb_get_preview( hb_handle_t * h, hb_title_t * title, int picture,
uint8_t * buffer )
{
free( buf4 );
}
+/**
+ * Calculates job width, height, and cropping parameters.
+ * @param job Handle to hb_job_t.
+ * @param aspect Desired aspect ratio. Value of -1 uses title aspect.
+ * @param pixels Maximum desired pixel count.
+ */
void hb_set_size( hb_job_t * job, int aspect, int pixels )
{
hb_title_t * title = job->title;
job->height = MULTIPLE_16( 16 * i * HB_ASPECT_BASE / aspect );
}
+/**
+ * Returns the number of jobs in the queue.
+ * @param h Handle to hb_handle_t.
+ * @return Number of jobs.
+ */
int hb_count( hb_handle_t * h )
{
return hb_list_count( h->jobs );
}
+/**
+ * Returns handle to job at index i within the job list.
+ * @param h Handle to hb_handle_t.
+ * @param i Index of job.
+ * @returns Handle to hb_job_t of desired job.
+ */
hb_job_t * hb_job( hb_handle_t * h, int i )
{
return hb_list_item( h->jobs, i );
}
-/* hb_add: memcpy() party. That's ugly, for if someone has a better
- idea... */
+/**
+ * Adds a job to the job list.
+ * @param h Handle to hb_handle_t.
+ * @param job Handle to hb_job_t.
+ */
void hb_add( hb_handle_t * h, hb_job_t * job )
{
hb_job_t * job_copy;
hb_list_add( h->jobs, job_copy );
}
+/**
+ * Removes a job from the job list.
+ * @param h Handle to hb_handle_t.
+ * @param job Handle to hb_job_t.
+ */
void hb_rem( hb_handle_t * h, hb_job_t * job )
{
hb_list_rem( h->jobs, job );
/* XXX free everything XXX */
}
+/**
+ * Starts the conversion process.
+ * Sets state to HB_STATE_WORKING.
+ * calls hb_work_init, to launch work thread. Stores handle to work thread.
+ * @param h Handle to hb_handle_t.
+ */
void hb_start( hb_handle_t * h )
{
/* XXX Hack */
&h->work_die, &h->work_error );
}
+/**
+ * Pauses the conversion process.
+ * @param h Handle to hb_handle_t.
+ */
void hb_pause( hb_handle_t * h )
{
if( !h->paused )
}
}
+/**
+ * Resumes the conversion process.
+ * @param h Handle to hb_handle_t.
+ */
void hb_resume( hb_handle_t * h )
{
if( h->paused )
}
}
+/**
+ * Stops the conversion process.
+ * @param h Handle to hb_handle_t.
+ */
void hb_stop( hb_handle_t * h )
{
h->work_die = 1;
hb_resume( h );
}
+/**
+ * Returns the state of the conversion process.
+ * @param h Handle to hb_handle_t.
+ * @param s Handle to hb_state_t which to copy the state data.
+ */
void hb_get_state( hb_handle_t * h, hb_state_t * s )
{
hb_lock( h->state_lock );
hb_unlock( h->state_lock );
}
+/**
+ * Closes access to libhb by freeing the hb_handle_t handle ontained in hb_init_real.
+ * @param _h Pointer to handle to hb_handle_t.
+ */
void hb_close( hb_handle_t ** _h )
{
hb_handle_t * h = *_h;
*_h = NULL;
}
+/**
+ * Monitors the state of the update, scan, and work threads.
+ * Sets scan done state when scan thread exits.
+ * Sets work done state when work thread exits.
+ * @param _h Handle to hb_handle_t
+ */
static void thread_func( void * _h )
{
hb_handle_t * h = (hb_handle_t *) _h;
rmdir( dirname );
}
+/**
+ * Returns the PID.
+ * @param h Handle to hb_handle_t
+ */
int hb_get_pid( hb_handle_t * h )
{
return h->pid;
}
+/**
+ * Sets the current state.
+ * @param h Handle to hb_handle_t
+ * @param s Handle to new hb_state_t
+ */
void hb_set_state( hb_handle_t * h, hb_state_t * s )
{
hb_lock( h->pause_lock );
static void do_job( hb_job_t *, int cpu_count );
static void work_loop( void * );
+/**
+ * Allocates work object and launches work thread with work_func.
+ * @param jobs Handle to hb_list_t.
+ * @param cpu_count Humber of CPUs found in system.
+ * @param die Handle to user inititated exit indicator.
+ * @param error Handle to error indicator.
+ */
hb_thread_t * hb_work_init( hb_list_t * jobs, int cpu_count,
volatile int * die, int * error )
{
return hb_thread_init( "work", work_func, work, HB_LOW_PRIORITY );
}
+/**
+ * Interates through job list and calls do_job for each job.
+ * @param _work Handle work object.
+ */
static void work_func( void * _work )
{
hb_work_t * work = _work;
return NULL;
}
+/**
+ * Job initialization rountine.
+ * Initializes fifos.
+ * Creates work objects for synchronizer, video decoder, video renderer, video decoder, audio decoder, audio encoder, reader, muxer.
+ * Launches thread for each work object with work_loop.
+ * Loops while monitoring status of work threads and fifos.
+ * Exits loop when conversion is done and fifos are empty.
+ * Closes threads and frees fifos.
+ * @param job Handle work hb_job_t.
+ * @param cpu_count number of CPUs found in system.
+ */
static void do_job( hb_job_t * job, int cpu_count )
{
hb_title_t * title;
}
}
+/**
+ * Performs the work objects specific work function.
+ * Loops calling work function for associated work object. Sleeps when fifo is full.
+ * Monitors work done indicator.
+ * Exits loop when work indiactor is set.
+ * @param _w Handle to work object.
+ */
static void work_loop( void * _w )
{
hb_work_object_t * w = _w;
OSDN Git Service
