lqr_carver_flatten(3) [debian man page]

LQR_CARVER_FLATTEN(3)					     LqR library API reference					     LQR_CARVER_FLATTEN(3)

NAME

       lqr_carver_flatten - flatten a LqrCarver object

SYNOPSIS

       #include <lqr.h>

       LqrRetVal lqr_carver_flatten(LqrCarver* carver);

DESCRIPTION

       The function lqr_carver_flatten can be used to discard the visibility map information and flatten the multi-size image contained in the
       LqrCarver object pointed to by carver to its current state.

       It will also reset the internally stored original width and height, as if the image was just loaded in the LqrCarver object.

       This function must only be invoked over initialised LqrCarver objects.

       This function is called internally each time the rescaling direction changes, or at each new step in a multiple-step enlargement, but, when
       calling it manually, the discarded visibility map will not be dumped automatically by it; use the functions lqr_vmap_dump(3) or
       lqr_vmap_internal_dump(3) in order to save it before invoking this function.

RETURN VALUE

       The return value follows the Liquid Rescale library signalling system. Errors can occur for non-initialised LqrCarver objects or in case of
       insufficient memory.

SEE ALSO

       LqrRetVal(3), lqr_carver_init(3), lqr_carver_resize(3), lqr_carver_cancel(3)

COPYRIGHT

       Copyright (C) 2007-2009 Carlo Baldassi

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

LQR_CARVER_CANCEL(3)					     LqR library API reference					      LQR_CARVER_CANCEL(3)

NAME

       lqr_carver_cancel - cancel ongoing operations on a LqrCarver object

SYNOPSIS

       #include <lqr.h>

       LqrRetVal lqr_carver_cancel(LqrCarver* carver);

DESCRIPTION

       The function lqr_carver_cancel can be used to cancel an ongoing operation which is currently being performed on the the LqrCarver object
       pointed to by carver. It must be used asynchronouly, from within an independent thread.

       If an operation is in fact cancelled by this function, the function which was performing the operation will return the value LQR_USRCANCEL,
       and so will do any other operation successively called on the same LqrCarver object whose return type is LqrRetVal; otherwise it will have
       no effect.

       Whenever a function returns LQR_USRCANCEL, it means that the LqrCarver object is in an inconsistent state, and, since there is currently no
       way to recover from this situation, any further operation on that object must be avoided, and it must be destroyed.

       This function will fail if invoked over attached LqrCarver objects.

RETURN VALUE

       The return value follows the Liquid Rescale library signalling system. However, it can be called multiple times, so it will never return
       LQR_USRCANCEL itself.

SEE ALSO

       LqrRetVal(3), lqr_carver_resize(3), lqr_carver_flatten(3)

COPYRIGHT

       Copyright (C) 2007-2009 Carlo Baldassi

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