LQR_PROGRESS_SET_INIT(3)
NAME
lqr_progress_set_init - execude custom code before each rescaling
operation
SYNOPSIS
#include <lqr.h> LqrRetVal lqr_progress_set_init(LqrProgress* p, LqrProgressFuncInit init_func);
DESCRIPTION
The function lqr_progress_set_init sets the hook init_func to the
LqrProgress object pointed to by p.
- The function init_func is of type LqrProgressFuncInit, whose prototype
is defined by:
- typedef LqrRetVal (*LqrProgressFuncInit) (const gchar* init_message);
- Each time that the function lqr_carver_resize(3) performs a rescale
operation (recall that it can perform more than one rescale operation
at each call) this function will be called first, with a string
argument passed through the parameter init_message, which is different for horizontal and vertical rescalings. - The message arguments can be set with the functions
lqr_progress_set_init_width_message(3) and lqr_progress_set_init_height_message(3). - The default values for newly created LqrProgress objects are:
- Horizontal:
"Resizing width..."- Vertical:
"Resizing height..."
RETURN VALUE
The return value follows the Liquid Rescale library signalling system.
SEE ALSO
LqrRetVal(3), lqr_progress_new(3), lqr_progress_set_update(3), lqr_progress_set_end(3), lqr_progress_set_init_width_message(3), lqr_progress_set_init_height_message(3), lqr_progress_set_end_width_message(3), lqr_progress_set_end_height_message(3), lqr_progress_set_update_step(3), lqr_carver_set_progress(3)
COPYRIGHT
- Copyright (C) 2007-2009 Carlo Baldassi