Files
ptouch-print/ptouch-print.1
T
Philipp MundhenkandClaude Opus 5.5 600a24599c add --hires for 2x resolution along the tape
Sets the high resolution bit of ESC i K. The image is sent as it is, so it has
to be twice as long; --writepng records the doubled horizontal resolution in
the PNG.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 19:01:17 +01:00

154 lines
4.9 KiB
Groff

.\" Man page for ptouch-print
.\"
.\" Copyright (C) 2015-2023 Dominic Radermacher
.\"
.\" You may distribute under the terms of the GNU General Public License.
.\"
.TH PTOUCH-PRINT 1 "2023-03-13" "1.5" "ptouch printer util"
.SH NAME
ptouch-print \- a command line tool to use Brother Ptouch label printers
.SH SYNOPSIS
.\" The general command line
.B ptouch-print
.RI [\| "options" \|]\ <\| print\ command\ options\|>
.SH DESCRIPTION
.B ptouch-print
is a command line tool that can be used to print labels with several
Brother Ptouch label printers.
.SH OPTIONS
General options, font selection options and optput options are valid for the
whole printout and should be given only once.
Each duplication will override the previous argument value.
Any of the printing command options can be given more than
once in any order, and will be executed in the given order.
.SS "General options"
.TP
.BR \-\-debug
Enables printing of debugging information.
.TP
.BR \-\-timeout\ \fI<time>
Set the seconds ptouch-print is waiting for finishing a previous ptouch-print command.
Default is 1 second. 0 (zero) means wait forever.
Useful if ptouch-print is used in a script multiple times, and the device is waiting for the user
to use the mechanical cutter.
.TP
.BR \-\-serial\ \fI<serial>
Use the printer with this USB serial number, when more than one printer is connected.
Use \-\-list\-connected to see the serial numbers.
.SS "Font selection options"
.TP
.BR \-\-fontmargin\ \fI<size>
When auto-detecting font size account for a margin above and below the text.
.TP
.BR \-\-fontsize\ \fI<size>
Disable auto-detection of the font size and force the font size to the size
given as argument. Please note that text will be cut off if you specify a
too large font size here.
.TP
.BR \-\-font\ \fI<fontname>
Set the font to the fontname given as argument.
.SS "Output control options"
.TP
.BR \-\-writepng\ \fI<file>
Instead of printing to the label printer, write the output in a PNG image
file (which can be printed later using the --image printing command option).
.SS "Printing command options"
.TP
.BR \-\-text\ \fItext
Print the given text at the current position. Text including spaces must be
enclosed in question marks.
Literal '\\n' or actual newline characters in the text will be treated as
line breaks.
To print a text in multiple lines, either use '\\n' or use the -n argument.
Also see the
.BR EXAMPLES
section.
.TP
.BR \-\-image\ \fIimage.png
Print the image file at the current position. The image file must be a two
color, palette based image in PNG format.
.TP
.BR \-\-cutmark
Print a cutmark (dashed line) at the current position.
.TP
.BR \-\-pad\ \fI<n>
Print <n> pixels of white space at the current position. Useful for printers
that would otherwise cut off parts of the printed text or image.
.TP
.BR \-\-feed\ \fI<dots>
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.
.TP
.BR \-\-cut-every\ \fI<n>
Together with \-\-copies: turn on auto cut and cut only after every <n>
labels (1 to 99), so the labels in between stay joined.
.TP
.BR \-\-hires
Print with twice the resolution along the tape (180x360 dpi, or 360x720 dpi on
360 dpi printers). Every image column is half as long, so images must be
twice as long as for normal printing. Only some printers support it (for example
the PT-P750W and the PT-P900 series); it is slower.
.SS "Getting help and display information"
.TP
.BR \-? ", " \-\-help
Print a help message and exit.
.TP
.BR \-\-version
Display version information and exit.
.TP
.BR \-\-info
Show info about the tape detected (like printing width etc.) and exit.
.TP
.BR \-\-list-supported
List all supported printers
.TP
.BR \-\-list-connected
List all connected printers with their USB serial numbers, for use with \-\-serial
.SH DEFAULTS
The default font used is 'DejaVuSans'.
.TP
The default fontsize is auto-detected, depending on the used tape width and font.
.SH "EXIT STATUS"
.TP
.B 0
Successful program execution.
.TP
.B 1
Usage syntax error.
.TP
.B 5
Printer device could not been opened.
.SH EXAMPLES
.TP
\fBptouch-print\fR \fI--text\fR 'Hello World'
Print the text 'Hello World' in one line
.TP
\fBptouch-print\fR \fI--text\fR 'Hello' -n 'World'
Print the text 'Hello World' in two lines ('Hello' in the first line
and 'World' in the second line).
.TP
\fBptouch-print\fR \fI--image\fR icon.png
Print the image contained in the PNG image file 'icon.png'.
The image file must be palette based PNG format with two colors.
.SH AUTHOR
Written by Dominic Radermacher (dominic@familie-radermacher.ch).
Also see https://dominic.familie-radermacher.ch/projekte/ptouch-print/