SCGetPageSize(3)

NAME
     SCGetPageSize - determine the scannable area of a scanning device

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

     int SCGetPageSize(SCANNER *s, int metric, float *x, float *y,
                       float *width, float *height);

DESCRIPTION
     SCGetPageSize queries a scanner for the size of the scannable area.  s
     specifies a connection to a scanner previously obtained from a call to
     SCOpen(3), SCOpenFile(3), or SCOpenScreen(3).  metric is used to specify
     whether the results are required to be in inches (SC_INCHES) or
     centimeters (SC_CENTIM).  SCGetPageSize returns the x and y coordinates
     of the upper left hand corner of the scannable area in x and y, and the
     width and height of the scannable area in width and height.

RETURN VALUE
     SCGetPageSize returns 0 if successful.  In the event of an error,
     SCGetPageSize returns -1 and sets the global variable SCerrno to indicate
     the reason for failure.

EXECUTION ERROR CODES
     SCGetPageSize will fail under the following circumstances.

     SCEBADMETRIC             Unsupported metric

     SCECOMM                  Error communicating with scanner driver

SEE ALSO
     libscan(3), SCOpen(3), SCSetup(3).