Programming instructions

Intermec Fingerprint v7.61 – Programmer’s Reference Manual Ed. 7 197
Chapter 2 Program Instructions
PRBUF
Field of Application Statement for receiving and printing bitmap image data using the
PRBUF protocol.
Syntax PRBUF<nexp
1
>[,<nexp
2
]<new line><image data>
<nexp
1
> is the number of bytes of the image in PRBUF protocol.
<nexp
2
> is, optionally, a timeout between characters in TICKS (0.01
sec). Default ≈ 12.7 sec./character.
<new line> is any combination of CR, CR/LF, or LF.
<image data> is the image according to the PRBUF protocol.
Remarks
This statement is useful for receiving and printing bitmap images from, for
example, a Windows printer driver. It is more effective and requires less
memory than using a STORE IMAGE...PRIMAGE sequence. The bitmap
image is printed directly and is not saved anywhere in the printer’s memory
after the image buffer has been cleared.
At the PRBUF statement, the printer waits for image data to be received on
the standard IN channel. PRBUF only works with binary transfers, that is
XON/XOFF must be disabled. You can optionally set a timeout between
characters (default 12.7 sec.) When the specifi ed number of bytes according
to the PRBUF protocol have been received, the image data are processed
directly into the printer’s image buffer and printed without requiring any
more Fingerprint instructions.
PRBUF does not work if <nexp
1
> bytes cannot be allocated. If memory is low,
it is possible to download the bitmap image in two or more blocks.
The fi eld settings (alignment, clipping, direction, xor mode, inverse image,
magnifi cation, x-position, and y-position) are handled by the current protocol,
but the basic rule is that x- and y-positions, fi eld clipping, and xor mode are
handled and the other attributes are ignored.
If PRPOS x,y, then the real print position will be PRPOS x,y+1.
The PRBUF protocol is decribed in Chapter 3, “Image Transfer.”
The <newline> is not part of the statement, but any combination of carriage
return (ASCII 13 dec,) and/or linefeed (ASCII 10 dec.) is allowed without
interfering with the PRBUF protocol.
Example This example shows how the printer is instructed to receive and print 1,424
bytes of image data according to the PRBUF protocol:
PRBUF 1424 ↵
<binary image data>