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. This can be useful to perform more than one rescale step in the same direction, expecially for enlarging.

This function must only be invoked over initialized LqrCarver objects.

This function is called internally each time the rescaling direction changes, 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-initialized LqrCarver objects or in case of insufficient memory.

See also

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