NAME
lqr_carver_attach - attach an LqrCarver to another LqrCarver
SYNOPSIS
#include <lqr.h>
LqrRetVal lqr_carver_attach(LqrCarver* carver, LqrCarver* aux);
DESCRIPTION
The function lqr_carver_attach is used to attach an LqrCarver object
(pointed to by aux) to another one (pointed to by carver). This will
have the effect that each operation performed over the carver object
will be reflected on aux (they will share the same visibility map).
This function must not be used after a visibility map was loaded into
the base object (the one pointed to by carver).
The object pointed to by aux must have the same original size as the
base object. Note that the original size information is reset whenever
a flattening operation occurs, or the rescaling direction changes, so
that this function should be called befor rescaling occurs.
There is no limitation on the number of LqrCarver objects which is
possible to attach. Nesting is also possible. It is irrelevant if the
aux carver is initialised or not; from the moment of attachment, it
will passively undergo all transformations performed over carver.
RETURN VALUE
The return value follows the Liquid Rescale library signalling system.
LQR_ERROR is returned if the sizes of carver and aux don´t match.
SEE ALSO
LqrRetVal(3), lqr_carver_list_start(3), lqr_carver_list_current(3),
lqr_carver_list_next(3), lqr_carver_list_foreach(3)
COPYRIGHT
Copyright © 2007-2009 Carlo Baldassi