Poster of Linux kernelThe best gift for a Linux geek
FBLQR_CARVER_SCAN_LINEFR

FBLQR_CARVER_SCAN_LINEFR

Section: LqR library API reference (3) Updated: 10 Maj 2009
Local index Up
 

NAME

lqr_carver_scan_line, lqr_carver_scan_line_ext - read out a multi-size image one line at a time  

SYNOPSIS

#include <lqr.h>
gboolean lqr_carver_scan_line(LqrCarver* carver, gint* n, guchar** rgb);
gboolean lqr_carver_scan_line_ext(LqrCarver* carver, gint* n, void** rgb);
 

DESCRIPTION

The functions lqr_carver_scan_line and lqr_carver_scan_line_ext are used to read out the multi-size image contained in the LqrCarver object pointed to by carver one line at a time. They store the line number (row or column) in the variable pointed to by n and the colour values in the array pointed to by rgb; then they move the readout pointer to the next line, 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, 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_line_ext, then cast it to a pointer of the appropriate type and use this last one for reading the output).

Use the function lqr_carver_scan_by_row(3) before calling these to know whether your image will be scanned by row or by column.  

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_line 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(3), lqr_carver_scan_by_row(3)  

COPYRIGHT

Copyright © 2007-2009 Carlo Baldassi


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 21:49:44 GMT, April 16, 2011