Intermec PEN*KEY 6100 User manual

DOS Signature Capture Utility
PROGRAMMER’S
REFERENCE GUIDE
""""""""""""""""""""""""""""
P/N: 977-054-006
Revision C
February 1998

" NOTICE The information contained herein is proprietary and is provided solely for the
purpose of allowing customers to operate and service Intermec manufactured
equipment and is not to be released, reproduced, or used for any other purpose
without written permission of Intermec.
Disclaimer of Warranties. The sample source code included in this document is
presented for reference only. The code does not necessarily represent complete,
tested programs. The code is provided AS IS WITH ALL FAULTS." ALL
WARRANTIES ARE EXPRESSLY DISCLAIMED, INCLUDING THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE.
We welcome your comments concerning this publication. Although every effort has
been made to keep it free of errors, some may occur. When reporting a specific
problem, please describe it briefly and include the book title and part number, as
well as the paragraph or figure number and the page number.
end your comments to:
Intermec Technologies Corporation
Publications Department
550 econd treet E
Cedar Rapids, IA 52401
ANTARE , INTERMEC, NORAND, NOR*WARE, PEN*KEY, ROUTEPOWER,
TRAKKER, and TRAKKER ANTARE are registered trademarks and
ENTERPRI E WIRELE LAN, INCA, Mobile Framework, MobileLAN, TE 2000,
UAP, and UNIVER AL ACCE POINT are trademarks of Intermec Technologies
Corporation.
 1997 Intermec Technologies Corporation. All rights reserved.
Acknowledgments
ActiveX, Microsoft, MS, and MSĆDOS, Windo s, and Windo s NT are registered
trademarks and MSDN, Visual Basic, Visual C++, and Windo s for Pen are
trademarks of Microsoft Corporation.

DOS Signature Capture Utility Programmer’s Reference Guide i
CONTENTS
""""""""""""""""""""""""""""
SECTION 1
Introduction
Audience 1Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
About this Guide 1Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
cope 1Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Related Documents 1Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents of Package 1Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Required oftware Components 1Ć4. . . . . . . . . . . . . . . . .
Hardware Requirements 1Ć4. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing 1Ć4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customer upport 1Ć5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customer upport Center 1Ć5. . . . . . . . . . . . . . . . . . . . . . . . .
Web ite 1Ć5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Bulletin Board ervice 1Ć6. . . . . . . . . . . . . . . . . . . . . . . . . . . .
SECTION 2
Frequently Asked Questions
How Does It Work? 2Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What Does the ignature creen Look Like? 2Ć2. . . . . . . . . . .
What Do I Do with the Output File? 2Ć2. . . . . . . . . . . . . . . . . . .

CONTENTS
ii DOS Signature Capture Utility Programmer’s Reference Guide
SECTION 3
Component Reference
P IGM0C.EXE 3Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Line 3Ć1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Parameters 3Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Return Value 3Ć2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Usage Notes 3Ć3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PL/N Programming Example 3Ć3. . . . . . . . . . . . . . . . . . . . . .
P IGP0C.EXE 3Ć5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Line 3Ć5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Parameters 3Ć5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Return Value 3Ć6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Usage Notes 3Ć6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PL/N Programming Example 3Ć7. . . . . . . . . . . . . . . . . . . . . .
P IGM0C.INI 3Ć9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FIGURES
Figure 2Ć1 ample ignature creen 2Ć2. . . . . . . . . . . . . . . . . .

DOS Signature Capture Utility Programmer’s Reference Guide 1Ć1
Section 1
Introduction
""""""""""""""""""""""""""""
This programmer's reference guide provides information
about using the DO ignature Capture Utility package for
the PEN*KEYR 6100, 6210, and 6300 eries HandĆHeld
Computers.
Audience
This guide is intended for use by persons responsible for deĆ
veloping an application software program to run on the
above mentioned computers.

Introduction SECTION 1
1-2 DOS Signature Capture Utility Programmer’s Reference Guide
About this Guide
This guide is arranged into several sections to allow quick
reference to relevant information.
Sectio 1, I troductio
This section contains information about the product.
Sectio 2, Freque tly Asked Questio s
Read this section to understand the DO ignature
Capture Utility program and what it can do.
Sectio 3, Compo e t Refere ce
The DO ignature Capture Utility program,
P IGM0C.EXE, the ignature Print Utility program,
P IGP0C.EXE, and the configuration file,
P IGM0C.INI are described in this section.
Scope
The DO ignature Capture Utility package, which inĆ
cludes software and this programmer's reference guide, is a
supplement to your computer's respective programmer's refĆ
erence guide. The programmer's reference guide contains
important information about configuring the system. The
DO ignature Capture Utility package provides suppleĆ
mentary information needed to integrate the DO ignaĆ
ture Capture Utility into a system, but does not document
those areas covered in the programmer's reference guide.
Below is each computer type with its applicable programĆ
mer's reference guide and part number:
"6100 Computer:
PEN*KEY 6100 Computer Programmer's Reference
Guide (P/N: 977Ć054Ć001)
"6210 and 6300 eries Computers:
PEN*KEY 6200/6300 Computer Programmer's ReferĆ
ence Guide (P/N: 977Ć054Ć003)

SECTION 1 Introduction
DOS Signature Capture Utility Programmer’s Reference Guide 1-3
Related Documents
"NORLIB Library Collection Volume A Programmer's
Reference Guide
P/N: 977Ć052Ć007
"NORLIB Library Collection Volume B Programmer's
Reference Guide
P/N: 977Ć052Ć008
"Application Compatibility Enhancement (ACE) ProĆ
gram User's Guide (applies to 6100 Computers)
P/N: 961Ć052Ć003
Contents of Package
The DO ignature Capture Utility package includes the
following software components:
"P IGM0C.EXE DO ignature Capture Utility
executable program
"P IGP0C.EXE ignature Print Utility
executable program
"P IGM0C.INI ample configuration file

Introduction SECTION 1
1-4 DOS Signature Capture Utility Programmer’s Reference Guide
Other Required Software Components
Other software required to use the DO ignature Capture
Utility program is listed below. Documentation on these
components is in your computer's applicable toolkit:
"61MOU E.COM PEN*KEY 6100 Mouse Driver,
included in 6100 Toolkit
"62MOU E.COM PEN*KEY 6200 Mouse Driver,
included in 6200/6300 Toolkit
"63MOU E.COM PEN*KEY 6300 Mouse Driver,
included in 6200/6300 Toolkit
"CALIB.EXE Mouse calibration utility, included
in the 6100 and the 6200/6300
Toolkits
"62CALIB.EXE 6200 Mouse calibration utility,
included in the 6200/6300 Toolkit
Hardware Requirements
Use a desktop or laptop development" PC running
M ĆDO Version 5.0 or higher to develop the DO
ignature Capture Utility program.
The development PC needs to communicate with the comĆ
puter, using an RAM Card Reader and Writer or a null
modem serial cable connection. Contact your Account RepĆ
resentative for assistance in obtaining the required tools.
6210 Computers must be equipped with the optional touch
screen to use this utility.
Licensing
This package includes one DO ignature Capture Utility
license for use on a single handĆheld computer. The DO
ignature Capture Utility source code is not available.

SECTION 1 Introduction
DOS Signature Capture Utility Programmer’s Reference Guide 1-5
Customer Support
Customer Support Center
The Intermec Customer upport Center (technical support)
telephone number is 800Ć755Ć5505 (U. .A. or Canada) or
425Ć356Ć1799. The facsimile number is 425Ć356Ć1688.
Email is [email protected].
If you email or fax a problem or question include the
following information in your message: your name, your
company name and address, phone number and email to
respond to, and problem description or question (the more
specific, the better). Please indicate if the equipment was
purchased through a valueĆadded reseller.
Web Site
The Customer upport File Libraries, including Hot Tips
and Product Awareness Bulletins, are available via the
Intermec Product upport page at this URL:
http://norbbs.norand.com/index.htm. New users can sign
up for a new account on this page.
Visit our Web site at http:// .intermec.com to download
many of our current manuals in PDF format. To order
printed versions of the Intermec manuals, contact your loĆ
cal Intermec representative or distributor.

Introduction SECTION 1
1-6 DOS Signature Capture Utility Programmer’s Reference Guide
Bulletin Board Service
The Customer upport Bulletin Board (BB ), maintained
by Intermec Technologies Corporation, provides software
and documentation:
"Pho e umber: 319Ć369Ć3515 (14.4 kbps modem)
319Ć369Ć3516 (28.8 kbps modem)
"Protocol: Full duplex, AN I or AN IĆBB ; 300 to
28,800 bps; v.32bis; 8 bits, no parity, 1 stop bit. For
highĆspeed modems, disable XON/XOFF and enable
RTS/CTS.
This is the same location available via the web site. If your
web access uses highĆspeed phone lines, the web interface
provides a faster response.

DOS Signature Capture Utility Programmer’s Reference Guide 2Ć1
Section 2
Frequently Asked Questions
""""""""""""""""""""""""""""
The DO ignature Capture Utility allows users to add the
ability to capture an electronic signature on a PEN*KEYR
6100, 6210, or 6300 eries HandĆHeld Computer, with
minimal changes to their program. This section provides
answers to Frequently Asked Questions (FAQ).
How Does It Work?
The DO ignature Capture Utility puts the display in
graphics mode to display an area for a signature and butĆ
tons that allow the signature to be accepted, cancelled, or
cleared. The utility then monitors touch screen activity,
drawing ink where the user touches. The image is saved to
a file that the application can upload or print.

Frequently Asked Questions SECTION 2
2-2 DOS Signature Capture Utility Programmer’s Reference Guide
What Does the Signature Screen Look
Like?
The signature screen can be either portrait mode or landĆ
scape mode. The default is landscape:
ACCEPT CLEAR CANCEL
Figure 2Ć1
Sample Signature Screen
What Do I Do with the Output File?
The file created by the DO ignature Capture Utility is in
PCX format, an industry standard graphics format accepted
by many graphics, word processing, and desktop publishing
programs. Most often, this file is uploaded to a host comĆ
puter.

DOS Signature Capture Utility Programmer’s Reference Guide 3Ć1
Section 3
Component Reference
""""""""""""""""""""""""""""
This section describes the DO ignature Capture Utility
program's executable file (P IGM0C.EXE), the ignature
Print Utility program's executable file (P IGP0C.EXE), and
the configuration file (P IGM0C.INI).
PSIGM0C.EXE
This program implements a signature capture" screen on a
PEN*KEYR HandĆHeld Computer with a touch screen. The
signature capture screen contains an area for a signature,
optional text, and buttons that allow the signature to be
accepted, canceled, or cleared. An accepted signature is
saved to a file in .PCX format. The attributes of the screen
can be configured by the calling application.
Command Line
PSIGM0C [options] [<.ini file>]

Component Reference SECTION 3
3-2 DOS Signature Capture Utility Programmer’s Reference Guide
Parameters
-?
This option causes P IGM0C to display a usage message
and then exit.
<.i i file>
This optional parameter is the name of a file that contains
configuration information for P IGM0C. If this parameter
is not specified, P IGM0C reads the P IGM0C.INI file for
configuration information. If this parameter is not specified
and P IGM0C.INI does not exist, P IGM0C uses default
values. ee page 3Ć9 for a description of the P IGM0C.IĆ
NI format and default values.
Return Value
This program returns zero (0) if successful, or a nonzero erĆ
ror code:
Value Mea i g
0 ignature was accepted and successfully saved.
1 User canceled the signature capture by pressing
the cancel button or keyboard equivalent.
252 An invalid command line parameter was
specified or the -? command line option was
specified.
253 .INI file is missing a required entry, or an entry
with a fixed set of values has an invalid value.
254 The specified .INI file could not be accessed.
255 An error occurred while saving the signature to
the file.

SECTION 3 Component Reference
DOS Signature Capture Utility Programmer’s Reference Guide 3-3
Usage Notes
A touch screen driver must be loaded before calling
P IGM0C, such as 61mouse.com, 62mouse.com, or
63mouse.com.
For 6100 Computers o ly:
VROTATE.EXE and P EKM0C.EXE do not need to be
disabled before calling P IGM0C. P IGM0C detects
the presence of these programs, disables them while it
executes, then enables them again before exiting.
P IGM0C restores P EKM0C plane 0. If another
plane is required, the calling application must set it
after P IGM0C exits.
For 6210 Computers o ly:
FONTMAP.EXE does not need to be disabled before
calling P IGM0C.
PL/N Programming Example
EXTERNALS
NUMERIC FUNCTION SPAWNDOS = IPFSDP6
STRING FUNCTION STR = IPFSTR6
SUBROUTINE INIFILE = PGINI1P
LOCAL VARIABLES
01 RESPONSE BINARY BYTE
FD INIFD
01 INIBUF PIC X(128)
01 RESULT BINARY WORD
; This updates the configuration file for the signature utility.
; A template configuration file is bundled with the program files
; so that the location entries can be specific to the 6100 and
; 6200 Computers, yet the same program is used on both the 6100
; and 6200 Computers.
OPEN (INIFD, INIBUF) ME_NAME & ‘PSIGM0C.INI’,
ME_READ+ME_WRITE

Component Reference SECTION 3
3-4 DOS Signature Capture Utility Programmer’s Reference Guide
;Displays the invoice total in a text window.
INIFILE( 1, INIFD, ‘Text window 0’, ‘Text’, &
‘“INVOICE TOTAL: ’& STR(INVOICE_TOTAL) & ’”’)
; Specifies a file name that includes the invoice number to tie
; the signature file to the appropriate invoice.
INIFILE( 1, INIFD, ‘Capture window’, ‘File’, &
STR(INVOICE_NUMBER) & ‘.PCX’)
CLOSE (INIFD)
; Executes the signature capture utility.
RESULT = SPAWNDOS( ‘PSIGM0C.EXE’)
IF RESULT = 0 THEN
; THE SIGNATURE WAS ACCEPTED.
. . .
ELSEIF RESULT =1 THEN
; SIGNATURE CAPTURE WAS CANCELED BY USER
. . .
ELSE
; AN ERROR OCCURRED
OUT (KBD) (KB_HOME)
& ‘SIGNATURE’, CRLF,
& ‘CAPTURE ERROR!’, CRLF,
& ‘ERROR #’, RESULT, BEL, CRLF
& ‘PRESS ENTER’
RESPONSE = INPUT(S+F)
ENDIF

SECTION 3 Component Reference
DOS Signature Capture Utility Programmer’s Reference Guide 3-5
PSIGP0C.EXE
This program generates a file which contains the printer
commands necessary to print an image that is stored in a
.PCX file such as the type created by P IGM0C.EXE, the
signature capture utility. P IGP0C.EXE can create a file
suitable for printing to a 4810, 4815, 4820, 6805, or 6820
Printer.
Command Line
PSIGP0C [options] .PCX–file output–file
Parameters
.PCXĆfile
This is the name of the .PCX file with the image.
outputĆfile
This is the name of the output file to be generated.
Options to P IGP0C must always precede the filenames
but may be listed in any order. These options are available:
-?
Causes P IGP0C to display a usage message, then
exit.
-g graphicsĆmode:
elects the printer graphics mode to use. Valid values
for graphicsĆmode are:
1 = ingle density (default)
2 = Double density
-m leftĆmargi :
ets the left margin at which the image is printed.
Values for leftĆmargin are in increments of 1/100 of an
inch, such as 10" is 10/100 inch". Default value is 0
(zero).

Component Reference SECTION 3
3-6 DOS Signature Capture Utility Programmer’s Reference Guide
-p pri terĆtype:
elects the printer type. Valid values for printerĆtype
are 4810", 4815", 4820", 6805", and 6820" (deĆ
fault). The values 4815", 4820", and 6820" produce
identical output files.
-v
Verbose mode. Displays status messages.
Return Value
Return values 0-66 indicate success. For printer types
4815," 4820," and 6820," this value is the number of
print lines needed to print the image, based on a line spacĆ
ing factor of six lines per inch. A value of 66 means that
the image takes 66 or more print lines. This value can be
used by the calling application to determine if a formfeed is
needed to avoid printing the image across a page perforaĆ
tion. For other printer types, this value is always zero.
Return values greater than 66 indicate error conditions.
The following values are defined:
Value Mea i g
251 Cannot open output file.
252 Cannot access .PCX file.
253 An error occured while writing output file. One
possible cause is that the width of the image
exceeds the capability of the printer.
254 Out of memory. Unable to allocate memory.
255 An invalid or missing command line parameter
encountered, or -? specified.
Usage Notes
If the output file exists when this program is called, the
print data is appended to the file.
The output file is not deleted if an error occurs. The calling
application must delete this file.

SECTION 3 Component Reference
DOS Signature Capture Utility Programmer’s Reference Guide 3-7
The output file contains binary data. PL/N applications
should execute PUTCTL 1036 (PR_ ETE C) and PUTCTL
776 (PR_TRAN PARENT) before printing the contents of
the output file, and execute PUTCTL 1037 (PR_NOE C)
and PUTCTL 777 (PR_FULL) afterward.
PL/N Programming Example
EXTERNALS
NUMERIC FUNCTION INPUT
NUMERIC FUNCTION PRINTCTL = PGAPR2P
NUMERIC FUNCTION SPAWNDOS = IPFSDP6
STRING FUNCTION MID = IPFMID6
CONSTANTS
LINES_PER_PAGE = 54
LOCAL VARIABLES
01 RESPONSE BINARY BYTE
FD SIGFD ;FD for signature print file
01 SIGBUF PIC X(128) ;Buffer for signature print file
01 FRACTION BINARY WORD ;Size of fractional record
01 SIGLINES BINARY WORD ;# of lines needed for signature
01 SAVE_LAST BINARY WORD ;Saved value of PRT.LAST
01 RPT_COND BINARY BYTE ;Result of PRINTCTL
01 PRT_STATUS BINARY WORD ;Parameter for PRINTCTL
. . .
; Execute the signature print utility.
SIGLINES = SPAWNDOS( ‘PSIGP0C.EXE’, ‘SIGNATUR.PCX SIGNATUR.PRN’)
IF SIGLINES > 66 THEN
; An error occurred
OUT (KBD) (KB_HOME)
& ‘SIGNATURE’, CRLF,
& ‘PRINT ERROR!’, CRLF,
& ‘ERROR #’, SIGLINES, BEL, CRLF,
& ‘PRESS ENTER’
RESPONSE = INPUT(S+F)
RETURN
ENDIF
. . .
; Print the report. Because PRINTCTL allows the report to be aborted,
; files must be opened and closed outside of the report procedure.
OPEN (SIGFD, SIGBUF) ME_NAME & ‘SIGNATUR.PRN’, ME_READ + ME_TRANSPARENT
. . .

Component Reference SECTION 3
3-8 DOS Signature Capture Utility Programmer’s Reference Guide
RPT_COND = PRINTCTL(21,@REPORT,PRT_STATUS,SECURITY_CODE)
. . .
CLOSE (SIGFD)
. . .
PROCEDURE REPORT
. . .
; Print the signature at the bottom of the invoice. SIGLINES contains
; the number of lines needed to print the signature. Check for end of
; page.
IF ((PRT.LAST AND 255) + SIGLINES > LINES_PER_PAGE) THEN
PERFORM NEW_PAGE
ENDIF
; Set the print driver to accept binary data.
PUTCTL (PRT) PR_SETESC
PUTCTL (PRT) PR_TRANSPARENT
; Each out statement increments PRT.LAST. SIGLINES contains the line
; count for the signature, so we manually override PRT.LAST after
; printing the signature.
SAVE_LAST = PRT.LAST
GET (SIGFD) 0
WHILE NOT SIGFD.ERROR DO
IF SIGFD.CURRENT < SIGFD.LAST THEN
OUT (PRT) SIGBUF
ELSE ;Write partial record
GETCTL (SIGFD) FRACTION, ME_FRACTION
IF FRACTION THEN
OUT (PRT) MID(SIGBUF,0,FRACTION)
ENDIF
ENDIF
GET (SIGFD)
ENDWHILE
; Set the proper line count
PRT.LAST = SAVE_LAST + SIGLINES
;Restore print mode
PUTCTL (PRT) PR_NOESC
PUTCTL (PRT) PR_FULL
. . .
END ;Of report