lqr_progress_set_end(3) [debian man page]

LQR_PROGRESS_SET_END(3) 				     LqR library API reference					   LQR_PROGRESS_SET_END(3)

NAME

       lqr_progress_set_end - execude custom code after each rescaling operation

SYNOPSIS

       #include <lqr.h>

       LqrRetVal lqr_progress_set_end(LqrProgress* p, LqrProgressFuncEnd end_func);

DESCRIPTION

       The function lqr_progress_set_end sets the hook end_func to the LqrProgress object pointed to by p.

       The function end_func is of type LqrProgressFuncEnd, whose prototype is defined by:

	   typedef LqrRetVal (*LqrProgressFuncEnd) (const gchar* end_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 at the end, with a string argument passed through the parameter end_message, which is different
       for horizontal and vertical rescalings.

       The message arguments can be set with the functions lqr_progress_set_end_width_message(3) and lqr_progress_set_end_height_message(3).

RETURN VALUE

       The return value follows the Liquid Rescale library signalling system.

SEE ALSO

       LqrRetVal(3), lqr_progress_new(3), lqr_progress_set_init(3), lqr_progress_set_update(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

LqR library 0.4.1 API (3:1:3)					    10 Maj 2009 					   LQR_PROGRESS_SET_END(3)

LQR_CARVER_RESIZE(3)					     LqR library API reference					      LQR_CARVER_RESIZE(3)

NAME

       lqr_carver_resize - liquid rescale a LqrCarver object

SYNOPSIS

       #include <lqr.h>

       LqrRetVal lqr_carver_resize(LqrCarver* carver, gint new_width, gint new_height);

DESCRIPTION

       The function lqr_carver_resize performs the liquid rescaling over the LqrCarver object pointed to by carver. If a visibility map was loaded
       through the function lqr_vmap_load, and the carver was not initialised, the resizing operations must be limited to the direction and the
       sizes included in the loaded map. If the carver was initialised through the function lqr_carver_init, there are no limitations to the final
       size.

       The resizing function can be called multiple times, and it will decide automatically whether the computation of the visibility map is
       necessary or not. In case it isn't, the function returns almost immediately, otherwise operations will proceed following the order given
       through the function lqr_carver_set_resize_order. Currently, on-the-fly rescaling without computation is only possible for a single
       direction at a time.

       If the new size (in one direction or in both) is greater than or equal to the original size multiplied by the enlargement step of the
       carver object (as obtained through lqr_carver_get_enl_step(3)), the rescaling will be performed in multiple steps. At each step, the
       original size stored internally is reset to the new value; therefore, each step in the process can be bigger then the previous one.

       Whenever the resizing dirction changes (this may happen in a single call of the rescaling function or through multiple calls), or if
       performing a multiple steps enlargement as per the previous paragraph, the visibility map computed during the first direction rescale is
       dropped to make place for the one for the second (and the original size of the image is reset to the current value). These visibility maps
       can be saved by using the lqr_carver_set_vmap_dump function, for inspection or future use.

RETURN VALUE

       The return value follows the Liquid Rescale library signalling system. It returns an error if trying to exceed the limitations of a loaded
       visibility map, or if passed a negative or null size.

SEE ALSO

       LqrRetVal(3), lqr_carver_init(3), lqr_carver_flatten(3), lqr_carver_set_enl_step(3), lqr_carver_get_enl_step(3), lqr_carver_cancel(3),
       lqr_vmap_load(3)

COPYRIGHT

       Copyright (C) 2007-2009 Carlo Baldassi

LqR library 0.4.1 API (3:1:3)					    10 Maj 2009 					      LQR_CARVER_RESIZE(3)