text [ item <id> ] <text string> [ at <vector> ] [ rotate <angle> ] [ gap <length> ] [ halign <alignment> ] [ valign <alignment> ] [ with color <color> ]
text 'Hello World!' at 0,2
would render the text ‘Hello World!’ at position , measured in centimeters. The alignment of the text item with respect to this position can be set using the set texthalign and set textvalign commands, or using the halign and valign modifiers supplied to the text command itself.
A gap may be specified, which should either have dimensions of length, or be dimensionless, in which case it is interpreted as being measured in centimeters. If a gap is specified, then the text string is slightly displaced from the specified position, in the direction in which it is being aligned.
A rotation angle may optionally be specified after the keyword rotate to produce text rotated to any arbitrary angle, measured in degrees counter-clockwise. The following example would produce upward-running text:
text 'Hello' at 1.5, 3.6 rotate 90
By default the text is black; however, an arbitrary color may be specified using the with color modifier. For example:
text 'A purple label' at 0, 0 with color purple
would add a purple label at the origin of the multiplot.
Outside of multiplot mode, the text command can be used to produce images consisting simply of one single text item. This can be useful for importing latexed equations as gif images into slideshow programs such as Microsoft Powerpoint which are incapable of producing such neat mathematical notation by themselves.
All vector graphics objects placed on multiplot canvases receive unique identification numbers which count sequentially from one, and which may be listed using the list command. By reference to these numbers, they can be deleted and subsequently restored with the delete and undelete commands respectively.