registered in many jurisdictions worldwide. All other trademarks are the property of their respective
owners.
Information in this document is subject to change without notice.
For further information regarding legal and proprietary statements, please go to:
COPYRIGHTS: http://www.zebra.com/copyright
WARRANTY: http://www.zebra.com/warranty
END USER LICENSE AGREEMENT: http://www.zebra.com/eula
SOFTWARE: http://www.zebra.com/linkoslegal
Terms of Use
Proprietary Statement
and its subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of parties
operating and maintaining the equipment described herein. Such proprietary information may not be used,
reproduced, or disclosed to any other parties for any other purpose without the express, written permission
of Zebra Technologies.
This manual contains proprietary information of Zebra Technologies Corporation
Product Improvements Continuous improvement of products is a policy of Zebra Technologies. All
specifications and designs are subject to change without notice.
Liability Disclaimer Zebra Technologies takes steps to ensure that its published Engineering
specifications and manuals are correct; however, errors do occur. Zebra Technologies reserves the right to
correct any such errors and disclaims liability resulting therefrom.
Limitation of Liability In no event shall Zebra Technologies or anyone else involved in the creation,
production, or delivery of the accompanying product (including hardware and software) be liable for any
damages whatsoever (including, without limitation, consequential damages including loss of business
profits, business interruption, or loss of business information) arising out of the use of, the results of use of,
or inability to use such product, even if Zebra Technologies has been advised of the possibility of such
damages. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential
damages, so the above limitation or exclusion may not apply to you.
The Virtual Device-T application enables Zebra Link-OS printers to work with many
host systems that are using TOSHIBA TEC
be required to the host application. This feature can help customers to make a smooth
transition to Zebra printers and save them the time and expense of having to rewrite
their host software.
Virtual Device-T Features
The Virtual Device-T application:
• Uses existing features of Zebra printers, when available.
• Offers fonts similar to the original device. These fonts will use 120 KB or more of
memory space.
• Supports the Bluetooth
• Offers many outline fonts, barcodes, and specific commands and features of
target printer models (see Supported Fonts and Barcodes on page 182).
• Provides support of TOSHIBA TEC commands (see Commands on page 36).
®
printers. In most cases, no changes will
®
, Serial, Ethernet, WLAN, and USB interfaces.
P1067299-003Virtual Device-T User Guide08/28/2018
Supported Printers
This manual describes the Virtual Device-T language for Zebra Link-OS printers and
should be used by any person who needs to support that language on one of the
following Zebra printers:
PrinterFirmware
iMZ SeriesV73.19.6Z and later
QLn SeriesV68.19.6Z and later
ZT200 SeriesV72.19.6Z and later
ZT400 SeriesV75.19.7Z and later
ZT510V80.20.02Z and later
ZT600 SeriesV80.20.02Z and later
ZD400 SeriesV77.19.14Z or V84.20.05Z and later
ZD500 SeriesV74.19.6Z and later
ZD600 SeriesV84.20.05Z and later
Introduction
Supported Printers
9
ZQ300 SeriesV81.20.06Z and later
ZQ500 SeriesV76.19.10Z and later
Note • The Virtual Device-T language is supported only on 203 dpi printers.
For complete printer operation, use this manual in combination with the User Guide
for your printer.
Configuring Network Connectivity
Your printer may be equipped with one or more of the following interfaces:
• Bluetooth—For detailed information to connect a Bluetooth device, refer to the
Bluetooth User Guide.
• Wired print server—For detailed information, refer to the ZebraNet Wired and Wireless Print Servers User Guide.
• Wireless print server—For detailed information, refer to the ZebraNet Wired and Wireless Print Servers User Guide.
For other connectivity options, refer to the User Guide for your printer. Copies of these
manuals are available at http://www.zebra.com/manuals.
08/28/2018Virtual Device-T User GuideP1067299-003
10
Introduction
Notes
Notes
• Other command languages are disabled when running Virtual Device-T. However,
Set/Get/Do (SGD) commands and file download all operate properly with
Virtual Device-T enabled.
• Virtual Device-T fonts can only be used with Virtual Device-T commands. They
cannot be used with other languages.
• The Virtual Device-T mode application will not respond to CPCL, ZPL, or EPL
commands. Instead, commands will be processed by the Virtual Device-T
application.
P1067299-003Virtual Device-T User Guide08/28/2018
Install, Register, and
Enable Virtual Device-T
This section provides you with instructions on how to install and enable the
Virtual Device-T application on one or more Zebra printers.
To get the Virtual Device app, perform the following from your computer:
1. Open a web browser and navigate to http://www.zebra.com/virtualdevices.
2. Locate your printer type in the list of printers, and then click Download Now.
3. Fill out the information on the Virtual Device Download Request form.
4. Click Submit.
5. Read the End User License Agreement.
6. Click Accept and Begin Download Now.
Your browser prompts you to open or save the archive containing the Virtual
Device app.
7. Save and store the Virtual Device app archive file to your computer.
The archive file contains the following:
•The Virtual Device .NRD file to be downloaded to a Zebra printer.
•A .txt file that contains the SGD command for immediately activating the
Virtual Device app.
8. Extract the files from the archive to your computer.
P1067299-003Virtual Device-T User Guide08/28/2018
Downloading the Virtual Device-T Application
Downloading the Virtual Device-T Application
Zebra provides two options to download the Virtual Device-T app to the printer.
• On a computer with the ZDownloader Utility
The ZDownloader Utility is the only method shown in this manual. For instructions
on how to download and install the ZDownloader Utility, see ZDownloader Utility
on page 252.
• On an Android device with the Zebra Printer Setup Utility for Android Devices
(available for free on Google Play™)
For information on using the Zebra Printer Setup Utility for Android Devices and to
download the user guide, navigate to http://www.zebra.com/setup.
Using ZDownloader
The ZDownloader application can update Virtual Device-T files in Zebra printers
connected by Serial, Parallel, USB, and IP Ethernet networks.
Getting Started
13
Figure 1 • Initial ZDownloader Screen
Adding Printers to the ZDownloader List
There are two ways to add printers to the list:
• Auto-Detect (use for USB or IP Ethernet interfaces)
• Manual add (use for Serial, Parallel, or IP Ethernet interfaces)
If your printer is connecting via the serial or parallel interfaces, or is not detected by
using the Auto-Detect method, use the Manual Add method.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
14
Downloading the Virtual Device-T Application
Auto-Detect Printers
Use Auto-Detect for USB or IP Ethernet interfaces.
Note • Ethernet connected printers are detected by the application broadcasting a
UDP packet out onto the network. UDP port number 4201 is used for the
discovery process. Some networks filter out UDP packets. This means that the
ZDownloader utility may not be able to detect all of the printers on your network.
See your network administrator for more information. If you are not able to AutoDetect your network printers, follow instructions for manually adding a printer.
USB printers can only be added by using Auto-Detect. The ZDownloader utility can
support as many USB printers as your computer can support (most computers
typically can support up to 255).
P1067299-003Virtual Device-T User Guide08/28/2018
Getting Started
Downloading the Virtual Device-T Application
To Auto-Detect printers connected via the USB or IP Ethernet interfaces,
perform the following steps:
1. In the ZDownloader toolbar, select Printer > Auto-Detect.
OR
Right-click in the ZDownloader window and select Auto-Detect Printers.
The printers detected are added to the printer list.
15
Manually Add Printers
To manually add printers connected via the Serial, Parallel, or Network
interfaces, perform the following steps:
1. In the ZDownloader toolbar, select Printer > Add….
OR
Right-click in the ZDownloader window and select Add Printer….
The following window appears.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
16
Downloading the Virtual Device-T Application
2. Add a printer name and your printer model in the appropriate fields.
3. What type of printer are you adding?
If you are adding a…Then…
Serial PrinterGo to Adding a Serial Printer.
Parallel PrinterGo to Adding a Parallel Printer on page 18.
Network PrinterGo to Adding a Network Printer on page 19.
Adding a Serial Printer
4. Select the serial port to which the printer is connected.
P1067299-003Virtual Device-T User Guide08/28/2018
5. Click Port Settings.
The following window appears.
Getting Started
Downloading the Virtual Device-T Application
17
6. Adjust the settings as necessary. The printer’s serial port settings must match the
computer’s serial port settings. For more information about the settings, refer to
the User Guide for your printer.
7. Click OK to save the port settings.
8. Click OK to add the printer.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
18
Downloading the Virtual Device-T Application
Adding a Parallel Printer
9. Set Communication Type to Parallel.
The available parallel ports will be shown in the Port drop-down box.
10. Select the port to which the printer is connected. No additional configuration is
necessary.
11. Click OK to add the printer.
P1067299-003Virtual Device-T User Guide08/28/2018
Adding a Network Printer
12. Set Communication Type to Network.
The following window appears.
Getting Started
Downloading the Virtual Device-T Application
19
13. Enter the printer’s IP address.
14. Click OK to save the network settings.
15. Click OK to add the printer.
Modifying Printers in the List
To change printer settings for a printer in the list, perform the following steps:
1. Select the printer to modify.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
20
Downloading the Virtual Device-T Application
2. In the toolbar, select Printer > Modify Printer….
OR
Right-click on the printer and select Modify Printer….
The printer settings for the selected printer are displayed.
3. Modify the settings as desired.
4. Click OK to save the settings.
Deleting Printers from the List
To delete printers from the list, perform the following steps:
1. Select one or more printers to delete.
P1067299-003Virtual Device-T User Guide08/28/2018
Downloading the Virtual Device-T Application
2. In the toolbar, select Printer > Delete.
OR
Right-click on one of the selected printers and select Delete Printer(s).
The printer is removed from the list.
Getting Started
21
Downloading the Virtual Device App to Selected Printers
To download the Virtual Device-T app to your printer(s), you must select the file to
send to each printer. ZDownloader, by default, downloads files to one printer at a time.
If you have multiple printers to update and want to speed up the process, you can
increase the number of simultaneous downloads.
Note • More simultaneous downloads require more of your computer resources.
Some computers may slow down with simultaneous downloads or as more printers
are added for simultaneous downloading.
To allow simultaneous downloads, perform the following step:
1. Click Tools > Options….
The following prompt appears.
2. Raise the number shown to allow multiple simultaneous downloads.
3. Click OK.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
22
Downloading the Virtual Device-T Application
To download the Virtual Device app file to one or more printers, perform the
following steps:
1. Select the printers to which you want to download the Virtual Device-T app file. To
select multiple printers, hold down the Ctrl or Shift key, and then click on the
desired printers.
2. In the toolbar, select File > Select Firmware File….
OR
Right-click on one of the selected printers and select Select Firmware File….
3. Navigate to the Virtual Device app file that you acquired previously.
4. Click Open.
The file that you selected appears under Download File for the selected printers.
Printers that are present in the list but that do not have a file selected will be
ignored when Downloading starts.
P1067299-003Virtual Device-T User Guide08/28/2018
Getting Started
Downloading the Virtual Device-T Application
5. Start the download process by doing one of the following:
•Select Printer > Download to Selected.
•Select the printer(s) of interest and select the Printer and then select
Download To Selected.
6. In the toolbar, select Printer > Download All.
OR
Right-click in the ZDownloader window and select Download All.
After downloading has begun, the progress of each printer will be shown in the
Download Status column.
23
Canceling a Download in Progress
The Cancel Download toolbar button and the Printer > Cancel Download menu
options become active when the files are downloading.
To cancel downloading to ALL printers in the list, perform the following step:
1. Click Printer > Cancel Download.
OR
Right-click in the ZDownloader window and select Cancel Download.
To cancel downloading to SPECIFIC printers in the list, perform the following step:
1. Select one or more printers with a download in progress.
2. Click Printer > Cancel Download.
OR
Right-click on a selected printer and select Cancel Download.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
24
Registering the Virtual Device
Registering the Virtual Device
ZDownloader maintains a log file of all items downloaded to a Zebra printer along with
the printer serial number. You can register your Virtual Device installation with Zebra
Repair and Tech Support to ensure that a printer sent in for repair is returned with the
Virtual Device installed, and when engaging Zebra Tech Support, they will have
records of the item being loaded. To register your Virtual Device installation, you must
send the log file created by ZDownloader to the Zebra log file management group.
ZDownloader Log File
To send the log file, complete these steps:
1. Based on your operating system, navigate to the appropriate folder:
•Microsoft® Windows® XP
C:\Program Files\Common Files\FirmwareDownloader
•Microsoft Windows 7, Windows 8, and Windows 10
C:\ProgramData\Zebra Technologies\Firmware Downloader and
ZBI Key Manager
2. Copy the log file (DownloadLog.txt), and email to Zdownloader@zebra.com.
If you are downloading from several computers, you need to send the log file from
each computer. If you download files to printers on one day and do not send the
file the same day, please note this in your email so that the log file management
group picks up the previous load detail. Otherwise, they only pick up the load data
for the day that the log file is sent.
P1067299-003Virtual Device-T User Guide08/28/2018
Enabling the Virtual Device
You can enable Virtual Device-T by sending a Set/Get/Do (SGD) command to the
printer or by selecting the option through the printer’s menus.
Using an SGD Command
To enable Virtual Device-T on your printer, send the following command:
! U1 setvar "apl.enable" "apl-t"
To disable Virtual Devices on your printer and return to normal function, send the
following command:
! U1 setvar "apl.enable" "none"
You must restart the printer after changing the value of apl.enable. For more
information about this SGD command, see apl.enable on page 180.
Getting Started
Enabling the Virtual Device
25
Using the User Menus
This section includes instructions for the following printers:
• QLn420 Printers on page 26
• QLn320 and QLn220 Printers on page 29
• Supported ZTxxx and ZDxxx Printers with a Display on page 32
If necessary, refer to the User Guide for your printer for additional information about
your printer’s control panel.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
PRINTER READY
VXXXXXXX
SETTINGS
LANGUAGE
26
Enabling the Virtual Device
QLn420 Printers
1. From the printer’s idle display screen, press the LEFT SOFT KEY to select the
Home icon.
The printer displays the Home Menu.
2. Use the ARROWS to navigate to the LANGUAGE menu.
P1067299-003Virtual Device-T User Guide08/28/2018
3. Press OK.
LANGUAGE
▼ENGLISH▲
VIRTUAL DEVICE
▼NONE▲
The printer displays the LANGUAGE selection screen.
Getting Started
Enabling the Virtual Device
27
4. Use the LEFT or RIGHT ARROW to navigate to the VIRTUAL DEVICE selection
screen.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
VIRTUAL DEVICE
▼APL-T▲
USE
28
Enabling the Virtual Device
5. Use the UP or DOWN ARROW to scroll to the APL-T option.
6. Press the RIGHT SOFT KEY to select USE.
The printer restarts and uses the Virtual Device that you selected.
P1067299-003Virtual Device-T User Guide08/28/2018
QLn320 and QLn220 Printers
Zebra QLn320
FW ver:XXXXXXXXXX
Baud Rate:115200
Batteryok
IP Addr:10.14.205.138
Menu
CommunicationBack
SettingsBack
1. From the printer’s idle display screen, press the LEFT SOFT KEY to select the
Home icon.
Getting Started
Enabling the Virtual Device
29
The printer displays the Home Menu.
2. Use the ARROWS to navigate to the SETTINGS menu.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
Virtual Dev: none ▲▼
MenuUseBack
Virtual Dev: apl‐t ▲? ▼
MenuUseBack
30
Enabling the Virtual Device
3. Press OK.
The printer displays the VIRTUAL DEVICE selection screen.
4. Press the RIGHT ARROW to highlight the up arrow on the display.
5. With the up arrow highlighted, press the OK button until you scroll to the APL-T
option.
P1067299-003Virtual Device-T User Guide08/28/2018
6. Press the LEFT ARROW to highlight APL-T
7. Press OK to select USE.
The printer restarts and uses the Virtual Device that you selected.
Getting Started
Enabling the Virtual Device
31
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
PRINTER READY
VXXXXXXX
HOME MENU
SETTINGS
32
Enabling the Virtual Device
Supported ZTxxx and ZDxxx Printers with a Display
Note • The ZT230 control panel is shown in this procedure. The control panel for the
other printers is similar.
1. From the printer’s idle display screen, press the LEFT SELECT KEY to select the
Home icon.
The printer displays the Home Menu.
P1067299-003Virtual Device-T User Guide08/28/2018
2. Use the ARROWS to navigate to the LANGUAGE menu.
HOME MENU
SETTINGS
▼
LANGUAGE
ENGLISH
▲
Getting Started
Enabling the Virtual Device
33
3. Press OK.
The printer displays the LANGUAGE selection screen.
08/28/2018Virtual Device-T User GuideP1067299-003
Getting Started
▼
VIRTUAL DEVICE
NONE
▲
▼
VIRTUAL DEVICE
APL-T
▲
USE
34
Enabling the Virtual Device
4. Use the LEFT or RIGHT ARROW to navigate to the VIRTUAL DEVICE selection
screen.
5. Use the UP or DOWN ARROW to scroll to the APL-T option.
P1067299-003Virtual Device-T User Guide08/28/2018
6. Press the RIGHT SOFT KEY or OK to select USE.
▼
VIRTUAL DEVICE
APL-T
▲
USE
Getting Started
Enabling the Virtual Device
35
The printer restarts and uses the Virtual Device that you selected.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
This section provides a detailed listing of commands for use on your Zebra printer
with the Virtual Device-T app.
The commands are sent to the printer in the following format:
ESCCommand and DataLFNUL
Alternately, the following syntax may be used:
{Command and Data|}
The command length from [ESC] to [LF] [NUL} must conform to what is specified for
each command.
The two following kinds of control codes exist:
ESC (1BH), LF (0AH), NUL (00H)
{ (7BH), | (7CH), } (7DH)
Commands
Interface Command Format
37
Command Format
The commands in this section are presented in the following format.
Command
Description Command Function
Syntax
(example below for EOT). Variable values are denoted by n and other letters.
Range The values that can be used for n or other variables (if any).
Default Initial value of n (if any).
Notes In-depth description of the command function.
Command format in ASCII followed by Hexadecimal and decimal equivalents
EOTn
ASCII
Hex
Decimal
EOTn
04n
4n
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
38
TPCL Mode Supported Commands
TPCL Mode Supported Commands
CommandFunction
Setting Commands
[ESC] D on page 41Set Label Size
[ESC] ID on page 44Set the Printer ID
[ESC] M on page 45Select the Print Mode
Fine Adjustment Commands
[ESC] AX on page 46Fine Adjust the Print Start Position
[ESC] AY on page 48Fine Adjust Print Density That Was Set Automatically
[ESC] AH on page 49Adjust the Strip Sensor
Clear Commands
[ESC] C on page 50Clear the Image Buffer
[ESC] XR on page 51Clear or Reverse a Specified Area
Drawing Format Commands
[ESC] LC on page 53Draw a Line or Rectangle
[ESC] PC on page 58Specify a Bitmap Font Format
[ESC] PV on page 71Specify an Outline Font Format
[ESC] XBSpecify a Barcode or Two-Dimensional Code Format
[ESC] XB on page 82WPC, CODE93, CODE128, UCC/EAN128, EAN128, POSTNET
[ESC] XB on page 92MSI, Interleaved 2 of 5, CODE39, NW7, Industrial 2 of 5
[ESC] XB on page 101GS1 Databar
[ESC] XB on page 108Two-Dimensional Code Format (Data Matrix)
[ESC] XB on page 117Two-Dimensional Code Format (PDF417)
[ESC] XB on page 123Two-Dimensional Code Format (MicroPDF417)
[ESC] XB on page 129Two-Dimensional Code Format (QR Code)
[ESC] XB on page 135Two-Dimensional Code Format (MaxiCode)
Print Data Commands
[ESC] RC on page 140Specify Bitmap Font Data
[ESC] RV on page 143Specify Outline Font Data
[ESC] RBSpecify Data for a Barcode or Two-Dimensional Code
[ESC] RB on page 146Barcode/Two-Dimensional Code Data (any codes other than
MaxiCode)
[ESC] RB on page 154Two-Dimensional Code Data (MaxiCode)
P1067299-003Virtual Device-T User Guide08/28/2018
CommandFunction
Issue and Feed Commands
[ESC] XFStorage Area Allocation.
Consumed but not processed.
[ESC] XS on page 155Issue Labels
[ESC] T on page 157Feed Media
Commands
TPCL Mode Supported Commands
39
[ESC] U1 or [ESC] U2
on page 158
Forward/Reverse Feed
Support for these commands was added after the initial release. To
use the commands, download the latest version of the Virtual
Device-T app.
Format Commands
[ESC] J1 on page 159Format Flash Memory
Writable Character Commands
[ESC] XE2-Byte Writable Character Code Range.
Consumed but not processed.
[ESC] XD on page 160Store Bitmap Writable Character
Graphics Commands
[ESC] SG on page 164Draw Graphic
PC Command Saving Commands
[ESC] XO on page 171Start Save Operation
[ESC] XP on page 173Terminate Save Operation
[ESC] XQ on page 173Read Saved Data
Check Commands
[ESC] HDCheck Printhead for Broken Dots.
Consumed but not processed.
[ESC] XJDisplay Message on LCD.
Consumed but not processed.
[ESC] WR on page 174Reset the Printer
[ESC] Z0 (zero) on page 174 Reset Device
Status Commands
[ESC] WS, [ESC] FM, [ESC]
Request Printer Status
v on page 175
[ESC] WB on page 176Request Printer Status and Free Buffer Space
[ESC] WX on page 176Acquire Mode Information
[ESC] WV on page 177Acquire Version Information
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
40
TPCL Mode Supported Commands
CommandFunction
Bluetooth and Wireless LAN Commands
[ESC] IT on page 179Acquire the Device Address
[ESC] WTAcquire Bluetooth Parameters.
Consumed but not processed.
P1067299-003Virtual Device-T User Guide08/28/2018
Setting Commands
[ESC] D
Description Set Label Size
Commands
Setting Commands
41
Syntax
Range
a = length (pitch) of the label or tag from 10.0 to 999.9 mm (0.39 to 39.37 in.) in 0.1 mm
b = print width in 0.1 mm (0.0039 in.) increments. Must be four digits.
c = print length from 7.0 to 997.0 mm (0.28 to 39.25 in.) in 0.1 mm (0.0039 in.) increments.
d = optional reserved area. Must be four digits.
Notes This command specifies the length (pitch) of a label or tag, including backing.
The values set with this command are retained even if the printer is power cycled.
If the value specified for parameter a, b, or c is greater than the printer can support,
the maximum value is used. If a value is smaller than the printer can support, the
minimum value is used. Refer to the User Guide for your printer for the exact print
specifications for your printer. The value for the optional reserved area is not
checked. Values outside of the supported area may be ignored, or an error may occur.
[ESC] Da, b, c(, d) [LF] [NUL]
(0.0039 in.) increments. Must be four or five digits.
4 digits = 0100 to 9999
5 digits = 00100 to 09999
Must be four or five digits.
4 digits = 0070 to 9970
5 digits = 00070 to 09970
0300 to 1120
If you change the size of the labels that you are using or the label sensor type, you
must first transmit this command. After that, feed one label by [ESC] T on page 157
to position the label properly prior to printing. After transmitting this command, you
must clear the image buffer using [ESC] C on page 50.
The origin of drawing coordinates and the print stop position (printhead position when
printing stops) are adjustable by the Fine Adjustment Commands
If you change the print position or if the gap between labels is not 3 mm, use [ESC]
AX on page 46 as required.
08/28/2018Virtual Device-T User GuideP1067299-003
on page 46.
Commands
42
Setting Commands
Top-First Printing
Bottom-First Printing
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Setting Commands
Example 1 • Label with 51.8 mm pitch, 46.8 mm print length, and 76 mm print width
[ESC] D0518, 0760, 0468, 0820 [LF] [NUL]
[ESC] T20C40 [LF] [NUL]
43
Example 2 •
[ESC] D0772, 0996, 0722 [LF] [NUL]
[ESC] T10C40 [LF] [NUL]
Tag with 77.2 mm pitch, 72.2 mm print length, and 99.6 mm print width
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
44
Setting Commands
[ESC] ID
Description Set the Printer ID
[ESC] ID ; a(,b) [LF] [NUL]
Syntax
Range
a = a 5-digit printer ID value (2-byte hex data)
b = reserved (can be omitted; any value other than 0 causes an error)
Notes This command sets the ID for the printer, which is used by the host to identify
each printer. The printer ID is retained even if [ESC] WR on page 174 is executed or
if the printer is power cycled.
Example • To set 03H 51H as the ID of the printer, send
0000H to FFFFH
Fixed at 0
[ESC] ID; [03H] [51H] [LF] [NUL]
In this example, the printer ID would be 00849.
P1067299-003Virtual Device-T User Guide08/28/2018
[ESC] M
Description Select the Print Mode
Commands
Setting Commands
45
Syntax
[ESC] M; a (,b) [LF] [NUL]
Range
a = print mode designation
HEXASCII
Print Mode
How received data is dealt with after
an error is cleared
Notes This command specifies the print mode. The value set with this command is
retained even if the printer is power cycled.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
46
Fine Adjustment Commands
Fine Adjustment Commands
[ESC] AX
Description Fine Adjust the Print Start Position
Syntax
Range
a = whether the direction of the print position should be adjusted forward or backward.
b = value by which to change the print position (in 0.1 mm units)
c = whether the direction of the strip position should be adjusted forward or backward.
d = value by which to change the strip position (in 0.1 mm units)
e = Reserved. (Can be omitted.)
f = Reserved. (Can be omitted.)
g = Reserved. (Can be omitted.)
h = Reserved. (Can be omitted.)
h = Reserved. (Can be omitted.)
Notes This command adjusts the feed value so that the label shifts forward or
backward from the automatically set print start position. The values set with this
command are retained even if the printer is power cycled. The factory default value is
0.0 mm.
[ESC] AX; ab, cd(, ef, gh) [LF] [NUL]
+ = Backward
– = Forward
000 to 500 (0 to ±50 mm)
+ = Backward
– = Forward
000 to +030 (0 to 3.0 mm)
000 to –020 (0 to –2.0 mm)
The fine adjustment values changed by this command in LABEL mode, are also
effective in TPCL mode.
A command error occurs in the following instances:
• When parameter a or c is set to anything other than + or -
• When any out-of-range value is specified for parameter b or d.
When the label pitch is 20.0 to 24.0 mm and the print length is 15.0 mm or more or
when the label pitch is 24.0 mm or more, the printer backfeeds before printing.
P1067299-003Virtual Device-T User Guide08/28/2018
Example 1 • Print position fine adjustment
Commands
Fine Adjustment Commands
47
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
48
Fine Adjustment Commands
[ESC] AY
Description Fine Adjust Print Density That Was Set Automatically
[ESC] AY ; ab, c (, d) [LF] [NUL]
Syntax
Range
a = makes the print density higher or lower, resulting in darker or lighter print
+ = Increase the density (darker print)
– = Decrease the density (lighter print)
b = value by which to change the print density
00 to 30
c = print mode
0 = Reserved
1 = direct thermal
d =Reserved
2-inch printhead width
0 = Auto (divided by 2 or 3)
1 = Reserved (if specified, Auto (divided by 2 or 3))
2 = Fixed at divided by 3
3 = Auto1 (not divided/divided by 2 or 3)
4 = Reserved (if specified, fixed at divided by 3)
5 = Auto2 (not divided/divided by 2 or 3)
Default = 3
The Auto1 selection is print-quality oriented, while Auto2 is print-speed oriented.
Auto2 uses a higher print speed and may result in lighter print.
4-inch printhead width
0 = Auto (divided by 2, 3, or 6)
1 = Reserved (if specified, Auto (divided by 2, 3, or 6))
2 = Reserved (if specified, Auto (divided by 2, 3, or 6))
3 = Auto1 (not divided/divided by 2, 3, or 6)
4 = Fixed at divided by 6
Default = 3
Notes This command adjusts print density that was set automatically. The values set
with this command are retained even if the printer is power cycled. A command error
occurs when any out-of-range fine adjustment value is specified.
The fine adjustment values changed by this command in TPCL mode, are also
effective in LABEL, RECEIPT, and ESC/POS modes.
Example 1 • Send the following to set the density to –2:
[ESC] AY; -02, 1 [LF] [NUL]
Example 2 • Send the following to set the density to +3:
[ESC] AY; +03, 1 [LF] [NUL]
P1067299-003Virtual Device-T User Guide08/28/2018
[ESC] AH
Description Adjust the Strip Sensor
Syntax
Range
a = one of the following settings
Notes This command sets the sensor threshold value that switches between strip
and batch modes. The values set by this command are stored and used when the
printer is powered up.
Fine Adjustment Commands
[ESC] AH; a [LF] [NUL]
0 = operation in conformance with the strip sensor
1 = operation in conformance with the strip sensor
2 = batch mode only
3 = strip mode only
4 = Reserved (The command is ignored if this is specified.)
Default = 0
Commands
49
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
50
Clear Commands
Clear Commands
[ESC] C
Description Clear the Image Buffer
Syntax
Notes This command clears the image buffer of drawing characters, lines, barcodes,
and graphics. Use this command after you change the label size using [ESC] D
on page 41.
When this command is transmitted, the increment/decrement designation and the link
field designations are reset.
Example • This example shows how [ESC] C is used after changing the label size.
a = the X coordinate of the start point of the area to be cleared. Must be four digits. Specified
b = the Y coordinate of the start point of the area to be cleared. Must be four or five digits.
c = the X coordinate of the end point of the area to be cleared. Must be four digits. Specified
d = the Y coordinate of the end point of the area to be cleared. Must be four or five digits.
e = how to clear the specified area (If a value other than A or B is specified, an error occurs.)
in 0.1 mm (0.0039 in.) increments.
0100 to 1057
Fixed at 4 digits (in 0.1 mm units)
Specified in 0.1 mm (0.0039 in.) increments.
4 digits = 0100 to 9999
5 digits = 00100 to 09999
in 0.1 mm (0.0039 in.) increments.
0100 to 1057
Specified in 0.1 mm (0.0039 in.) increments.
4 digits = 0100 to 9999
5 digits = 00100 to 09999
A = clear the contents in the designated area
B = reverse black/white in the designated area.
51
Notes This command clears a designated area or reverses black/white printing in the
designated area in the drawing area. The start and end point coordinates specified
must be set within the print area set by the [ESC] D on page 41. The results of this
command are the same when the start and end point coordinates are reversed.
Example • This example shows how to clear a specified area.
[ESC] XR; 0345, 0100, 0762, 0585, A [LF] [NUL]
[ESC] XS; I, 0001, 0002C4000 [LF] [NUL]
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
52
Clear Commands
P1067299-003Virtual Device-T User Guide08/28/2018
Drawing Format Commands
[ESC] LC
Description Draw a Line or Rectangle
Commands
Drawing Format Commands
53
Syntax
Range
a = the X coordinate of the start point. Must be four digits. Specified in 0.1 mm (0.0039 in.)
b = the Y coordinate of the start point. Must be four or five digits. Specified in 0.1 mm
c = the X coordinate of the end point. Must be four digits. Specified in 0.1 mm (0.0039 in.)
d = the Y coordinate of the end point. Must be four or five digits. Specified in 0.1 mm
e = type of line or rectangle to draw (A command error occurs if the specified value is
f = thickness of the line to be drawn. Specified in 0.1 mm (0.0039 in.) increments. A
g = radius of rounded corners of a rectangle (Can be omitted. If omitted, the rectangle
[ESC] LC; a, b, c, d, e, f (, g) [LF] [NUL]
increments.
0100 to 1057
Fixed at 4 digits (in 0.1 mm units)
(0.0039 in.) increments.
4 digits = 0100 to 9999
5 digits = 00100 to 09999
increments.
0100 to 1057
(0.0039 in.) increments.
4 digits = 0100 to 9999
5 digits = 00100 to 09999
anything other than 0 to 6.)
0 = line (horizontal, vertical)
1 = rectangle
2 = Reserved (If specified, processed as 0.)
3 = Reserved (If specified, processed as 1.)
4 = Reserved (If specified, processed as 1.)
5 = Reserved (If specified, processed as 0.)
6 = Reserved (If specified, processed as 1.)
command error occurs if this is set to zero.
1 to 9 or 01 to 99
corners are drawn square, not rounded.) Must be three digits. Specified in 0.1 mm
(0.0039 in.) increments. This parameter is ignored unless parameter e is set to 1 or 3.
000 to 999
Notes This command specifies the parameters for drawing a line or rectangle. The
start and end point coordinates specified must be set within the print area set by the
[ESC] D on page 41. The results of this command are the same when the start and
end point coordinates are reversed.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
54
Drawing Format Commands
Example 1 • This example shows the different results based on whether the top or
bottom of the label is printed first.
Example 2 • A horizontal line is drawn when |Y
Example 3 • A vertical line is drawn when |X
2
- Y1| = 0.
2
- X1| = 0.
Example 4 • A slanted line is drawn when |X2 - X1| < |Y2 - Y1|.
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 5 • A slanted line at a different angle results when |X2 - X1| > |Y2 - Y1|.
55
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
| X
2
– X
1
|
2
| Y
2
– Y
1
|
2
=
?
the radius of the rounded corners
56
Drawing Format Commands
Example 6 • A rectangle with square corners is drawn when the corner radius is
specified as 000 or by default when a corner radius is not specified.
Example 7 • A rectangle with rounded corners is drawn when a corner radius other
than 000 is specified.
To draw a circle, use coordinates that meet the following criteria:
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 8 • This example shows how to draw a horizontal line and a vertical line that
start at the same point.
[ESC] C [LF] [NUL]
[ESC] LC; 0200, 0050, 0305, 0050, 0, 4 [LF] [NUL]
[ESC] LC; 0200, 0050, 0200, 0280, 0, 4 [LF] [NUL]
[ESC] XS; I, 0001, 0002C4000 [LF] [NUL]
57
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
58
Drawing Format Commands
[ESC] PC
Description Specify a Bitmap Font Format
Syntax
This command has two possible formats:
[ESC] PCa; b, c, d, e, f (, gh), i, j (, Jkl) (, Mm) (, no)
(, Zp) (, Pq) (= r ‐‐‐‐‐‐ r) [LF] [NUL]
[ESC] PC
(, Z
a; b, c, d, e, f (, gh), i, j (, Jkl) (, Mm) (, no)
p) (, Pq) (; s1, s2, s3, ------ , s20) [LF] [NUL]
Range
a = character string number. Can be two or three digits.
000 to 199 or 00 to 99
b = the X coordinate of the print origin of the character string. Must be four digits. Specified
in 0.1 mm (0.0039 in.) increments.
0100 to 1057
c = the Y coordinate of the print origin of the character string. Must be four or five digits.
Specified in 0.1 mm (0.0039 in.) increments.
4 digits = 0100 to 9999
5 digits = 00100 to 09999
d = the character horizontal magnification factor
1 digit indicates the number of times to magnify = 1 to 9
2 digits indicate that the magnification is in fractional increments =
05 to 95 (0.5 to 9.5 in 0.5 unit increments)
06 to 09 (0.6 to 0.9 in 0.1 unit increments)
e = the character vertical magnification factor
1 digit indicates the number of times to magnify = 1 to 9
2 digits indicate that the magnification is in fractional increments =
05 to 95 (0.5 to 9.5 in 0.5 unit increments)
06 to 09 (0.6 to 0.9 in 0.1 unit increments)
f = the type of bitmap font (See Table 5, Supported Bitmap Fonts on page 183 for
examples.)
FontDescription
Times Roman (Medium)* 12 points
A
Times Roman (Medium)* 15 points
B
Times Roman (Bold)*15 points
C
Times Roman (Bold)*18 points
D
Times Roman (Bold)*21 points
E
Times Roman (Italic)*18 points
F
Helvetica (Medium)*9 points
G
Helvetica (Medium)*15 points
H
Helvetica (Medium)*18 points
I
Helvetica (Bold)*18 points
J
Helvetica (Bold)*21 points
K
* Indicates proportional fonts
P1067299-003Virtual Device-T User Guide08/28/2018
Size
(203-dpi printhead)
FontDescription
Helvetica (Italic)18 points*
L
Presentation (Bold) 27 points
M
Letter Gothic (Medium) 14.3 points
N
Prestige Elite (Medium) 10.5 points
O
Prestige Elite (Bold) 15 points
P
Courier (Medium) 15 points
Q
Courier (Bold) 18 points
R
OCR-A 12 points
S
OCR-B 12 points
T
Gothic725 Black * 6 points
q
Size
(203-dpi printhead)
Commands
Drawing Format Commands
gh = fine adjustment of character-to-character space (Can be omitted, in which case space is
adjusted according to the designated font.)
g = increases or decreases the character-to-character space.
+ = Increase the space
– = Decrease the space
h = number of dots between characters. Must be two digits.
00 to 99 dots
i = rotational angle of a single character and character strings
59
Single
Character
Character String
000°0°
1190°90°
22180°180°
33270°270°
j = character attributes
B = black characters
W (xy) = reverse characters* **
x = number of dots horizontally from the character string to the end of the black
background. Must be two digits.
01 to 99
y = number of dots vertically from the character string to the end of the black
background. Must be two digits.
01 to 99
F (xy) = boxed characters* ***
x = number of dots horizontally from the character string to the surrounding box.
Must be two digits.
01 to 99
y = number of dots vertically from the character string to the surrounding box.
Must be two digits.
01 to 99
C (x) = strike-through characters* ***
x = number of dots horizontally from the character string to the end of the strike-
through line. Must be two digits.
01 to 99
* Specifications in parentheses can be omitted, in which case the value used
is the character magnification (horizontal or vertical, whichever is larger) x 6
dots.
Jkl = bold character shift* (may be omitted, in which case characters are not shifted)
k = distance in dots to shift horizontally. Must be two digits.
00 to 16
l = distance in dots to shift vertically. Must be two digits.
00 to 16
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
60
Drawing Format Commands
Mm = attach the specified check digit* (Can be omitted, in which case no check digit is drawn.
If any data other than numerals are included for the fonts listed below, no drawing is
performed.)
m = the type of check digit*
0 = Modulus 10 (draws data and check digit)—Data must include only numerals.
1 = Modulus 43 (draws data and check digit)—Data must include only CODE39.
2 = DBP Modulus 10** (draws only the check digit)—Data must include only
numerals.
* The check digit cannot be specified if the font type is U, V, r, s, or w. If a
value is specified, the printer ignores it.
** DBP Modulus 10 is Modulus 10 for Deutsche Bundespost Postdienst only.
no = increment and decrement* (Can be omitted, in which case no increment/decrement is
performed.)
n = specifies whether to increment or decrement
+ = Increment
– = Decrement
o = skip value. Must be ten digits.
0000000000 to 9999999999
* Increment/decrement cannot be specified if the font type is U, V, r, s, w, or a
(for JA type only). If a value is specified, the printer ignores it.
Zp = zero suppression* (Can be omitted, in which case zero suppression is not performed.)
p = number of digits after zero suppression. Must be two digits.
00 to 20
Pq = alignment* (Can be omitted, in which case left alignment is used.)
q = specifies the character position.
1 = left
2 = center
3 = right
4a = justified
a = character string in the X direction (in 0.1 mm units)
0050 to 1040
5abc = automatic line feed
Note: Lines may not be divided exactly the same as they are with
®
TOSHIBA TEC
printers.
a = character string in the X direction (in 0.1 mm units)
0050 to 1040
b = line feed spacing (in 0.1 mm units)
010 to 500
c = number of lines
01 to 99
* When the rotational angle of a character or character string is set to 01, 12,
23, or 30, the printer ignores alignment and automatic line feed input.
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
r = a data string to be printed (Can be omitted.)
255 digits maximum
s1, s2, s3, ..., s20 = up to 20 link field numbers, separated by commas (Can be omitted.)
01 to 99 or 1 to 99
Notes This command specifies where and how a bitmap font is to be printed on a
label. When drawing using the Data Command ([ESC] RC on page 140), the format
specified by the character string number is used.
The Bitmap Font Format Command ( [ESC] PC on page 58) may be connected
to the Outline Font Format Command ([ESC] PV on page 71) when transmitted. For
example:
[ESC] PC001; 0100, 0150, 1, 1, A, 00, B [LF]
C002; 0350, 0180, 1, 1, A, 00, B [LF]
C005; 0200, 0300, 25, 2, C, +05, 00, B,
+0000000001 [LF]
V01; 0500, 0400, 0100, 0100, A, 00, B [LF] [NUL]
When the drawing data is different between labels, the drawing data field for the
previous label is cleared automatically using the character string number, and then
the next drawing data field is printed. Therefore, you should specify the character
string number so that they differ for the drawing fields.
61
Because the automatic field clearing is not performed between the Clear command
([ESC] C on page 50) and the Issue command ([ESC] XS on page 155), the fixed
data may be drawn using the same character string number. In this case, the Format
command and Data command should be sent alternately. (After you send the Issue
command, the fields with the same character string number are automatically cleared
until you send the Clear command.)
The link field designation is cleared by omitting the link field designation using the
same character string number and reformatting data. The link field designation can be
also cleared by [ESC] C on page 50.
A print data string and link field number cannot be programmed at the same time.
When a reserved font type is designated, a bitmap font format is not specified.
You can program drawing data by designating a number of digits after the = symbol.
With most fonts, up to 255 digits of characters can be printed. If the number of
characters exceeds the maximum number of digits, the excess data will be discarded.
For the character codes, refer to Character Code Tables on page 194.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
62
Drawing Format Commands
Example 1 • The print origin of coordinates must be set so that the character drawing
result is within the print area set by [ESC] D on page 41.
Example 2 •
orientation
Examples of horizontal and vertical magnification, based on text
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
63
Example 3 •
Example of the relationship between drawing coordinates and
magnification.
Example 4 •
Example of
fine adjustment of character-to-character space
If no character-to-character space is specified or if the number of dots of space
between characters is zero, drawing takes place according to horizontal
spacing/proportional spacing determined for each character. If a character-tocharacter space is specified, this value is added to the character
spacing/proportional
spacing.
Example 5 •
08/28/2018Virtual Device-T User GuideP1067299-003
Example of rotational angles
Commands
64
Drawing Format Commands
Example 6 • Example of character attributes
Example 7 •
Example of bold character designation
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 8 • The printer prints while data is incremented or decremented each time
that a label format is sent. If a data row exceeds 40 digits, the row is not drawn.
Example 9 • Handling of letters and numerals for incrementing/decrementing
The data string can include up to 40 digits of letters, numerals, and symbols. Only the
numerals are subjected to incrementing/decrementing. The incremented/decremented
value is returned to the position of the original numeral for printing.
Example 10 • The printer can draw up to 32 fields for which increment/decrement has
been designated. If the total number of bitmap font, outline font, and barcode
increment/decrement fields is greater than 32, drawing takes place without
incrementing/decrementing more than the first 32 fields. The fields are incremented or
decremented as specified until the Image Buffer Clear command ([ESC] C
on page 50) is transmitted.
This sample shows how you would send commands to increment/decrement different
fields on labels:
1. Command: Format (incrementing character string number 001 (+1))
2. Command: Format (non-incrementing character string number 002)
3. Command: Format (incrementing character string number 003 (+2))
4. Command: Image Buffer Clear
5. Command: Data (character string number 001 “0001”)
6. Command: Data (character string number 002 “AB-”)
7. Command: Data (character string number 003 “0100”)
8. Command:
9. Command:
10. Command: Image Buffer Clear
11. Command: Data (character string number 02 “00000”)
12. Command:
Issue (2 labels)
Issue (1 label)
Issue (1 label)
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
67
Example 11 •
Zero suppression works by replacing leading zeroes with spaces,
according to the specified number of digits. In instances where the number of digits
after zero suppression is greater than the data row, the printer draws the data row
without performing zero suppression.
If a data row exceeds 40 digits, the data row is
not drawn.
Number of digits after
zero suppression
0122345
data0000000000000A12012301230123
print result 0000
(? indicates a space but does not print.)
???0??00?A12?12301230123
Example 12 • How alignment affects text placement
If characters are not all on one line when justification and automatic line feed are
specified, the printer does the following:
1. The character-to-character space is decreased.
2. If the characters do not fit on one line even if the character-to-character space value is set to
0, that value returns to its default. Then the horizontal magnification is reduc ed for a
character by 0.5.
3. If the characters still do not fit on one line, the value of the character-to-character space is
repeatedly decreased, and the horizontal magnification is reduced.
4. If the characters do not fit on one line after the character magnification is set to 0.5 and the
character-to-character space is set to 0, the field is not drawn.
Example 13 • The check digit attachment, increment/decrement, and zero
suppression are prioritized as follows. If any of the conditions is invalid, no drawing
takes place.
increment/decrement > zero suppression > attachment of check digit
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
68
Drawing Format Commands
Example 14 • Programming link field numbers
A link field number can be designated after a semicolon (;) in a Format command.
After the link field number is designated, the data strings are linked by a Link Field
Data command to draw an image.
Up to 20 fields can be linked. An error occurs if the number of link fields exceeds 20.
The following example shows linked fields on two continuous labels.
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 15 • The following sample code would result in a label as shown.
A = TEC FONT1 (Helvetica [bold])
B = TEC FONT1 (Helvetica [bold], proportional)
E = Price font 1
F = Price font 2
G = Price font 3
K = Reserved
C, D, H, I, J: = Reserved (If one of these is specified, it is processed as B.)
g = increases or decreases the character-to-character space.
+ = Increase the space
– = Decrease the space
h = number of dots between characters. Must be three digits.
000 to 512 dots
000°
1190°
22180°
33270°
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
72
Drawing Format Commands
j = character attributes
B = black characters
W (xy) = reverse characters* **
x = number of dots horizontally from the character string to the end of the black
background
01 to 99
y = number of dots vertically from the character string to the end of the black
background
01 to 99
F (xy) = boxed characters*
x = number of dots horizontally from the character string to the surrounding box
01 to 99
y = number of dots vertically from the character string to the surrounding box
01 to 99
C (x) = strike-through characters*
x = number of dots horizontally from the character string to the end of the strike-
through line
01 to 99
* Specifications in parentheses can be omitted, in which case the value used
is the character size (character height or width, whichever is larger) ÷ 8 dots.
** If the print ratio of a line (the printhead width) is too high, printing may
become poor, or the printer may reset. When you specify to print reversed
characters, be aware of the print ratio being used.
Mk = attach the specified check digit* (Can be omitted, in which case no check digit is drawn.
If any data other than numerals are included for the fonts listed below, no drawing is
performed.)
k = the type of check digit*
0 = Modulus 10 (draws data and check digit)—Data must include only numerals.
1 = Modulus 43 (draws data and check digit)—Data must include only CODE39.
2 = DBP Modulus 10** (draws only the check digit)—Data must include only
numerals.
* The check digit cannot be specified if the font type is U, V, r, s, or w. If it is
specified, the printer ignores it.
** DBP Modulus 10 is Modulus 10 for Deutsche Bundespost Postdienst only.
lm = increment and decrement (Can be omitted, in which case no increment/decrement is
performed.)
l = specifies whether to increment or decrement
+ = Increment
– = Decrement
m = skip value. Must be ten digits.
0000000000 to 9999999999
Zn = zero suppression (Can be omitted, in which case zero suppression is not performed.)
= number of digits after zero suppression. Must be two digits.
n
00 to 20
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Po = alignment (Can be omitted, in which case left alignment is used.)
o = specifies the character position
1 = left
2 = center
3 = right
4a = justified*
a = character string in the X direction (in 0.1 mm units)
0050 to 1040
Qq = character string width (in 0.1 mm units) (Can be omitted, in which case 0000 is used.)
q = specifies the character width. Must be four digits.
0000 to 1600
Rr = the number of digits in the character string (Can be omitted, in which case 00 is used.
)
r = specifies the number of digits. Must be two digits.
00 to 99
s = a data string to be printed (Can be omitted.)
255 digits maximum
t1, t2, t3, ..., t20 = up to 20 link field numbers, separated by commas (Can be omitted.)
01 to 99 or 1 to 99
73
Notes This command specifies where and how an outline font is to be printed on a
label. When drawing using the Data Command ([ESC] RC on page 140), the format
specified by the character string number is used.
The Bitmap Font Format Command ( [ESC] PC on page 58) may be connected
to the Outline Font Format Command ([ESC] PV on page 71) when transmitted.
[ESC] PC001; 0100, 0150, 1, 1, A, 00, B [LF]
C002; 0350, 0180, 1, 1, A, 00, B [LF]
C005; 0200, 0300, 25, 2, C, +05, 00, B,
+0000000001 [LF]
V01; 0500, 0400, 0100, 0100, A, 00, B [LF] [NUL]
You can program drawing data by designating a number of digits after the = symbol.
Up to 255 digits of characters can be printed. If the number of characters exceeds the
maximum number of digits, the excess data will be discarded. For the character
codes, refer to Character Code Tables on page 194.
A print data string and link field number cannot be programmed at the same time.
When a reserved font type is designated, a bitmap font format is not specified.
The link field designation is cleared by omitting the link field designation using the
same character string number and reformatting data. The link field designation can be
also cleared by [ESC] C on page 50.
When the drawing data is different between labels, the drawing data field for the
previous label is cleared automatically using the character string number, and then
the next drawing data field is printed. Therefore, you should specify the character
string number so that they differ for the drawing fields.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
74
Drawing Format Commands
Because the automatic field clearing is not performed between the Clear command
([ESC] C on page 50) and the Issue command ([ESC] XS on page 155), the fixed
data may be drawn using the same character string number. In this case, the Format
command and Data command should be sent alternately. (After you send the Issue
command, the fields with the same character string number are automatically cleared
until you send the Clear command.)
The link field designation is cleared by omitting the link field designation using the
same character string number and reformatting data. The link field designation can be
also cleared by [ESC] C on page 50.
The outline font does not print properly in the following situations:
• When characters overlap because of fine adjustments to the character-to-character space. Use fine adjustment values that do not cause the characters to
overlap.
• When items such as lines or characters are positioned over the outline font area.
For font types A, B, and K, set the fine adjustment value so that other items do not
overlap the area in which the outline font is to be drawn. For font types E, F, and G,
set the fine adjustment value so that other items do not overlap the area
designated by the character width and height.
The check digit attachment, increment/decrement, and zero suppression are
prioritized as follows. If any of the conditions is invalid, no drawing takes place.
increment/decrement > zero suppression > attachment of check digit
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 1 • The print origin of coordinates must be set so that the character drawing
result is within the print area set by [ESC] D on page 41.
75
Example 2 •
Examples of character width and character height, based on text
orientation
Example 3 • How alignment affects text placement
If characters are not all on one line when justification and automatic line feed are
specified, the printer calculates the width automatically. If the width is less than the 2mm minimum for the outline font, the printer does not draw that field.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
76
Drawing Format Commands
Example 4 •
Example of
fine adjustment of character-to-character space
If no character-to-character space is specified or if the number of dots of space
between characters is zero, drawing takes place according to horizontal
spacing/proportional spacing determined for each character. If a character-tocharacter space is specified, this value is added to the character
spacing/proportional
spacing. If alignment is set to justify, the character-to-character spacing is ignored.
The amount that horizontal spacing/proportional spacing is changed depends on the
character size.
Example 5 • Example of rotational angles
Example 6 • Example of character attributes
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 7 • The printer prints while data is incremented or decremented each time
that a label format is sent. If a data row exceeds 40 digits, the row is not drawn.
Example 8 • Handling of letters and numerals for incrementing/decrementing
The data string can include up to 40 digits of letters, numerals, and symbols. Only the
numerals are subjected to incrementing/decrementing. The incremented/decremented
value is returned to the position of the original numeral for printing.
Zero suppression works by replacing leading zeroes with spaces,
according to the specified number of digits. In instances where the number of digits
after zero suppression is greater than the data row, the printer draws the data row
without performing zero suppression.
If a data row exceeds 40 digits, the data row is
not drawn.
Number of digits after
zero suppression
0122345
data0000000000000A12012301230123
print result 0000
(? indicates a space but does not print.)
???0??00?A12?12301230123
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
78
Drawing Format Commands
Example 10 • Programming link field numbers
A link field number can be designated after a semicolon (;) in a Format command.
After the link field number is designated, the data strings are linked by a Link Field
Data command to draw an image.
Up to 20 fields can be linked. An error occurs if the number of link fields exceeds 20.
The following example shows linked fields on two continuous labels.
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
0001
AB-0100
0002
AB-0102
0003
AB-0104
00000
Drawing Format Commands
Example 11 • The printer can draw up to 32 fields for which increment/decrement has
been designated. If the total number of bitmap font, outline font, and barcode
increment/decrement fields is greater than 32, drawing takes place without
incrementing/decrementing more than the first 32 fields. The fields are incremented or
decremented as specified until the Image Buffer Clear command ([ESC] C
on page 50) is transmitted.
This sample shows how you would send commands to increment/decrement different
fields on labels:
1. Command: Format (incrementing character string number 001 (+1))
2. Command: Format (non-incrementing character string number 002)
3. Command: Format (incrementing character string number 003 (+2))
4. Command: Image Buffer Clear
5. Command: Data (character string number 001 “0001”)
6. Command: Data (character string number 002 “AB-”)
79
7. Command: Data (character string number 003 “0100”)
8. Command:
9. Command:
10. Command: Image Buffer Clear
11. Command: Data (character string number 02 “00000”)
12. Command:
Issue (2 labels)
Issue (1 label)
Issue (1 label)
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
80
Drawing Format Commands
Example 12 • The following sample code would result in a label as shown.
WPC Modulus 10
CODE93 Modulus 47
CODE128 PSEUDO 103
UCC/EAN128 or EAN128 PSEUDO 103
POSTNET Special check digit
4 = check digit auto attachment 2
WPC Modulus 10 + Price C/D 4 digits
5 = check digit auto attachment 3
WPC Modulus 10 + Price C/D 5 digits
* For the POSTNET barcode, only option 3 is available.
f = 1-module width (in dots). Must be two digits.
01 to 15
k = rotational angle of barcodes
Commands
Drawing Format Commands
83
00°
190°
2180°
3270°
l = the barcode height. Specified in 0.1 mm (0.0039 in.) increments.
0000 to 1000
For the POSTNET barcode, this parameter sets the height of the long bar.
mn = increment and decrement* (Can be omitted, in which case no increment/decrement is
performed.)
m = specifies whether to increment or decrement
+ = Increment
– = Decrement
n = skip value. Must be ten digits.
0000000000 to 9999999999
* Cannot be set when the POSTNET barcode is specified.
o =Reserved. Any value specified is ignored.
p = specify whether to print numerals under barcodes* (Can be omitted, in which case no
numerals are printed.)
0 = do not print the numerals
1 = print the numerals
* Cannot be set when the POSTNET barcode is specified.
q = zero suppression* (Can be omitted, in which case zero suppression is not performed.)
q = number of digits after zero suppression. Must be two digits.
00 to 20
* Cannot be set when the POSTNET barcode is specified.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
84
Drawing Format Commands
s = a data string to be printed* (Can be omitted.)
126 digits maximum
* The actual number of digits that you can use varies according to the barcode
type.
t1, t2, t3, ..., t20 = up to 20 link field numbers, separated by commas (Can be omitted.)
01 to 99 or 1 to 99
Notes This command specifies where and how a specific barcode is to be printed.
When drawing using the Data Command ([ESC] RB on page 146), the format
specified by the barcode number is used.
This command and its parameters allow you to do the following:
• You can specify whether numerals are printed under barcode bars. How numerals
print under the bars varies according to the barcode type, but the font used is
always OCR-B. These numerals may be enlarged or reduced horizontally based
on the barcode width. If the numerals are drawn vertically, they are not enlarged
or reduced. See Table 7, Supported Barcode Fonts and Two-Dimensional Codes
on page 190 for samples of barcodes with numerals under the bars.
• You can transmit more than one Barcode Format ([ESC] XB) command at a time:
• You can program drawing data by designating a number of digits after the =
symbol. The barcode number determines the number of digits of digits that can be
printed. If the number of characters exceeds the maximum number of digits, the
excess data will be discarded.
In situations where the drawing data changes for each label during printing, the printer
automatically clears the data from the previous label and then prints the next instance
of drawing data.
Because the drawing data field is not cleared between the Clear command ([ESC] C
on page 50) and Issue command ([ESC] XS on page 155), fixed data may be drawn
using the same barcode number that was used for the last drawing. Because of this,
the Format command and Data command should be sent alternately.
You can clear the link field designation by omitting the link field designation while
using the same barcode number and reformatting data. You can also use the Clear
command ([ESC] C on page 50). A print data string and a link field number cannot be
programmed at the same time.
The check digit attachment, increment/decrement, and zero suppression are
prioritized as follows. If any of the conditions is invalid, no drawing takes place.
increment/decrement > zero suppression > attachment of check digit
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Check Digits
If no check digit is attached, the printer draws a barcode of the data row.
For those instances where a check digit check is performed, the check is performed
according to the type of barcode. If the results are normal, the printer draws a
barcode. If the results are improper, the printer does not draw a barcode.
For those instances where the check digit is attached automatically, each check digit
is attached according to the type of barcode when a barcode is drawn.
With barcode types CODE93, CODE128 (with auto code selection), and
UCC/EAN128 or EAN128, the check digit is always attached regardless of the
designation of the type of check digit. With barcode types JAN, EAN, or UPC, the
designation of no check digit attachment automatically assumes the check digit
check.
Example 1 • The print origin of coordinates must be set so that the drawing result is
within the print area set by [ESC] D on page 41. See Table 7, Supported Barcode
Fonts and Two-Dimensional Codes on page 190 for examples of the barcodes.
85
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
86
Drawing Format Commands
Example 2 • Bar width, space width, and character-to-character space width
The width of bars, spaces, and character-to-character spaces are designated
according to the type of barcode. The correct values to use differ based on factors
such as the rotational angle of the barcode, the barcode type, the number of digits,
the print speed, and the media used.
With the barcodes in the following example, the width of modules 2 to 6 is calculated
automatically based on what you designate for a 1-module width. With a
Example 6 • Handling of letters and numerals for incrementing/decrementing
The data string can include up to 40 digits of letters, numerals, and symbols. Only the
numerals are subjected to incrementing/decrementing. The incremented/decremented
value is returned to the position of the original numeral for printing.
With CODE93 and CODE128, increment/decrement is performed even if a data string
other than numerals are included in the data. However, increment/decrement is not
performed if code that does not exist in barcode table is contained in the data. See
Barcode/Two-Dimensional Code Tables on page 201 for more information.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
88
Drawing Format Commands
Example 7 • Incrementing/decrementing of data, including the special codes of
CODE128
Incrementing/decrementing calculation starts from the rightmost digit in the data
strings. If the data string to be calculated is numeric and the next digit to the left is a >
symbol (such as that shown underlined in the following table), these two digits are
skipped, and the next digit is incremented/decremented.
Example of increment/decrement calculation of CODE128
Zero suppression works by replacing leading zeroes with spaces,
080A > 080A9 > 08
90A > 090A9 > 09
01A > 001A0 > 00
11A > 011A0 > 01
21A > 021A0 > 02
according to the specified number of digits. In instances where the number of digits
after zero suppression is greater than the data row, the printer draws the data row
without performing zero suppression.
If a data row exceeds 40 digits, the data row is
not drawn.
Number of digits after
zero suppression
0122345
data0000000000000A12012301230123
print result 0000
(? indicates a space but does not print.)
???0??00?A12?12301230123
When you send print data that includes start/stop codes, the start/stop codes are each
counted as one digit. Zero suppression is not performed when the barcode type is
JAN, EAN, UPC, UCC/EAN 128, or EAN128.
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 9 • Programming link field numbers
A link field number can be designated after a semicolon (;) in a Format command.
After the link field number is designated, the data strings are linked by a Link Field
Data command to draw an image.
Up to 20 fields can be linked. An error occurs if the number of link fields exceeds 20.
The following example shows linked fields on two continuous labels.
89
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
90
Drawing Format Commands
Example 10 • The printer can draw up to 32 fields for which increment/decrement has
been designated. If the total number of bitmap font, outline font, and barcode
increment/decrement fields is greater than 32, drawing takes place without
incrementing/decrementing more than the first 32 fields. The fields are incremented or
decremented as specified until the Image Buffer Clear command ([ESC] C
on page 50) is transmitted.
This sample shows how you would send commands to increment/decrement different
fields on labels:
1. Command: Format (incrementing barcode number 01 (+1))
2. Command: Format (incrementing barcode number 02 (+2))
3. Command: Image Buffer Clear
4. Command: Data (barcode number 01 “0001”)
5. Command: Data (barcode number 02 “0100”)
6. Command: Issue (2 labels)
7. Command:
8. Command: Image Buffer Clear
9. Command: Data (barcode number 02 “3000”)
P1067299-003Virtual Device-T User Guide08/28/2018
Issue (1 label)
Commands
Drawing Format Commands
91
10. Command:
Issue (1 label)
Example 11 • The following sample code would result in a label as shown.
CODE39Modulus 43
MSIIBM modulus 10
ITFModulus 10
Industrial 2 of 5Modulus check character
3 = check digit auto attachment 1
CODE39Modulus 43
MSIIBM modulus 10
ITFModulus 10
Industrial 2 of 5Modulus check character
4 = check digit auto attachment 2
MSIIBM modulus 10 + IBM modulus 10
ITFDBP Modulus 10*
5 = check digit auto attachment 3
MSIIBM modulus 11 + IBM modulus 10
* DBP Modulus 10 is Modulus 10 for Deutsche Bundespost Postdienst only.
P1067299-003Virtual Device-T User Guide08/28/2018
f = the narrow bar width (in dots)
01 to 99
g = the narrow space width* (in dots)
01 to 99
* For Industrial 2 of 5, designate an element-to-element space.
h = the wide bar width (in dots)
01 to 99
i = the wide space width* (in dots)
01 to 99
For Industrial 2 of 5, the value is fixed at 00.
j = the character-to-character space width* (in dots)
01 to 99
* For MSI and ITF, the character-to-character space width is fixed at 00.
k = rotational angle of barcodes
00°
190°
2180°
3270°
Commands
Drawing Format Commands
93
l = the barcode height. Specified in 0.1 mm (0.0039 in.) increments.
0000 to 1000
For the POSTNET barcode, this parameter sets the height of the long bar.
mn = increment and decrement (Can be omitted, in which case no increment/decrement is
performed.)
l = specifies whether to increment or decrement
+ = Increment
– = Decrement
m = skip value. Must be ten digits.
0000000000 to 9999999999
p = specify whether to print numerals under barcodes (Can be omitted, in which case no
numerals are printed.)
0 = do not print the numerals
1 = print the numerals
q = zero suppression (Can be omitted, in which case zero suppression is not performed.)
q = number of digits after zero suppression. Must be two digits.
00 to 20
r = specify whether to attach start/stop codes* (Can be omitted, in which case the start/stop
codes are attached automatically.) For more information, see Automatic Addition of
Start/Stop Codes on page 249.
T = attach start code only
P = attach stop code only
N = do not attach start/stop codes
* Applies only when the barcode type is CODE39 or NW7.
For CODE39, “*” is added. For NW7, “a” is added.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
94
Drawing Format Commands
s = a data string to be printed* (Can be omitted.)
126 digits maximum
* The actual number of digits that you can use varies according to the barcode
type.
t1, t2, t3, ..., t20 = up to 20 link field numbers, separated by commas (Can be omitted.)
01 to 99 or 1 to 99
Notes This command specifies where and how a specific barcode is to be printed.
When drawing using the Data Command ([ESC] RB on page 146), the format
specified by the barcode number is used.
This command and its parameters allow you to do the following:
• You can specify whether numerals are printed under barcode bars. How numerals
print under the bars varies according to the barcode type, but the font used is
always OCR-B. These numerals may be enlarged or reduced horizontally based
on the barcode width. If the numerals are drawn vertically, they are not enlarged
or reduced. See Barcode Fonts on page 190 for samples of barcodes with
numerals under the bars.
• You can transmit more than one Barcode Format ([ESC] XB) command at a time:
• You can program drawing data by designating a number of digits after the =
symbol. The barcode number determines the number of digits of digits that can be
printed. If the number of characters exceeds the maximum number of digits, the
excess data will be discarded.
In situations where the drawing data changes for each label during printing, the printer
automatically clears the data from the previous label and then prints the next instance
of drawing data.
Because the drawing data field is not cleared between the Clear command ([ESC] C
on page 50) and Issue command ([ESC] XS on page 155), fixed data may be drawn
using the same barcode number that was used for the last drawing. Because of this,
the Format command and Data command should be sent alternately. (After you send
the Issue command, the fields with the same barcode number are automatically
cleared until you send the Clear command.)
You can clear the link field designation by omitting the link field designation while
using the same barcode number and reformatting data. You can also use the Clear
command ([ESC] C on page 50). A print data string and a link field number cannot be
programmed at the same time.
The check digit attachment, increment/decrement, and zero suppression are
prioritized as follows. If any of the conditions is invalid, no drawing takes place.
increment/decrement > zero suppression > attachment of check digit
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Type of Check Digit
If no check digit is attached, the printer draws a barcode of the data row.
For those instances where a check digit check is performed, the check is performed
according to the type of barcode. If the results are normal, the printer draws a
barcode. If the results are improper, the printer does not draw a barcode.
For those instances where the check digit is attached automatically, each check digit
is attached according to the type of barcode when a barcode is drawn.
Example 1 • The print origin of coordinates must be set so that the drawing result is
within the print area set by [ESC] D on page 41. See Table 7, Supported Barcode
Fonts and Two-Dimensional Codes on page 190 for examples of the barcodes.
95
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
96
Drawing Format Commands
Example 2 • Bar width, space width, and character-to-character space width
The width of bars, spaces, and character-to-character spaces are designated
according to the type of barcode. The correct values to use differ based on factors
such as the rotational angle of the barcode, the barcode type, the number of digits,
the print speed, and the media used.
With a 203-dpi printhead, one dot = 1/8 mm.
Barcode type
narrowwide
barspacebarspace
character-to-
character
space
MSI22660
ITF22660
CODE3922662
NW722662
Industrial 2 of 522602
With NW7, when the space character is transmitted, the printer assumes that a space
equals the width of a narrow space x 12 dots. The maximum width is 255 dots.
Example 3 • Rotational angle of barcodes
Example 4 • Barcode height determination
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 5 • The printer prints while data is incremented or decremented each time
that a label format is sent. If a data row exceeds 40 digits, the row is not drawn.
Example 6 • Handling of letters and numerals for incrementing/decrementing
The data string can include up to 40 digits of letters, numerals, and symbols. Only the
numerals are subjected to incrementing/decrementing. The incremented/decremented
value is returned to the position of the original numeral for printing.
For CODE39 (standard), CODE39 (full ASCII), and NW-7, even if a data string other
than numerals are included in the data, increment/decrement is performed.
However, if any code which does not exist in each barcode table is contained in the
data, increment/decrement is not performed. See Barcode/Two-Dimensional Code
Tables on page 201 for more information.
Example 7 •
Zero suppression works by replacing leading zeroes with spaces,
according to the specified number of digits. In instances where the number of digits
after zero suppression is greater than the data row, the printer draws the data row
without performing zero suppression.
If a data row exceeds 40 digits, the data row is
not drawn.
Number of digits after
zero suppression
0122345
data0000000000000A12012301230123
print result 0000
(? indicates a space but does not print.)
???0??00?A12?12301230123
When you send print data that includes start/stop codes, the start/stop codes are each
counted as one digit.
08/28/2018Virtual Device-T User GuideP1067299-003
Commands
98
Drawing Format Commands
Example 8 • Programming link field numbers
A link field number can be designated after a semicolon (;) in a Format command.
After the link field number is designated, the data strings are linked by a Link Field
Data command to draw an image.
Up to 20 fields can be linked. An error occurs if the number of link fields exceeds 20.
The following example shows linked fields on two continuous labels.
P1067299-003Virtual Device-T User Guide08/28/2018
Commands
Drawing Format Commands
Example 9 • The printer can draw up to 32 fields for which increment/decrement has
been designated. If the total number of bitmap font, outline font, and barcode
increment/decrement fields is greater than 32, drawing takes place without
incrementing/decrementing more than the first 32 fields. The fields are incremented or
decremented as specified until the Image Buffer Clear command ([ESC] C
on page 50) is transmitted.
This sample shows how you would send commands to increment/decrement different
fields on labels:
1. Command: Format (incrementing barcode number 01 (+1))
2. Command: Format (incrementing barcode number 02 (+2))
3. Command: Image Buffer Clear
4. Command: Data (barcode number 01 “0001”)
5. Command: Data (barcode number 02 “0100”)
6. Command: Issue (2 labels)
99
7. Command:
8. Command: Image Buffer Clear
9. Command: Data (barcode number 02 “3000”)
08/28/2018Virtual Device-T User GuideP1067299-003
Issue (1 label)
100
Commands
Drawing Format Commands
10. Command:
Issue (1 label)
Example 10 • The following sample code would result in a label as shown.