add --halfcut for printers with a half cutter

Sends ESC i K (advanced mode settings) with the half cut bit, and the chain bit
according to --chain. The command is only sent when an option needs it, so
printers that do not know it see no change; on the PT-D460BT family it
replaces the separate chain command, which is the same command.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Philipp MundhenkandClaude Opus 5.5 authored and Dominic Radermacher committed 2026-11-14 19:01:08 +01:00
1 parent 0aed8932eb
commit 2e7185a787
4 files changed
+48 -2

No files matched your search

+8
View File
@@ -49,6 +49,13 @@ typedef enum _pt_page_flags {
MIRROR = (1 << 7),
} pt_page_flags;
/* ESC i K - advanced mode settings */
#define ADV_HALF_CUT (1 << 2) /* cut the tape, but not its backing */
#define ADV_NO_CHAIN (1 << 3) /* feed and cut after the last label */
#define ADV_SPECIAL_TAPE (1 << 4) /* no cutting at all */
#define ADV_HIGH_RES (1 << 6) /* 2x resolution along the tape */
#define ADV_NO_BUFFER_CLEAR (1 << 7)
struct _pt_dev_info {
int vid; /* USB vendor ID */
int pid; /* USB product ID */
@@ -128,6 +135,7 @@ int ptouch_enable_packbits(ptouch_dev ptdev);
int ptouch_info_cmd(ptouch_dev ptdev, int size_x);
int ptouch_send_precut_cmd(ptouch_dev ptdev, int precut);
int ptouch_send_margin(ptouch_dev ptdev, int dots);
int ptouch_send_advanced_mode(ptouch_dev ptdev, uint8_t mode);
int ptouch_rasterstart(ptouch_dev ptdev);
int ptouch_sendraster(ptouch_dev ptdev, uint8_t *data, size_t len);
void ptouch_rawstatus(uint8_t raw[32]);
+5
View File
@@ -85,6 +85,11 @@ that would otherwise cut off parts of the printed text or image.
Blank tape the printer adds before and after the label, in dots (0 to 1000).
Without this option the printer uses its default of 14 dots (2 mm at 180 dpi).
Small values save tape, mostly in chain mode.
.TP
.BR \-\-halfcut
Cut through the tape but not its backing between labels, so a strip of labels
stays in one piece. Only for printers with a half cutter (for example the
PT-P900 series); other printers ignore it.
.SS "Getting help and display information"
.TP
+8
View File
@@ -352,6 +352,14 @@ int ptouch_send_margin(ptouch_dev ptdev, int dots)
return ptouch_send(ptdev, cmd, sizeof(cmd)-1);
}
/* 1B 69 4B {n} = ESC i K = advanced mode settings, see ADV_* in ptouch.h */
int ptouch_send_advanced_mode(ptouch_dev ptdev, uint8_t mode)
{
uint8_t cmd[] = "\x1b\x69\x4b\x00";
cmd[3] = mode;
return ptouch_send(ptdev, cmd, sizeof(cmd)-1);
}
int ptouch_rasterstart(ptouch_dev ptdev)
{
if (!ptdev) {
+27 -2
View File
@@ -67,6 +67,7 @@ struct arguments {
int timeout;
char *serial;
int feed;
bool halfcut;
};
typedef enum { JOB_CUTMARK, JOB_IMAGE, JOB_PAD, JOB_TEXT, JOB_UNDEFINED } job_type_t;
@@ -121,6 +122,7 @@ static struct argp_option options[] = {
{ "chain", 10, 0, 0, "Skip final feed of label and any automatic cut", 2},
{ "precut", 11, 0, 0, "Add a cut before the label (useful in chain mode for cuts with minimal waste)", 2},
{ "feed", 13, "<dots>", 0, "Blank tape before and after the label in dots (printer default: 14)", 2},
{ "halfcut", 14, 0, 0, "Cut only the tape, not its backing, between labels (printers with a half cutter)", 2},
{ "newline", 'n', "<text>", 0, "Add text in a new line (up to 4 lines). \\n will be replaced by a newline", 2},
{ "align", 'a', "<l|c|r>", 0, "Align text (when printing multiple lines)", 2},
@@ -148,7 +150,8 @@ struct arguments arguments = {
.verbose = 0,
.timeout = -1, /* -1 = not given; 0 is already "infinity" */
.serial = NULL,
.feed = -1 /* -1 = printer default */
.feed = -1, /* -1 = printer default */
.halfcut = false
};
job_t *jobs = NULL;
@@ -185,6 +188,17 @@ void rasterline_setpixel(uint8_t* rasterline, size_t size, int pixel)
return;
}
/* The ESC i K bits the options ask for, without the chain bit; 0 = do not
send the command, so printers without it see no change. */
static uint8_t advanced_mode(void)
{
uint8_t mode = 0;
if (arguments.halfcut) {
mode |= ADV_HALF_CUT;
}
return mode;
}
int print_img(ptouch_dev ptdev, gdImage *im, int chain, int precut)
{
uint8_t rasterline[(ptdev->devinfo->max_px)/8];
@@ -242,7 +256,15 @@ int print_img(ptouch_dev ptdev, gdImage *im, int chain, int precut)
}
}
/* send chain command after precut, to allow precutting before chain */
if ((ptdev->devinfo->flags & FLAG_D460BT_MAGIC) == FLAG_D460BT_MAGIC) {
uint8_t advanced = advanced_mode();
if (advanced) {
/* ESC i K also carries the chain bit, so it replaces the PT-D460BT
chain command */
ptouch_send_advanced_mode(ptdev, advanced | (chain ? 0 : ADV_NO_CHAIN));
if (arguments.debug) {
printf(_("send advanced mode command (0x%02x)\n"), advanced | (chain ? 0 : ADV_NO_CHAIN));
}
} else if ((ptdev->devinfo->flags & FLAG_D460BT_MAGIC) == FLAG_D460BT_MAGIC) {
if (chain) {
ptouch_send_d460bt_chain(ptdev);
if (arguments.debug) {
@@ -714,6 +736,9 @@ static error_t parse_opt(int key, char *arg, struct argp_state *state)
arguments->feed = (int)v;
break;
}
case 14: // halfcut
arguments->halfcut = true;
break;
case 'a': // align
if ((strcmp(arg, "c") == 0) || (strcmp(arg, "center") == 0)) {
arguments->align = ALIGN_CENTER;