zpl.tools
CommandsGraphics

^HG - Host Graphic

Uploads graphic images from printer to host computer

^HG - Host Graphic

Overview

The ^HG command is used to send (upload) a graphic from the printer to the host computer. This graphic image can be stored by the host for future use and can be downloaded back to the original printer or to any other Zebra printer. This is the reverse operation of ~DG (Download Graphic).

Syntax

^

Parameters

  • n = Full name of graphic to upload (including device and extension)
    • Format: device:name.extension
    • Example: R:LOGO.GRF or B:SAMPLE.GRF

Description

  • Uploads graphics FROM the printer TO the host computer
  • Uploads in the same hexadecimal format used by ~DG
  • Stored graphics can be used on any Zebra printer
  • Full object name including device and extension is required
  • Host application must be ready to receive the graphic data
  • Useful for backing up graphics or transferring between printers

Usage Notes

  • This command sends data from printer to host (opposite of ~DG)
  • The full name must include the device prefix (R: or B:)
  • The full name must include the extension (.GRF)
  • Host software must be configured to receive and store the data
  • Graphics uploaded from one printer model can be used on other models
  • Useful for backup and archival purposes

Example - Upload from DRAM

^

Example - Upload from Flash Memory

^

Typical Host-Printer Workflow

1. Printer receives ~DG command and stores graphic
2. Later, host sends ^HG command to retrieve graphic
3. Printer uploads graphic in hexadecimal format
4. Host stores the graphic data in a file
5. Host can later send ~DG to any printer to restore it
  • ~DG - Download Graphic (opposite direction)
  • ^XG - Recall Graphic
  • ^IM - Image Move
  • ^IL - Image Load
  • ^IS - Image Save
  • ^ID - Image Delete

See Also