^IL — Image Load

Plain English

Loads a previously-stored image from a printer storage device into the **label background bitmap** at the start of a format. The path takes the standard `d:name.ext` form: `d` is the storage device (`R:` volatile RAM, `E:` onboard flash — default if omitted, `B:` optional memory module), `name.ext` is the filename (commonly `.GRF`, but firmware also accepts `.PCX`/`.PNG`/`.BMP` if those formats are stored). Unlike `^XG` which positions a stored asset at the current `^FO` origin, `^IL` paints the entire image into the label canvas as a backdrop that subsequent fields render on top of.

When to use

For a full-label background watermark or pre-printed-form overlay where every other field draws on top — invoice templates, hazard-banded labels, branded receipts. Pick `^IL` for "background-image-and-then-fields", `^XG` for "drop a stored logo at this XY with optional magnification", and `^IM` for "place an unscaled image inline at the current FO". `^IL` must precede the fields that should appear over it; storage device follows the same `R:`/`E:`/`B:` semantics as `^XG`/`^XF`.

Syntax

^ILd:o.x

Parameters

Example

^XA
^ILE:BACKGROUND.PCX
^FO50,50^A0N,30,30^FDOverlay text^FS
^XZ

Load `BACKGROUND.PCX` from onboard flash (`E:`) as the label background, then overlay a 30-dot text field at FO 50,50. The PCX renders behind every subsequent field on this label.