## Macro Command Reference

`text <tag> <x> <y> <font> <font size> <text> [c] [c] [c] [angle] [TEXTALIGN] [AUTOTEXTPOS] [offset] [cb] [cb] [cb]`

Adds a text label to the document.
`<tag>`: The `tag` argument should be an integer value which can be used later to address a graphic or text object. Interactively created text or graphic objects always have the tag 0.
`<x>`, `<y>`: the position in screen coordinates of the text.
`<font>`: The font for the text (e.g. Helvetica-Bold)
`<font size>`: The font size of the text.
`[c] [c] [c]`: The color of the text. Dependent on the color mode the three values are RGB or HSB values from 0.0 to 1.0. The color mode can be set with the command `colormode` (0=RGB, 1=HSB).
`[angle]`: The text angle.
`[TEXTALIGN]`: The text alignment.
`[AUTOTEXTPOS]`: The position for automatically positioned text label.
`[offset]`: Offset for automatically positioned text label.
`[cb] [cb] [cb]`: The color of the text background. Dependent on the color mode the three values are RGB or HSB values from 0.0 to 1.0. The color mode can be set with the command `colormode` (0=RGB, 1=HSB).

`AUTOTEXTPOS`

A parameter wich defines the alignment of different objects, possible values:

| `outsidetopleft otl 10` | `outsidetopcenter otc 11` | `outsidetopright otr 12` |
`outsidelefttop olt 21` | `topleft tl 1` | `topcenter tc 2` | `topright tr 3` | `outsiderighttop ort 13`
`outsideleftcenter olc 20` | `centerleft cl 4` | `center c 5` | `centerright cr 6` | `outsiderightcenter orc 14`
`outsideleftbottom olb 19` | `bottomleft bl 7` | `bottomcenter bc 8` | `bottomright br 9` | `outsiderightbottom orb 15`
| `outsidebottomleft obl 18` | `outsidebottomcenter obc 17` | `outsidebottomright obr 16` |

`TEXTALIGN`

A parameter wich defines the alignment of text elements:

`left l 0` | `center c 1` | `right r 2`