1. TOP»
  2. ePOS-Print XML »
  3. XML for Controlling Printer »
  4. <layout>

Select your printer model

Parameters are refined by the selected printer.

<layout>

This element allows you to specify the paper settings.

These settings are required when using paper with black mark or die-cut labels.

Attribute

Note:

If none of the attributes are specified, the values shown below are set.

  • type: receipt
  • width: 580
  • height: 0
  • margin-top: 0
  • margin-bottom: 0
  • offset-cut: 0
  • offset-label: 0

type

Attribute value

Description

receipt

Receipt (without black mark)

receipt_bm

Receipt (with black mark)

label

Label sheet (without black mark)

label_bm

Label sheet (with black mark)

width

Attribute value

Description

"290" to "600"

Specifies the paper width in units of 0.1 mm

height

Valid value

Paper type

Description

"0"

Receipt (without black mark)

No need to specify

Receipt (with black mark)

Label sheet (without black mark)

Label sheet (with black mark)

"254" to "2540"

Receipt (with black mark)

Specifies the distance between the top edges of two consecutive black marks in units of 0.1 mm.

"284" to "-1550"

Receipt (with black mark)

Specifies the distance between the top edges of two consecutive black marks in units of 0.1 mm.

Label sheet (without black mark)

Specifies the distance between the top edges of two consecutive labels in units of 0.1 mm.

Label sheet (with black mark)

Specifies the distance between the bottom edges of two consecutive black marks in units of 0.1 mm.

margin-top

Valid value

Paper type

Description

"0"

Receipt (without black mark)

No need to specify

"-150" to "1500"

Receipt (with black mark)

Specifies the distance from the top edge of a black mark to the next print start position in units of 0.1 mm.

"0" to "1500"

Label sheet (without black mark)

Specifies the distance between the top edge of a label to the next print start position in units of 0.1 mm.

"-15" to "1500"

Label sheet (with black mark)

Specifies the distance between the bottom edge of a black mark to the next print start position in units of 0.1 mm.

margin-bottom

Valid value

Paper type

Description

"0"

Receipt (without black mark)

No need to specify

Receipt (with black mark)

"-15" to "0"

Label sheet (without black mark)

Specifies the distance between the bottom edge of a label to the bottom of the print area in units of 0.1 mm.
(A positive value widens the margin and a negative value narrows it.)

"-15" to "15"

Label sheet (with black mark)

Specifies the distance between the bottom edge of a black mark to the bottom of the print area in units of 0.1 mm.
(A positive value widens the margin and a negative value narrows it.)

offset-cut

Valid value

Paper type

Description

"0"

Receipt (without black mark)

No need to specify

"-290" to "50"

Receipt (with black mark)

Distance from the top edge of the black mark to the cut position

"0" to "50"

Label sheet (without black mark)

Distance from the bottom edge of the label to the cut position

Label sheet (with black mark)

Distance from the top edge of the black mark to the cut position

offset-label

Valid value

Paper type

Description

"0"

Receipt (without black mark)

No need to specify

Receipt (with black mark)

Label sheet (without black mark)

"0" to "15"

Label sheet (with black mark)

Distance from the top edge of the black mark to the bottom edge of a label

Sample program

Changing paper

When changing paper to another type, change the paper setting before starting to print.

  • 58-mm receipt (without black mark)
  •  
    		 
    <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">
	<layout type="receipt" width="580" />
</epos-print>
  • 58-mm receipt (with black mark)
  •  
    		 
    <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">
	<layout type="receipt_bm" width="580" height="0" margin-top="15" offset-cut="0" />
</epos-print>
  • 58-mm label sheet (without black mark)
  •  
    		 
    <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">
	<layout type="label" width="580" height="0" margin-top="15" margin-bottom="-15" offset-cut="25" />
</epos-print>
  • 58-mm label sheet (with black mark)
  •  
    		 
    <epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">
	<layout type="label_bm" width="580" height="0" margin-top="15" margin-bottom="-15" offset-cut="25" offset-label = "15" />
</epos-print>

Label paper settings for TM-P series

For TM-P series except TM-P60, first you need to specify the label size settings and paper feed setting for feeding the sheet to the top of a label. 

 
 
<epos-print xmlns="http://www.epson-pos.com/schemas/2011/03/epos-print">

	<!-- Specify the paper settings -->
	<!-- Die-cut label, Sheet width: 58.0 mm, Height: Auto -->
	<!-- Top margin: 1.5 mm from the label top edge, Bottom margin: 1.5 mm from the label bottom edge -->
	<!-- Cut position: 2.5 mm from the label bottom edge -->
	<layout type="label" width="580" height="0" margin-top="15" margin-bottom="-15" offset-cut="25" offset-label="0"/>

	<!-- Feed the sheet to the label top -->
	<feed pos="next_tof"/>

</epos-print>

Supplementary explanation

  • This does not work in the page mode.
  • Refer to the following for the parameter positions available for each type of paper.
  • Graphic

  • Symbol

    Parameter

    f

    width

    a

    height

    b

    margin_top

    e

    margin_bottom

    c

    offset_cut

    d

    offset_label
 

Quick Access

  • [Name]
  • [Format]
  • [Range]
  • [Description]
  • [Notes]
ePOS-Print XML includes patented or patent pending functions. The contents must not be disclosed to third parties.


  1. TOP»
  2. ePOS-Print XML »
  3. XML for Controlling Printer »
  4. <layout>

Jump to the top