zpl.tools
CommandsGraphics

^IM - Image Move

Moves graphic images from storage to bitmap at original size

^IM - Image Move

Overview

The ^IM command performs a direct move of an image from storage area into the bitmap. This instruction is identical to the Recall Graphic (^XG) command except that there are no sizing parameters, making it faster for printing images at their original size without magnification.

Syntax

^

Parameters

  • d = Source device (optional, searches in priority order if omitted)
    • R: = DRAM
    • B: = Flash Memory
  • o = Name of stored graphic (1-8 alphanumeric characters)
  • x = Extension (.GRF)

Description

  • Moves stored graphics to the label bitmap
  • No magnification support (uses original size only)
  • Faster than ^XG when no scaling is needed
  • Graphics must be positioned using ^FO command
  • Same image can be moved to multiple positions in a label
  • Optimized for performance on bit-aligned boundaries

Usage Notes

  • Unlike ^XG, this command does NOT support magnification
  • Image is always printed at its original size
  • May require less processing time than ^XG, especially on 8, 16, or 32-bit boundaries
  • Use ^FO (Field Origin) to position the graphic anywhere on the label
  • Field separator ^FS is required after the command
  • Better performance when images are bit-boundary aligned

Example - Multiple Positions

^XA ^FO100,100^^FS ^FO100,200^^FS ^FO100,300^^FS ^FO100,400^^FS ^FO100,500^^FS ^XZ

Example - Without Device Specification

^XA
^FO50,50^IMLOGO.GRF^FS
^XZ

Example - Logo Placement

^XA
^LH0,0
^FO10,10^IMR:HEADER.GRF^FS
^FO10,150^A0,40,30^FDProduct Details^FS
^FO10,300^IMR:FOOTER.GRF^FS
^XZ

Performance Considerations

  • For best performance, align images on 8, 16, or 32-bit boundaries
  • No magnification overhead means faster processing
  • Use when full-size graphics are needed
  • ^XG - Recall Graphic (with magnification option)
  • ~DG - Download Graphic
  • ^IL - Image Load
  • ^IS - Image Save
  • ^ID - Image Delete
  • ^FO - Field Origin

See Also