Int Sigcap2Tiff() - VeriFone MX800 series Programmer's Manual

D D
EVICE RIVERS

int SigCap2Tiff()

int SigCap2Tiff()
128
M X 800 S P
ERIES ROGRAMMERS
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
count
compression_scheme
dpi
box
Options
setTiffUserTags
G
UIDE
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.
is the number of signature points in the caller's buffer. A
negative value is an error.
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.
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.
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.
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.
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.