zpl.tools
Media and sensors

^CN - Cut Now

Cycles the cutter immediately, on a kiosk printer.

^CN cycles the cutter on a kiosk printer, where the cut is a separate act from the print rather than something that follows every label. It offers two depths: the partial cut ^KV configured, which leaves the receipt attached, or a full cut that separates it.

Syntax

^CNa

Support

Recognised, deliberately skippedparsed: none · state: none · rendered: none

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 operates the cutter. A render has no cutter and no media to cut. 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

aOverriderequired · one of a set

Whether the printer cuts by the amount ^KV configured or cuts fully through the media.

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).
0
Use the default kiosk cut amount from ^KV
1
Perform a full cut

Behavior

Value 0 defers to ^KV. Where nothing ever sets ^KV, the depth comes from the printer's own configuration rather than from this command.

Position matters on hardware, because the media must pass the cutter before anything is there to cut. ^CN acts on the label the printer just printed. ^MM covers the ordinary case: cutter mode cuts after every label, with no ^CN anywhere.

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.

  • ^CN has no page and no command-index entry in the guide edition this service holds (45541L-004, 2006). The ^KV that it defers to has none either. Every parameter fact on this page comes from Labelary's reference. — not pinned by a test

Example

A full cut after the field it separates:

^XA
^FO50,50^A0N,40,40^FDReceipt^FS
^CN1
^XZ

Open in viewer

  • ^CP Remove LabelThis command ejects or retracts a printed label from the presenter.
  • ^KV Kiosk ValuesSets the cutter and presenter distances used when `^MM` puts the printer in kiosk mode.
  • ^MM Print ModeThis command selects what happens to a label after the print: tear-off, peel-off, rewind, cut or applicator.