# Краткая справка по коммандам TSPL
# Краткая справка по коммандам TSPL

::::cut{title="SIZE m, n"}
m — ширина этикетки (ширина рулона)

n - длина этикетки на ленте.

:::danger
Обязательно указывайте `mm` после цифры. Если этого не сделать, то размер будет расчитываться в дюймах.
Неправильно: `SIZE 100, 150`
Правильно: `SIZE 100 mm, 150 mm`
:::
::::

::::cut{title="GAP m, 0"}
m — расстояние между этикетками на ленте. Обязательно указание mm

0 — должен быть 0 для прямоугольных и квадратных этикеток

:::danger
Обязательно указывайте `mm` после цифры. Если этого не сделать, то размер будет расчитываться в дюймах.
Неправильно: `GAP 3, 0`
Правильно: `GAP 3 mm, 0`
:::
::::

::::cut{title="DIRECTION m"}
m — 1 или 0. Направление этикетки. 0 - первым из принтера появится верх этикетки, 1 - первым появится низ.

:::info
Пример: `DIRECTION 1`
:::
::::

::::cut{title="TEXT x,y,"font",rotation,x-multiplication,y-multiplication,[align,]"content""}
Выводит строку текста
`x`,`y` - координаты верхнего левого угла текста в точках
`"font"` - название шрифта, обязательно в кавычках и важен регистр. В принтере есть встроенный шрифт `ROMAN.TTF`
`rotation` - угол поворота текста в блоке. Одно из чисел `0`,`90`,`270`,`180`
`x-multiplication`,`y-multiplication` - число от 1 до 10. Множитель размера шрифта по x и y. Для шрифтов TTF:

*   cтоит делать его одинаковым для x и y
*   может быть не только целым, например `3.5`

`align` - выравнивание текста, 0 и 1 - по левому краю, 2 - по центру, 3 - по правому краю. Не обязателен. По-умолчанию - по левому краю.
`"content"` - содержимое текста. Если в содержимом есть двойные кавычки ее нужно заэкранировать `\["]`

:::info
Пример: `TEXT 240,695,"ARIAL.TTF",270,8,0, "Масса нетто: [weight]"`
:::
::::

::::cut{title="BLOCK x,y,width,height,"font",rotation,x-multiplication,y-multiplication,[space,]align,]fit,]"content""}
Задает многострочный блок текста
`x`,`y` - координаты верхнего левого угла блока в точках
`width`,`height` - ширина и высота блока в точках
`"font"` - название шрифта, обязательно в кавычках и важен регистр. В принтере есть встроенный шрифт `ROMAN.TTF`
`rotation` - угол поворота текста в блоке. Одно из чисел `0`,`90`,`270`,`180`
`x-multiplication`,`y-multiplication` - число от 1 до 10. Множитель размера шрифта по x и y. Для шрифтов TTF:

*   cтоит делать его одинаковым для x и y
*   может быть не только целым, например `3.5`

`space` - расстояние между строками в точках. Не обязателен
`align` - выравнивание текста, 0 и 1 - по левому краю, 2 - по центру, 3 - по правому краю. Не обязателен. По-умолчанию - по левому краю.
`fit` - обрезать текст. 0 - не обрезать, 1 - обрезать. По-умолчанию 0
`"content"` - содержимое блока. Если в содержимом есть двойные кавычки их нужно заэкранировать `\["]`

:::info
Пример: `BLOCK 160,695,350,72,"ARIAL.TTF",270,7,7, "Изготовлено и упаковано:"`
:::
::::

::::cut{title="DMATRIX x,y,width,height,с126,[x#,r#,a#,row,col,] "content""}
Добавляет DataMatrix код на этикетку
`x`,`y` — координаты верхнего левого угла блока в точках
`width`,`height` — ширина и высота блока в точках
`c126` — закодированный символ экранирования. 126 - `~`. Не стоит его менять
`x#` — размер модуля кода в точках. Для модуля размером 3 точки напишите `x3`
`r#` — градус поворота, может быть 0, 90, 180 или 270. Чтобы перевернуть код вверх ногами укажите `r180`
`a#` — укажите `a0` или опустите, чтобы код был квадратным. `a1` используется для прямоугольного кода
`row`,`col` — ширина и высота кода в модулях. Если не указать, то решиться само
`"content"` - содержимое кода. Кавычки в коде нужно экранировать `\["]`. Чтобы получился код GS1 вначале содержимого добавьте `~1`

:::info
Пример: `DMATRIX 10,185,185,200,c126,x7,r0, "~1[barcode]"`
:::
::::

::::cut{title="BARCODE x,y, "code_type ",height,human_readable,rotation,narrow,wide,[align,] "content""}
Выводи линейный штрихкод различных форматов
`x`,`y` - координаты размещения кода в точках.
`"code_type"` - тип линейного кода. Для EAN13 укажите `EAN13`
`height` - высота кода в точках
`human_readable` - как выравнивать содержимое кода, выводимое символами под кодом относительно кода. 0 — не выводить символы, 1 — слева, 2 — по центру, 3 — справа
`rotation` — градусы поворота, могут быть 0,90,180 и 270. Поворот кода производится производится вокруг координат размещения, т. е. если, например, поворачивать код на 270 градусов с левым выравниванием, то в качестве координаты угла нужно указать левый нижний угол желаемого положения кода.
`narrow`,`wide` — ширина узкого и широкого элемента кода в точках. Для кода EAN13 должны быть равны друг другу (принтер проигнорирует параметр wide). Т. е. если вам нужен более широкий код используете большее значение narrow.
`align` - выравнивание кода относительно координат размещения, 0 и 1 - по левому краю (по-умолчанию), 2 - по центру, 3 - по правому краю. Не обязателен.
`"content"` - содержимое кода. Если в содержимом есть двойные кавычки их нужно заэкранировать `\["]`

:::info
Пример: `BARCODE 300,600,"EAN13",100,2,0,5,2,"2000000[ean_weight]"`
:::
::::