lqr_progress_set_init(3) [debian man page]

LQR_PROGRESS_SET_INIT(3)				     LqR library API reference					  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

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

LQR_CARVER_SET_SIDE_SWITCH_(3)				     LqR library API reference				    LQR_CARVER_SET_SIDE_SWITCH_(3)

NAME

       lqr_carver_set_side_switch_frequency - set LqrCarver object side switch frequency

SYNOPSIS

       #include <lqr.h>

       void lqr_carver_set_side_switch_frequency(LqrCarver* carver, guint switch_frequency);

DESCRIPTION

       When the function lqr_carver_resize(3) is invoked, it computes a relevance value for each pixel in the image, then chooses the optimal seam
       to carve based on such relvance values. However, in the case two seams are equivalent (which may happen when large portions of the image
       have the same colour, for example), the algorithm always chooses the seams from one side.

       In order to overcome this effect, an option is given to automatically switch the favoured side during rescaling, at the cost of a slightly
       worse performance.

       The function lqr_carver_set_side_switch_frequency sets the side switch frequency to switch_frequency for the LqrCarver object pointed to by
       carver. This will have the effect that, for each rescale operation, the favoured side will be switched switch_frequency times (or as much
       times as the number of pixels to rescale).

       The default value for newly created LqrCarver objects is 0.

       As for the final result, a very small value (e.g.  1 to 4) will normally suffice to balance the left and right side of the image (or the
       top and the boddom sides for vertical rescalings), without noticeable computational costs. However, in order to obtain a smoother behaviour
       for the visibiliy map, i.e. for the intermediate steps, higher values may be required.

SEE ALSO

       lqr_carver_set_enl_step(3), lqr_carver_set_resize_order(3), lqr_carver_set_dump_vmaps(3), lqr_carver_set_progress(3),
       lqr_carver_set_preserve_input_image(3), lqr_carver_set_use_cache(3)

COPYRIGHT

       Copyright (C) 2007-2009 Carlo Baldassi

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