Next: , Previous: , Up: High-Level Plotting   [Contents][Index]

15.2.8 Use of the interpreter Property

All text objects—such as titles, labels, legends, and text—include the property "interpreter" that determines the manner in which special control sequences in the text are rendered.

The interpreter property can take three values: "none", "tex", "latex". If the interpreter is set to "none" then no special rendering occurs—the displayed text is a verbatim copy of the specified text. Currently, the "latex" interpreter is not implemented and is equivalent to "none".

The "tex" option implements a subset of TeX functionality when rendering text. This allows the insertion of special glyphs such as Greek characters or mathematical symbols. Special characters are inserted by using a backslash (\) character followed by a code, as shown in Table 15.1.

Note that for on-screen display the interpreter property is honored by all graphics toolkits. However for printing, only the "gnuplot" toolkit renders TeX instructions.

Besides special glyphs, the formatting of the text can be changed within the string by using the codes

\bfBold font
\itItalic font
\slOblique Font
\rmNormal font

These codes may be used in conjunction with the { and } characters to limit the change to a part of the string. For example,

xlabel ('{\bf H} = a {\bf V}')

where the character 'a' will not appear in bold font. Note that to avoid having Octave interpret the backslash character in the strings, the strings themselves should be in single quotes.

It is also possible to change the fontname and size within the text

\fontname{fontname}Specify the font to use
\fontsize{size}Specify the size of the font to use

The color of the text may also be changed inline using either a string (e.g., "red") or numerically with a Red-Green-Blue (RGB) specification (.e.g., [1 0 0], also red).

\color{color}Specify the color as a string
\color[rgb]{R G B}Specify the color numerically

Finally, superscripting and subscripting can be controlled with the '^' and '_' characters. If the '^' or '_' is followed by a { character, then all of the block surrounded by the { } pair is superscripted or subscripted. Without the { } pair, only the character immediately following the '^' or '_' is changed.

Greek Lowercase Letters
Greek Uppercase Letters
Misc Symbols Type Ord
“Large” Operators
Binary Operators
Openings and Closings
Alternate Names

Table 15.1: Available special characters in TeX mode

A complete example showing the capabilities of the extended text is

x = 0:0.01:3;
plot (x, erf (x));
hold on;
plot (x,x,"r");
axis ([0, 3, 0, 1]);
text (0.65, 0.6175, strcat ('\leftarrow x = {2/\surd\pi',
' {\fontsize{16}\int_{\fontsize{8}0}^{\fontsize{8}x}}',
' e^{-t^2} dt} = 0.6175'))

The result of which can be seen in Figure 15.7


Figure 15.7: Example of inclusion of text with the TeX interpreter

Next: , Previous: , Up: High-Level Plotting   [Contents][Index]