Skip to command documentation
Device onlyprinterdevicesession scope
~SD

Set Darkness

~SD configures set Darkness. 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
~SD##
##

Desired darkness setting (two-digit number)

Sets desired darkness setting (two-digit number). It can be omitted when the documented default is suitable.

Default
last permanently saved value
Range
0–30
Required
No
Documented values0030

## variations

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

Side-by-side comparison2 variations

## = 00

Uses 00 for desired darkness setting (two-digit number) while the other command values stay at representative defaults.

ZPLtilde-sd-value-1.zpl
~SD00

## = 30

Uses 30 for desired darkness setting (two-digit number) while the other command values stay at representative defaults.

ZPLtilde-sd-value-2.zpl
~SD30

Primary source

Official Zebra reference

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

Open Zebra documentation