1. ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
  2. ZPL Commands
  3. ^GF
  • ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
^GF

^GF

The
^GF
 command allows you to download graphic field data directly into the printer’s bitmap storage area. This command follows the conventions for any other field, meaning a field orientation is included. The graphic field data can be placed at any location within the bitmap space.

Graphic Field

Format:
^GFa,b,c,d,data
Parameters
Details
a =
 compression type
Values:
A =
 ASCII hexadecimal (follows the format for other download commands)
B =
 binary (data sent after the
c
 parameter is strictly binary)
C =
 compressed binary (data sent after the
c
 parameter is in compressed binary format. The data is compressed on the host side using Zebra’s compression algorithm. The data is then decompressed and placed directly into the bitmap.)
Default:
A
b =
 binary byte count
Values:
1
 to
99999
This is the total number of bytes to be transmitted for the total image or the total number of bytes that follow parameter
d
. For ASCII download, the parameter should match parameter
c
. Out-of-range values are set to the nearest limit.
Default:
 command is ignored if a value is not specified
c =
 graphic field count
Values:
 1 to 99999
This is the total number of bytes comprising the graphic format (width x height), which is sent as parameter
d
. Count divided by bytes per row gives the number of lines in the image. This number represents the size of the image, not necessarily the size of the data stream (see
d
).
Default:
 command is ignored if a value is not specified
d =
 bytes per row
Values:
 1 to 99999
This is the number of bytes in the downloaded data that comprise one row of the image.
Default:
 command is ignored if a value is not specified
data =
 data
Values:
ASCII hexadecimal data:
00
 to
FF
A string of ASCII hexadecimal numbers, two digits per image byte. CR and LF can be inserted as needed for readability. The number of two-digit number pairs must match the above count. Any numbers sent after count is satisfied are ignored. A comma in the data pads the current line with
00
 (white space), minimizing the data sent.
~DN
 or any caret or tilde character prematurely aborts the download.
Binary data:
 Strictly binary data is sent from the host. All control prefixes are ignored until the total number of bytes needed for the graphic format is sent.
Example:
 This example downloads 8,000 total bytes of data and places the graphic data at location 100,100 of the bitmap. The data sent to the printer is in ASCII form.
^FO100,100^GFA,8000,8000,80,ASCII data
Example:
 This example downloads 8,000 total bytes of data and places the graphic data at location 100,100 of the bitmap. The data sent to the printer is in binary form.
^FO100,100^GFB,8000,8000,80,Binary data