DEVICE DRIVERS
int SigCap2Tiff()
128 M
X
800 SERIES PROGRAMMERS GUIDE
int SigCap2Tiff()
This function creates a file fname in TIFF format. Setting fname to 0 is an error.
Prototype
int SigCap2Tiff
(
char *fname,xyz_t *sig, int count,short compression_scheme,
xy_t *dpi,SigCapBox_t *box, SigCapOptions_t *options,
void (*setTiffUserTags)(TIFF *)
);
Parameters
sig is a pointer to the user’s signature data buffer consisting of
points of type xyz_t. The z data is currently ignored but
may be processed in some way (yet to be defined) in future
releases. Setting sig to 0 is an error.
count is the number of signature points in the caller’s buffer. A
negative value is an error.
compression_scheme defaults to COMPRESSION_CCITTFAX4 if the caller sets the
parameter to 0. Otherwise the scheme specified by the
parameter is used. The compression schemes are
#defined in tiff.h.
dpi is a pointer to an xy_t structure (prototyped in ps2.h) that
specifies the desired x and y TIFF image resolution in dots
per inch. Set to 0 to force maximum resolution to be used.
box is a pointer to a signature box specified in QVGA display
coordinates {.x=0…319, .y=0…239). Data outside the box is
interpreted as PENUP. Set to 0 to make the box be the
entire screen.
Options is a pointer to a structure that specifies whether points are
joined (using Bresenham’s algorithm) and whether trimming
is applied to the width and height of the image. Trimming is
removing any empty space at the left and right, or top and
bottom of the image. This generally results in a smaller
image and image file. The pointer may be set to 0 to get the
default options, which are to join the points and to trim along
both axes.
setTiffUserTags is an optional pointer to a user function, described further
below, that may be used to set various user tags. Set to 0 if
not used.
To Next Page
