Skip to command documentation
Device onlyprinterdevicesession scope
^XS

Set Dynamic Media Calibration

^XS configures set Dynamic Media Calibration. It applies to the printer session and subsequent formats and controls printer hardware or connectivity rather than label pixels.

ZPLr compatibility note

  • Recognized by the renderer but has no label-raster effect.

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

Syntax
^XSlength,threshold,gain
length

Dynamic length calibration

Sets dynamic length calibration. It can be omitted when the documented default is suitable.

Default
Y
Required
No
Documented valuesYN

length variations

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

Side-by-side comparison2 variations

length = Y

Uses Y for dynamic length calibration while the other command values stay at representative defaults.

Edit in editor
ZPLcaret-xs-length-1.zpl
^XSY,Y,Y

length = N

Uses N for dynamic length calibration while the other command values stay at representative defaults.

Edit in editor
ZPLcaret-xs-length-2.zpl
^XSN,Y,Y
threshold

Dynamic threshold calibration

Sets dynamic threshold calibration. It can be omitted when the documented default is suitable.

Default
Y
Required
No
Documented valuesYN

threshold variations

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

Side-by-side comparison2 variations

threshold = Y

Uses Y for dynamic threshold calibration while the other command values stay at representative defaults.

Edit in editor
ZPLcaret-xs-threshold-1.zpl
^XSY,Y,Y

threshold = N

Uses N for dynamic threshold calibration while the other command values stay at representative defaults.

Edit in editor
ZPLcaret-xs-threshold-2.zpl
^XSY,N,Y
gain

Dynamic gain calibration (to be in a future implementation)

Sets dynamic gain calibration (to be in a future implementation). It can be omitted when the documented default is suitable.

Default
Y
Required
No
Documented valuesYN

gain variations

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

Side-by-side comparison2 variations

gain = Y

Uses Y for dynamic gain calibration (to be in a future implementation) while the other command values stay at representative defaults.

Edit in editor
ZPLcaret-xs-gain-1.zpl
^XSY,Y,Y

gain = N

Uses N for dynamic gain calibration (to be in a future implementation) while the other command values stay at representative defaults.

Edit in editor
ZPLcaret-xs-gain-2.zpl
^XSY,Y,N

Primary source

Official Zebra reference

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

Open Zebra documentation