Skip to command documentation
Partialstoragejobsession scope
~DY

Download Objects

~DY configures download Objects. It applies to the printer session and subsequent formats and changes job or printer-session state used while processing labels.

ZPLr compatibility note

  • Legacy BAR-ONE AR-compressed (C) payloads are diagnosed but not decoded.
  • Image decoding covers non-interlaced 1/2/4/8-bit grayscale or indexed PNG plus 8-bit-per-channel grayscale-alpha, RGB, or RGBA PNG; Windows BMP and OS/2 1.x core-header BMP; and 1-bit planar, 8-bit indexed/grayscale, or 24-bit RGB PCX.

These are code examples only. This printer or session command does not produce a standalone label image.

Syntax
~DYd:f,b,x,t,w,data
d

File location .NRD and .PAC files reside on E: in firmware versions V60.15.x, V50.15.x, or later

Sets file location .NRD and .PAC files reside on E: in firmware versions V60.15.x, V50.15.x, or later. It can be omitted when the documented default is suitable.

Default
R:
Required
No
Documented valuesR:

d variations

Compare values side by side; other parameters remain at representative defaults.

Side-by-side comparison2 variations

d = R:

Uses R: for file location .NRD and .PAC files reside on E: in firmware versions V60.15.x, V50.15.x, or later while the other command values stay at representative defaults.

ZPLtilde-dy-d-1.zpl
~DYR::OBJECT,A,B,0,0,data

d = E:

Uses E: for file location .NRD and .PAC files reside on E: in firmware versions V60.15.x, V50.15.x, or later while the other command values stay at representative defaults.

ZPLtilde-dy-d-2.zpl
~DYE::OBJECT,A,B,0,0,data
f

File name

Sets file name. It can be omitted when the documented default is suitable.

Default
if a name is not specified, UNKNOWN is used
Required
No
Documented valuesOBJECT18

f variations

Compare values side by side; other parameters remain at representative defaults.

Side-by-side comparison2 variations

f = OBJECT

Uses OBJECT for file name while the other command values stay at representative defaults.

ZPLtilde-dy-f-1.zpl
~DYR::OBJECT,A,B,0,0,data

f = 1

Uses 1 for file name while the other command values stay at representative defaults.

ZPLtilde-dy-f-2.zpl
~DYR::1,A,B,0,0,data
b

Download data format

Sets download data format. It can be omitted when the documented default is suitable.

Default
a value must be specified
Required
No
Documented valuesABCP

b variations

Compare values side by side; other parameters remain at representative defaults.

Side-by-side comparison3 variations

b = A

Uses A for download data format while the other command values stay at representative defaults.

ZPLtilde-dy-b-1.zpl
~DYR::OBJECT,A,B,0,0,data

b = B

Uses B for download data format while the other command values stay at representative defaults.

ZPLtilde-dy-b-2.zpl
~DYR::OBJECT,B,B,0,0,data

b = P

Uses P for download data format while the other command values stay at representative defaults.

ZPLtilde-dy-b-3.zpl
~DYR::OBJECT,P,B,0,0,data
x

Stored-file extension

Sets stored-file extension. It can be omitted when the documented default is suitable.

Default
a value other than the accepted values defaults to
Required
No
Documented valuesBEGPTXNRDPACCFHTTE

x variations

Compare values side by side; other parameters remain at representative defaults.

Side-by-side comparison3 variations

x = B

Uses B for stored-file extension while the other command values stay at representative defaults.

ZPLtilde-dy-x-1.zpl
~DYR::OBJECT,A,B,0,0,data

x = E

Uses E for stored-file extension while the other command values stay at representative defaults.

ZPLtilde-dy-x-2.zpl
~DYR::OBJECT,A,E,0,0,data

x = TTE

Uses TTE for stored-file extension while the other command values stay at representative defaults.

ZPLtilde-dy-x-3.zpl
~DYR::OBJECT,A,TTE,0,0,data
t

Total bytes in file

Sets total bytes in file. It can be omitted when the documented default is suitable.

Required
No
Documented values0

t variations

Compare values side by side; other parameters remain at representative defaults.

Side-by-side comparison2 variations

t = 0

Uses 0 for total bytes in file while the other command values stay at representative defaults.

ZPLtilde-dy-t-1.zpl
~DYR::OBJECT,A,B,0,0,data

t = 1

Uses 1 for total bytes in file while the other command values stay at representative defaults.

ZPLtilde-dy-t-2.zpl
~DYR::OBJECT,A,B,1,0,data
w

Bytes per row

Sets bytes per row. It can be omitted when the documented default is suitable.

Required
No
Documented values0

w variations

Compare values side by side; other parameters remain at representative defaults.

Side-by-side comparison2 variations

w = 0

Uses 0 for bytes per row while the other command values stay at representative defaults.

ZPLtilde-dy-w-1.zpl
~DYR::OBJECT,A,B,0,0,data

w = 1

Uses 1 for bytes per row while the other command values stay at representative defaults.

ZPLtilde-dy-w-2.zpl
~DYR::OBJECT,A,B,0,1,data
data

Data

Sets data. It can be omitted when the documented default is suitable.

Required
No
Documented valuesdata

data variations

Compare values side by side; other parameters remain at representative defaults.

Side-by-side comparison2 variations

data = data

Uses data for data while the other command values stay at representative defaults.

ZPLtilde-dy-data-1.zpl
~DYR::OBJECT,A,B,0,0,data

data = SAMPLE

Uses SAMPLE for data while the other command values stay at representative defaults.

ZPLtilde-dy-data-2.zpl
~DYR::OBJECT,A,B,0,0,SAMPLE

Primary source

Official Zebra reference

Use the manufacturer reference for printer- and firmware-specific behavior beyond ZPLr’s pinned rendering profile.

Open Zebra documentation