lqr_vmap_new — the LqrVMap
object constructor
#include <lqr.h>
LqrVMap* lqr_vmap_new( | gint* buffer, |
gint width, | |
gint height, | |
gint depth, | |
gint orientation) ; |
The function lqr_vmap_new
is the constructor
for LqrVMap
objects. It can be used to convert saved data in a format
which can be loaded in an LqrCarver
object.
The parameter buffer
must point to an an array of
ints holding the visibility information.
width
* height
The parameter depth
represents the maximum possible
amount of rescaling with the given map.
The parameter orientation
must be 0
if the map
is to be used for horizontal rescaling, 1
if it is to be used for
vertical rescaling.
The buffer
must be an array of integers of size
.
For an horizontally oriented visibility map, the format is as such: each row must
contain all values between 1 and width
* height
depth
(included) exactly once,
with low values indicating the pixels which will be operated on first during rescaling.
All other pixels must be 0, which means that they won't be affected by rescaling.
Such a map allows for horizontal rescaling in the range from
to width
- depth
.
The same applies to vertically oriented visibility maps,
with columns in place of rows and width
+ depth
height
in place
of width
.