^CP - Remove Label
Ejects or retracts a printed label from the presenter.
^CP clears a printed label nobody collected. A kiosk printer holds the label in the
presenter until someone takes it, and ^CP either pushes it out or pulls it back
inside. It acts on media the printer already printed, so it can never change what is on
it.
Syntax
^CPaSupport
Accepted and skipped, because it configures the printer rather than the label. It cannot change the rendered output, and Labelary skips it too.
This command clears a label that an operator did not take. It moves finished media and cannot change the image on it. 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
aRemoval moderequired · one of a setWhat the printer does with the uncollected label.
- 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 (0, 1, 2).
0- Eject the label
1- Retract the label
2- Use the mode
^KVspecified
Behavior
Mode 2 defers the choice to whatever ^KV configured. Use it where the policy belongs
to the printer setup rather than to the format.
^CP needs a printer that presents labels, which is ^MMK in the print-mode list.
^CN drives the cutter on the same hardware.
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.
^CPhas no page and no command-index entry in the guide edition this service holds (45541L-004, 2006). The^KVthat it defers to has none either. Every parameter fact on this page comes from Labelary's reference. — not pinned by a test
Example
An eject instruction alongside the label it applies to:
^XA
^CP0
^FO50,50^A0N,40,40^FDEjected^FS
^XZ
Related commands
^CNCut NowThis command operates the cutter immediately on a kiosk printer.^KVKiosk ValuesSets the cutter and presenter distances used when `^MM` puts the printer in kiosk mode.^MMPrint ModeThis command selects what happens to a label after the print: tear-off, peel-off, rewind, cut or applicator.^PNPresent NowEjects a section of the current label so the operator can take it.