SCScan(3) Impressario SCScan(3)NAME
SCScan, SCScanFD - start scanning from a scanning device.
SYNOPSIS
#include <stdio.h>
#include <scanner.h>
int SCScan(SCANNER *s);
int SCScanFD(SCANNER *s, int fd);
DESCRIPTION
SCScan tells the scanner driver to start scanning. s specifies a
connection to a scanner driver established by a call to SCOpen,
SCOpenFile, or SCOpenScreen. The scan data is then retrieved by calling
SCGetScanLine(3) or SCGetScanFD(3).
SCScanFD tells the scanner driver to start scanning, with the scan data
being written directly to fd. libscan will pass the file descriptor to
the scanner driver, and the scanner driver will write the scan data
directly to the file descriptor.
Before calling either of these functions, SCSetup(3) and SCGetScanSize(3)
should be called.
RETURN VALUE
SCScan and SCScanFD return 0 if successful. If an error occurs, -1 is
returned and SCerrno is set to indicate the reason for failure.
EXECUTION ERROR CODES
SCScan and SCScanFD will fail under the following circumstances.
SCECOMM Error communicating with scanner driver
SCEDEV Scanner driver error
SCEDRVMSG Driver specific error. SCErrorString(3) will
return a custom message supplied by the scanner
driver
SEE ALSOlibscan(3), SCOpen(3), SCSetup(3), SCGetScanSize(3).
Page 1
