`plmtex`: Write text relative to viewport boundaries
Prev | Chapter 18. The Common API for PLplot | Next

#### `plmtex`: Write text relative to viewport boundaries

`plmtex (` | side ,
| disp ,
| pos ,
| just ,
| text `)`;

Writes text at a specified position relative to the viewport boundaries. Text may be written inside or outside the viewport, but is clipped at the subpage boundaries. The reference point of a string lies along a line passing through the string at half the height of a capital letter. The position of the reference point along this line is determined by ``just`` , and the position of the reference point relative to the viewport is set by ``disp`` and ``pos`` .

`side` (``PLCHAR_VECTOR``, input)

  An ascii character string specifying the side of the viewport along which the text is to be written. The string must be one of:

  - `b`: Bottom of viewport, text written parallel to edge.

  - `bv`: Bottom of viewport, text written at right angles to edge.

  - `l`: Left of viewport, text written parallel to edge.

  - `lv`: Left of viewport, text written at right angles to edge.

  - `r`: Right of viewport, text written parallel to edge.

  - `rv`: Right of viewport, text written at right angles to edge.

  - `t`: Top of viewport, text written parallel to edge.

  - `tv`: Top of viewport, text written at right angles to edge.

`disp` (``PLFLT``, input)

  Position of the reference point of string, measured outwards from the specified viewport edge in units of the current character height. Use negative ``disp`` to write within the viewport.

`pos` (``PLFLT``, input)

  Position of the reference point of string along the specified edge, expressed as a fraction of the length of the edge.

`just` (``PLFLT``, input)

  Specifies the position of the string relative to its reference point. If ``just`=0.` , the reference point is at the left and if ``just`=1.` , it is at the right of the string. Other values of ``just`` give intermediate justifications.

`text` (``PLCHAR_VECTOR``, input)

  A UTF-8 character string to be written out.

Redacted form:

- General: `plmtex(side, disp, pos, just, text)`

- Perl/PDL: `plmtex(disp, pos, just, side, text)`

This function is used in examples 3, 4, 6-8, 11, 12, 14, 18, 23, and 26.

Prev | Up | Next
`plmkstrm`: Creates a new stream and makes it the default | Home | `plmtex3`: Write text relative to viewport boundaries in 3D plots