SCGetScanSize(3)

NAME
     SCGetScanSize - Determine the amount of image data to be scanned

SYNOPSIS
     #include <stdio.h>
     #include <scanner.h>

     int SCGetScanSize(SCANNER *s, long *width, long *height,
                       long *bytesPerLine);

DESCRIPTION
     SCGetScanSize is called after calling SCSetup(3) to determine how much
     image data to retrieve from the scanner.  *width gets filled in with the
     number of pixels in each row, *height gets filled in with the number of
     rows in the image, and *bytesPerLine gets filled in with the number of
     bytes in each row.

     If the data type being scanned has a packing of SC_PLANAR, then the total
     number of bytes to be scanned is given by the number of channels *
     *height * *bytesPerLine.  Otherwise, the total number of bytes is simply
     *height * *bytesPerLine.  See SCSetup(3) and SCGetDataTypes(3) for more
     information about data types.

     After calling SCGetScanSize, a scanning application should allocate
     buffers and write image file headers as appropriate, and then call
     SCScan(3) or SCScanFD(3) to start the actual scan.

RETURN VALUE
     SCGetScanSize returns 0 if successful.  If an error occurs, -1 is
     returned and SCerrno is set to indicate the reason for failure.

EXECUTION ERROR CODES
     SCGetScanSize will fail under the following circumstances.

     SCECOMM                  Error communicating with scanner driver

     SCEDEV                   Scanner driver error

SEE ALSO
     libscan(3), SCSetup(3), SCScan(3), SCScanFD(3).