debian man page for lqr_carver_scan

Query: lqr_carver_scan

OS: debian

Section: 3

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

LQR_CARVER_SCAN(3)					     LqR library API reference						LQR_CARVER_SCAN(3)

NAME
lqr_carver_scan, lqr_carver_scan_ext - read out a multi-size image one pixel at a time
SYNOPSIS
#include <lqr.h> gboolean lqr_carver_scan(LqrCarver* carver, gint* x, gint* y, guchar** rgb); gboolean lqr_carver_scan_ext(LqrCarver* carver, gint* x, gint* y, void** rgb);
DESCRIPTION
The functions lqr_carver_scan and lqr_carver_scan_ext are used to read out the multi-size image contained in the LqrCarver object pointed to by carver one pixel at a time. They store the pixel coordinates in the variables pointed to by x and y, and the pixel content in the array pointed to by rgb; then they move the readout pointer to the next pixel, or they reset it if the end of the image is reached. The first one must only be used on the LqrCarver objects created with lqr_carver_new, i.e. with 8-bit images, while the second one is general (see LqrColDepth(3)), but the rgb pointer must be cast to the appropriate type to be used (i.e pass the address of a pointer to void to the function lqr_carver_scan_ext, then cast it to a pointer of the appropriate type and use this last one for reading the output). The rgb variable will point to an array which is internal to the LqrCarver object, so there is no need to allocate memory for it. However, it should only be accessed right after a call to the scan functions, and writing to it must be avoided.
RETURN VALUE
These functions return TRUE in case the readout is successful and the end of the image was not reached, FALSE otherwise. If lqr_carver_scan is called over a non-8-bit LqrCarver object, it will return FALSE.
SEE ALSO
LqrColDepth(3), lqr_carver_scan_reset(3), lqr_carver_scan_line(3)
COPYRIGHT
Copyright (C) 2007-2009 Carlo Baldassi LqR library 0.4.1 API (3:1:3) 10 Maj 2009 LQR_CARVER_SCAN(3)
Related Man Pages
lqr_carver_bias_add_xy(3) - debian
lqr_carver_get_channels(3) - debian
lqr_carver_get_bpp(3) - debian
lqr_carver_get_ref_width(3) - debian
lqr_carver_scan_line(3) - debian
Similar Topics in the Unix Linux Community
Is UNIX an open source OS ?
Introduction
Find columns in a file based on header and print to new file
Weird 'find' results
A (ksh) Library For and From UNIX.com