zpl.tools
CommandsGraphics

~DG - Download Graphic

Downloads and stores graphic images to printer memory

~DG - Download Graphic

Overview

The ~DG command downloads and stores graphic images in printer memory. It puts the printer into Graphics Mode, names the graphic for later recall, defines the size of the graphic, and downloads the hexadecimal string representation of the image to the printer. This command is essential for storing custom graphics in printer memory for reuse in label formats.

Syntax

~DGd:o.x,t,w,DATA

Parameters

  • d = Destination device
    • R: = DRAM (volatile, default)
    • B: = Flash Memory (non-volatile)
  • o = Image name (1-8 alphanumeric characters, default: UNKNOWN)
  • x = Extension (fixed to .GRF)
  • t = Total number of bytes in graphic data
  • w = Number of bytes per row
  • DATA = ASCII hexadecimal string defining the image (each character represents 4 horizontal dots)

Description

  • Downloads custom graphics to printer memory
  • Stores graphics with user-defined names for later recall
  • Supports both DRAM and flash memory storage
  • Graphics are referenced by name when using ^XG (Recall Graphic)
  • Each character in the DATA string represents a horizontal nibble of four dots
  • Data is in ASCII hexadecimal format (0-9, A-F)

Usage Notes

  • The printer considers the graphic name to end at a space, period, or extension
  • Do not use spaces in graphic names
  • If two graphics have the same name, the first is replaced by the second
  • R: refers to DRAM (volatile memory)
  • B: refers to flash memory (non-volatile, survives power loss)
  • Graphics stored in DRAM are lost when power is removed

Example

~DGR:SAMPLE.GRF,00080,010,
FFFFFFFFFFFFFFFFFFFF
8000FFFF0000FFFF0001
8000FFFF0000FFFF0001
8000FFFF0000FFFF0001
FFFF0000FFFF0000FFFF
FFFF0000FFFF0000FFFF
FFFF0000FFFF0000FFFF
FFFFFFFFFFFFFFFFFFFF

Storing to Flash Memory

~DGB:LOGO.GRF,12012,39,
[hex data follows...]
  • ^XG - Recall Graphic
  • ^EG - Erase Downloaded Graphic
  • ^IM - Image Move
  • ^IL - Image Load
  • ^IS - Image Save
  • ^ID - Image Delete
  • ~DN - Abort Download Graphic

See Also