^SI - Set Sensor Intensity
Sets one media-sensor brightness or baseline value on its own.
^SI sets a single media-sensor value — the brightness of the sensor's LED or its
baseline reading — instead of the nine values ^SS rewrites at once. It is the finer
of the two manual overrides: it corrects one figure a calibration got wrong, and
leaves the rest of the set alone.
Syntax
^SIa,bSupport
Accepted and skipped, because it configures the printer rather than the label. It cannot change the rendered output, and Labelary skips it too.
A narrower version of ^SS. It adjusts one sensor reading, not all nine, and tunes hardware that a render does not have. The renderer does not parse this command. It reports IGNORED_COMMAND at info severity, which does not reach X-Warnings. Labelary is also silent, so the rendered label is identical in both engines. — not pinned by a test
Labelary renders this command.
Parameters
aSettingrequired · one of a setWhich sensor property the second argument applies to.
- Invalid value
- not documented, and we have not measured it. The renderer does not parse or measure this command. The reference gives no default.
- Test coverage
- No documented value is exercised by a test (1, 2).
1- Brightness
2- Baseline
bValuerequired · integerThe intensity to set for the chosen property.
- Accepted range
- 0 to 196
- Invalid value
- not documented, and we have not measured it. The renderer does not parse or measure this command. The reference gives no default.
- Test coverage
- No test at the minimum, maximum or one step outside the range.
Behavior
The scale is its own, so a figure is not portable between the two commands:
^SItakes 0 to 196.- The guide gives the
^SSintensities 0 to 100. - Labelary gives them 0 to 255.
A value set by hand here is a value ~JC or ~JG otherwise measures, and a later
calibration overwrites it. Check ^XS for the same reason: with dynamic calibration
on, the printer re-measures as it goes, and a manual value can disappear after a few
labels.
The renderer does not parse this command. It reports IGNORED_COMMAND at info
severity, which does not reach X-Warnings. Labelary is also silent, so the rendered
label is identical in both engines.
Differences from the specification
Labelary against the ZPL II guide
Where Labelary — our compatibility target — behaves differently from the printed specification.
^SIhas no page and no command-index entry in the guide edition this service holds (45541L-004, 2006). Every parameter fact on this page comes from Labelary's reference. — not pinned by a test
Example
A baseline value set ahead of a label.
^XA
^SI2,100
^FO50,50^A0N,40,40^FDBaseline 100^FS
^XZ
Related commands
^SSSet Media SensorsThis command overrides every media-sensor threshold and LED intensity by hand, without a calibration.^JSSensor SelectThis command selects the reflective media sensor or the transmissive media sensor.~JCSet Media Sensor CalibrationThis command runs a full calibration of both the label length and the sensor thresholds.~JGGraphing Sensor CalibrationThis command calibrates the sensors and prints a diagnostic label that graphs the readings.