If printing does not begin (main most frequent cause) ....................................................11 2
If a template linked to a database is not printed ..............................................................112
Appendix D: Introducing the Brother Developer Center ····························· 113
- iii -
P-touch Template Command Reference
Introduction
This material provides the necessary information for directly controlling the templates transferred to PT-P9XX.
This information is provided assuming that the user has full understanding of the operating system being used
and basic mastery of programming in a developer's environment.
Read the model names that appear in the screens in this manual as the name of your printer.
We accept no responsibility for any problems caused by programs that you develop using the information
provided in this material, affecting software, data or hardware, including the PT-P9XX, and any problems
resulting directly or indirectly from them. Use this material only if you accept these terms.
This material shall not be reproduced, in part or in full, without prior approval. In addition, this material shall
not be used as evidence in a lawsuit or dispute in a way that is unfavorable towards our company.
- 1 Introduction
P-touch Template Command Reference
2.Design the
1.Set up the printer from the computer according to
configuration of the host device.
3. Transfer the
What is P-touch Template?
P-touch Template is a tool for transferring ASCII text and binary data from a host device to a template
transferred to the printer. This transferred data is inserted into text objects or bar code objects in the
template.
template in
P-touch Editor,
and then transfer
it to the printer.
data (text) from
the host device,
and then print it
in the template.
This allows the user to develop a printing system that connects directly from the host device.
Compatible host devices are listed below.
- Scale/measurement devices
- Medical devices
- Bar code readers
- Control devices in any system environment
Note
* The host device should be equipped with a connector for a serial cable (RS-232C) or USB-A cable in
order to transfer the data.
* P-touch Te mplate is not compatible with some hosts.
- 2 -
What is P-touch Template?
touch Template Settings tool, specify the initial
printer settings according to the host system environment
touch Template Settings Tool User’s
The printer driver must first be installed via a USB
touch Editor, design the template to be transferred
touch Transfer Manager, transfer the templates to
dance with the
Connect the printer to the host device by using a serial
1. Using P-touch Template
(1) Set up the printer.
Using the P-
or the host that the printer is connected to.
(Please refer to “2. P-
Guide” )
connection.
(2) Design the template.
Using Pto the printer.
P-touch Template Command Reference
(Please refer to “4. P-touch Template Limitations”)
(3) Transfer the templates.
Using Pthe printer.
(Please refer to the PT-900 Series Software User’s Guide.)
(4) Program using P-touch Template commands.
If any special commands are required to control the printer,
change the terminal program in accor
P-touch Template commands.
(Please refer to “6. Control Code Lists”)
(5) Connect the printer with the host and print slips etc.
cable (RS-232C) or USB-A cable.
Transfer the data, such as ASCII text, from the host device
to templates on the machine, and print the labels
- 3 -
1. Using P-touch Template
2. P-touch Template Settings Tool User’s Guide
(1) Command mode setting
(2) Template number setting
(3) Delimiter setting
(4) Print start trigger setting
(5) Print start command
P-touch Template Command Reference
text string setting
(6) Print start data amount setting
(7) Character code set setting
(8 ) International character setting
(9) Prefix character setting
(10) Non-printed character setting
(11) Line feed character setting
(12) FNC1 replacement setting
(13) Number of copies setting
(14 ) Auto cut setting
(15) Half cut setting
(16) Special tape setting
(17) Cut number setting
(18) Chain printing setting
(19) Mirror printing setting
(20) Communication settings
Applies settings for (1) through (20) to the machine.
Closes the tool.
Returns (1) through (19) to their default settings.
- 4 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template Command Reference
(1) Command mode setting
- P-touch Template mode (Fixed)
To use P-touch Template, select the P-touch Template mode.
(2) Template number setting
Specify the template number selected as the default when the machine is turned on.
However, if any template has been set to not be transferred to the machine, the number of that template
cannot be specified.
(3) Delimiter setting
A delimiter is the symbol used to indicate when to move to the next object in data that is being sent.
Between 1 and 20 characters can be specified.
(4) Print start trigger setting
Select one of the following three options for the print start trigger.
- Command Character
(Printing starts when the command character specified in (5) is received.)
- Data Insertion into All the Objects
(Printing starts when the delimiter for the last object is received.)
- Received Data Size
(Printing starts when the number of characters specified in (6) is received. However, delimiters are not
counted in the number of characters.)
(5) Print start command text string setting
Specify 1 to 20 characters.
- 5 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template Command Reference
(6) Print start data amount setting
The amount of data that must be received before printing can begin can be set between 1 and 999.
(7) Character code set setting
Select one of the following three character codes. For details on the character code tables,
refer to the character code tables in the P-touch Template Command Reference.
Windows 1252
Windows 1250
Brother standard
(8) International character setting
Select one of the following as the character set of the country.
- USA
- France
- Germany
- UK
- Denmark
- Sweden
- Italy
- Spain
- Japan
- Norway
- Denmark II
- Spain II
- Latin America
- Korea
- Legal
The following 12 codes are switched depending on the country selected from those listed above.
23h 24h 40h 5Bh 5Ch 5Dh 5Eh 60h 7Bh 7Ch 7Dh 7Eh
For the characters that are switched, refer to the“International character set table”in “Appendix B:
Character Code Tables”.
(9) Prefix character setting
Change the prefix character code. Specify as a one-character character code.
The prefix character is the code for the first character that identifies commands that can be used in
P-touch Template mode.
- 6 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template Command Reference
(10) Non-printed character setting
The characters specified here are not printed when data is received. Specify 1 to 20 characters.
(11 ) Line feed character setting
The line feed code is used when feeding data to indicate that the following data should be moved to the
next line in a text object. One of the following four line feed codes can be selected, or 1 to 20 characters
can be specified as the line feed code.
1.^CR 2.\0D\0A 3.\0A 4.\0D
(12) FNC1 replacement setting
This setting selects whether or not GS codes, which are included in bar code protocols such as GS1-128
(UCC/EAN-128), are replaced with FNC1 codes.
If the check box is selected, a received GS code is replaced with the FNC1 code. If the check box is
cleared, a received GS code is outputted as is.
(13) Number of copies setting
Specify the number of copies. A number between 1 and 99 can be specified.
(14) Auto cut setting
If auto cutting is selected, the cut operation will be performed after the number of labels specified in (17).
(15) Half cut setti ng
Specifies half cutting. If the check box is selected, half cuts are made. If the check box is cleared, half cuts
are not made.
(16) Special tape setting
Specifies the special tape (no cut) setting. If the check box is selected, the special tape setting is enabled,
and the auto cut and chain printing settings are disabled (same as being turned off). If the check box is
cleared, the special tape setting is disabled, and the operations for the auto cut and chain printing settings
are performed as specified.
Returns the four parameters to
thei r default settin gs.
Closes the Communication
Settings dialog box.
(17) Cut number setting
A number between 1 and 99 can be specified.
(18) Chain printing setting
Specifies chain printing. If the check box is selected, chain printing is enabled, and the tape is not fed or
automatically cut after the last label is printed. If the check box is cleared, chain printing is disabled, and
the tape is fed and automatically cut after the last label is printed.
(19) Mirror printing setting
Specifies mirror printing. If the check box is selected, mirror printing is enabled. If the check box is cleared,
mirror printing is disabled.
(20) Communication settings
Settings can be specified for the following parameters for serial communication.
Baud rate
Applies the four settings to the printer.
- 8 -
2. P-touch Template Settings Tool User’s Guide
P-touch Template Command Reference
Others
・ini file
After the [Set] button (in the main dialog box or the Communications Settings dialog box) is clicked, the
settings are saved and the dialog box is closed.
C: \Users\ (user_account_name) \AppData\Roaming\Brother\Printer Settings\ptsXX30.ini
Note: A name of file “ptsXX30.ini” varies depending on printers like below.
- PT-P900W pts6F30.ini
- PT-P950NW pts7030ini
Note: A file path above might be different depending on OS.
・Entering text in text boxes (3), (5), (9) and (10)
Characters that can be entered as text can be typed in, and control codes can be entered as ASCII codes
(00 to FF) with \ in front of them.
Example: PRINT : [PRIN T]
TAB control code : [\09]
Return control code : [\0D]
\ : [\\]
- 9 -
2. P-touch Template Settings Tool User’s Guide
3. Examples for Using Commands
3.1 Example for using P-touch Template
Here is the label that will be made.
The media size is 0.70 inches
Steps
P-touch Template Command Reference
1. Make a template with P-touch Editor.
2. Transfer the template to Transfer Manager.
3. Transfer the template from Transfer Manager to the printer.
4. Use P-touch Template commands for printing.
Step 1: Make a template with P-touch Editor.
Start the P-touch Editor and make a label.
- 10 -
3. Examples for Using Commands
Step 2: Transfer the template to Transfer Manager.
The template sent in step 2 is stored in Transfer Manager, as shown below.
P-touch Template Command Reference
Stored template
Assigned number
Step 3: Transfer the template from Transfer Manager to the printer.
Click [Transfer] button.
- 11 -
3. Examples for Using Commands
P-touch Template Command Reference
Note
Make sure that the printer is turned on and hooked up to the PC with a USB cable before using
Transfer Manager. Also, make sure that the printer communication setting is always bidirectional
communication when Transfer Manager is used.
When the template is transferred to the printer, the following message appears.
Step 4: Use P-touch Template commands for printing.
When using P-touch Template commands, at least these four commands are required.
However, two out of the four can be set by using the P-touch Template Settings tool.
(1) Select the P-touch Template mode (Fixed)
(2) Choose the assigned number
After setting (1) and (2) with the P-touch Template Settings tool, the other two commands must be sent
to the printer.
- 12 -
3. Examples for Using Commands
^II
Entered command
^FF
Entered command
(3) Initialize P-touch Template
(4) Print Start
P-touch Template Command Reference
When the printer receives the command above, the label below is printed.
- 13 -
3. Examples for Using Commands
2. Store the logo/external characters as a bitmap file, and drag & drop it to Transfer Manager.
3.2 Example for printing logo/external characters in P-touch Template
Here is the label to be printed.
P-touch Template Command Reference
Steps
1. Make a template and transfer it to the printer.
3. Transfer the bitmap file from Transfer Manager to the printer.
4. In the P-touch Template Settings tool, select the assigned number for the stored template.
5. With the P-touch Template commands, select the assigned number for the bitmap file.
Step 1: Make a template and transfer it to the printer.
Assigned number
Stored template
- 14 -
3. Examples for Using Commands
P-touch Template Command Reference
Step 2: Store the logo/external characters as a bitmap file, and drag & drop it to Transfer Manager.
Click [Transfer] button.
Step 3: Transfer the bitmap file from Transfer Manager to the printer.
Assigned number
Stored the logo/external character as a bitmap
- 15 -
3. Examples for Using Commands
P-touch Template Command Reference
^II
Entered command
In order to select the bitmap file, enter a specific character
” and the value one less than the assigned number for the
For example, if the assigned number for the bitmap file is 2,
Step 4: In the P-touch Template Settings tool, select the assigned number for the stored template.
(1) Select the P-touch Template mode (Fixed)
(2) Choose the assigned number
Step 5: With the P-touch Template commands, select the assigned number for the bitmap file.
After using the P-touch Template Settings tool in Step 4, the remaining three commands must be sent to
the printer.
(1) Initialize P-touch Template
(2) Select the bitmap file to be printed.
“\
bitmap file that is shown in Step 3.
Entered command
\01
enter \01 as shown right.
The command \01 is written in Hexadecimal : 5C 30 31
- 16 -
3. Examples for Using Commands
^FF
Entered command
(3) Start printing.
When the printer receives the command above, the label below is printed.
P-touch Template Command Reference
- 17 -
3. Examples for Using Commands
P-touch Template Command Reference
4. P-touch Template Limitations
4.1 Relating to text objects
4.1.1 Font, size, etc.
Please also refer to “5.2 Relationship between the P-touch Editor settings and the printer image」” on page 28 Fonts specified in P-touch Editor are converted to Helsinki, Letter Gothic or Brussels, depending on the font
shape, when the data is sent to the machine.
(The font is converted according to the following rules: fixed pitch: Letter Gothic; serif: Brussels; san serif:
Helsinki. Symbol fonts are converted to text objects if text input mode has been entered, and fonts are
divided into three categories, as described above. If the text input mode has been exited, they are
converted to image objects and the selected font is not converted.)
Character sizes specified in P-touch Editor are converted to the closest built-in character size when the
data is sent to the printer.
Character sizes specified in P-touch Editor are all made the same size within an object.
Depending on the language of the computer used for transferring, either the Western European or the
Eastern European character set is used for characters within text objects.
“\” is used as control character for an external character. When “\” has to be used as a data, input “\\”.
When “At Printing” check box is NOT checked, the time and date when editing P-touch Editor is applied
and printed. When “At Printing” check box is checked, if the TDU is connected, the time and date printed is
the same as TDU and if the TDU is not connected, time and date is not printed.
- 18 -
4. P-touch Template Limitations
P-touch Template Command Reference
“At Printing” setting
To cancel the “At Printing” setting for a date/time in P-touch Editor, display the properties for the Date and
Time object, and then clear the “At Printing” check box.
- 19 -
4. P-touch Template Limitations
P-touch Template Command Reference
4.1.2 Character alignment
Horizontal alignment settings (“Justify” or “Equal Length”) specified in P-touch Editor are changed to the
left alignment setting.
The setting for line feed with a line feed specified with the P-touch Editor can be set between 0 and 255
dots.
A negative line spacing setting cannot be used in P-touch Editor. In addition, since there is an upper limit
for the line width with the printer, a line spacing setting larger than this limit specified in P-touch Editor will
not be applied on the printer.
Specifying the line spacing setting in P-touch Editor
- 20 -
4. P-touch Template Limitations
P-touch Template Command Reference
The text object size is fixed, and the text size is changed depending on the text
length.
The text object size is fixed, and the text size is fixed. If the text is too long, the
text is not printed.
The text object width is fixed, and the text size is fixed. If the text is too long, the
text object height is increased.
The text object height is fixed, and the text size is fixed. If the text is too long,
the text object width is increased.
The text size is fixed. If the text is too long, the text object width is increased. If
a new line is started, the text height is increased.
4.1.3 Text Layout settings
Character styles specified in P-touch Editor all become the same style within an object.
If the “Long text” is selected under “Text Layout” in P-touch Editor, the text is always aligned at top left.
If the “Long Text” setting is selected under “Text Layout” in P-touch Editor and continuous length tape is
used, the print length is increased to fit the text.
If the “Fixed Frame Size (W rap)” setting is selected under “Text Layout” in P-touch Editor, the object size
does not change, and the text size is reduced.
“Fixed Frame Size (Wrap)” is a setting that was added for inserting long text. Since it is possible that the
text size may become extremely small if the wrapping feature is no longer applied, we recommend that
“Fixed Frame Size” be selected when die-cut labels or a fixed length is specified in P-touch Editor, or that
“Automatic Length” be selected when an automatic media length is specified.
Shrink to Fit
Clip Text
Long Text
Automatic Length
Free Size
Specifying a Text Layout setting
Click the button circled in red to display a drop-down list, and then select the desired option.
When trying to transfer a template containing a barcode that is not compatible with the printer, an error will
occur while transferring and the template cannot be transferred to the printer.
The following barcodes are compatible with the PT-P9XX.
1D barcodes
If data containing characters incompatible with the protocol are fed into the barcode object, that barcode
object is not printed.
The barcode size may differ from that in the print result with P-touch Editor.
Since CODE128 and GS1-128(UCC/EAN-128) can easily be printed slightly larger, we recommend
leaving larger margins when creating templates in P-touch Editor.
If data fed into a barcode in a template created with P-touch Editor causes an extremely long barcode, the
barcode may not be fully printed.
Do not insert line feed immediately before or immediately after the barcode data. Otherwise, it will be
considered as part of the barcode data. In that case, the barcode will be created containing the line feed
code, or the barcode will not be printed since data incompatible with the barcode protocol is entered.
A delimiter or print start text string should be entered immediately after the barcode data.
- 22 -
4. P-touch Template Limitations
P-touch Template Command Reference
1 to 50 characters (not including “*” on both sides)
skipped.
ITF
(I-2/5)
1 to 64 characters
The bearer bar setting specified in P-touch Editor is invalid.
EAN-8
7 characters
EAN-13
12 characters
UPC-A
11 characters
UPC-E
6 characters
CODABAR
3 to 64 characters (with “A”, “B”, “C” or “D” at the beginning and end)
CODE128
1 to 64 characters
GS1-128
(UCC/EAN-128)
RSS-14
3 to 15 characters (begins with “01”)
RSS Limited
3 to 15 characters (begins with “01”; third digit is “0” or “1”)
RSS Expanded
1 to 64 numbers or 1 to 40 letters*
POSTNET
5, 9 or 11 characters
4.2.2 1D barcodes
A barcode wider than 22.5 cm will not be printed.
A 1D barcode taller than 454 dots is converted to 454dots.
The number of characters that can be entered for each protocol is shown below.
CODE39
When feeding data, the asterisks (*) at the beginning and end of the data are
1 to 64 characters
* ISO646 characters can be printed.
<<numbers, letters, spaces, !, ”, %, &, ’, (, ), *, +, ,, -, ., /, :, ;, <, =, >, ? and _>>
When trying to transfer data exceeding the ranges described above, an error will occur while
transferring. If the data that is fed does not meet the minimum limit, the barcode is not printed. If the
data exceeds the maximum limit, only the data to the maximum limit is applied. However, if the data
exceeds 64 characters, the barcode is not printed.
- 23 -
4. P-touch Template Limitations
The version setting for a QR Code specified in P-touch Editor is invalid. The
The Structured Append settings specified in P-touch Editor are invalid.
Since the error correction levels for PDF417 specified in P-touch Editor are
n the printer, the size of the barcode may change when
The Structured Append settings specified in P-touch Editor are invalid.
The Structured Append settings specified in P-touch Editor are invalid.
Macro settings specified in P-touch Editor are invalid
The Structured Append settings specified in P-touch Editor are invalid.
number is entered at the beginning if the maximum number of characters is not
P-touch Editor: “200”; Printer: “002”
The Remove Character setting specified in P-touch Editor is invalid.
When the Number of Parts in the Set Structured Append setting is specified as
The Code Spacing and Join Vertically in the Set Structured Append settings
specified in P-touch Editor are invalid.
4.2.3 2D barcodes
P-touch Template Command Reference
QR Code
PDF417
Data Matrix
MaxiCode
AztecCode
version setting must be turned off.
inconsistent with those o
it is printed with P-touch Template.
The barcode is partitioned when too much data is entered.
When specifying the country code and service class with P-touch Editor, the
reached. However, with the printer, the number is entered at the end.
Example: “2” is specified.
Auto, the number of appended blocks becomes 2.
- 24 -
4. P-touch Template Limitations
Loading...
+ 90 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.