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.