LQR_PROGRESS_SET_INIT(3)

NAME

lqr_progress_set_init - execude custom code before each rescaling
operation

#include <lqr.h>

LqrRetVal lqr_progress_set_init(LqrProgress* p,
                                LqrProgressFuncInit init_func);

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..."

The return value follows the Liquid Rescale library signalling system.