Programming Overview
Certain commands are disabled or work differently while the printer is in portrait mode. Exact details can be found with each command’s description.
Landscape Mode
By using the set print orientation command (GS V), you can configure the LabelWriter printer for landscape printing. In landscape printing, text characters travel out of the printer from the left side of the character to the right. Before the printer can be switched to landscape printing though, you must send the set characters per line command (GS t). The set characters per line command defines the width of the landscape page.
A landscape page is defined as the area allocated by the LabelWriter printer in which landscape text, graphics, barcode, and line objects may be printed. The height of this landscape page always equals the width of the print head. The width of the landscape page is calculated when the set characters per line command (GS t) is sent. The width of the page is equal to the number of characters per line multiplied by the width of the current font. The default font is 16 dots wide (2 mm) and the default number of characters per line is 80.
In landscape mode, completed objects are placed within a memory buffer in the printer and are only printed when the landscape page is terminated. A form feed (FF) character is normally used to terminate a landscape page. This causes the printer to print the objects that have been placed on the landscape page and advance to the next label.
After a landscape page is printed, the LabelWriter printer will remain in landscape mode. If more objects are sent to the printer, a new landscape page will be allocated, with a width equal to the previous page. To change the width of a landscape page, you must send the set characters per line command (GS t) followed by the set print orientation command (GS V).
Because the LabelWriter printer does not print objects immediately, multiple objects can be placed on the same line. The set horizontal starting position (ESC X) and set vertical starting position (ESC Y) commands allow objects to be placed at any location within a landscape page. In the case of objects that are positioned to overlap each other, the first object that is sent to the printer will be printed in the overlapping area.
Objects that would normally print below the bottom of the landscape page can be either wrapped to the next label or truncated by using the select line wrap/truncate modes command (GS T).
Unless the set vertical starting position command (ESC Y) is used, the first object sent will be printed at the top of the landscape page. When printing to a label that is narrower than the print head, the top of the landscape page will be above the top of the label. In this case, you should use the set vertical starting position command (ESC Y) to position the object on an area of the landscape page that corresponds to the label.
Text Objects
A text object is simply a line of printable characters. A text object is created whenever the LabelWriter printer receives a printable character that is not otherwise part of a command. Once it’s created, a text object will remain active until it is terminated.
While a text object is active, any printable characters sent to the printer will be added to that text object. The only exceptions are printable characters that are sent as part of a
10