debian man page for lqr_vmap_new

Query: lqr_vmap_new

OS: debian

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

LQR_VMAP_NEW(3) 					     LqR library API reference						   LQR_VMAP_NEW(3)

NAME
lqr_vmap_new - the LqrVMap object constructor
SYNOPSIS
#include <lqr.h> LqrVMap* lqr_vmap_new(gint* buffer, gint width, gint height, gint depth, gint orientation);
DESCRIPTION
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 width * height ints holding the visibility information. 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.
VISIBILITY MAPS FORMAT
The buffer must be an array of integers of size width * height. For an horizontally oriented visibility map, the format is as such: each row must contain all values between 1 and 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 width - depth to width + depth. The same applies to vertically oriented visibility maps, with columns in place of rows and height in place of width.
RETURN VALUE
The function returns the newly created LqrVMap if successful, or NULL in case of insufficient memory.
SEE ALSO
lqr_vmap_destroy(3), lqr_vmap_load(3)
COPYRIGHT
Copyright (C) 2007-2009 Carlo Baldassi LqR library 0.4.1 API (3:1:3) 10 Maj 2009 LQR_VMAP_NEW(3)
Related Man Pages
lqr_carver_bias_add(3) - debian
lqr_carver_bias_add_area(3) - debian
lqr_carver_get_energy(3) - debian
lqr_vmap_get_data(3) - debian
lqr_vmap_new(3) - debian
Similar Topics in the Unix Linux Community
Tarzan 2.0b (Default branch)