---
name: "plmtex"
section: "3plplot"
platform: "linux"
package: "plplot-doc"
version: "5.15.0+dfsg2-15"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/plmtex"
---

# plmtex(3plplot)

Write text relative to viewport boundaries

## NAME

**plmtex** - Write text relative to viewport boundaries

## SYNOPSIS

**plmtex**(*side*, *disp*, *pos*, *just*, *text*)

## DESCRIPTION

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*.

Redacted form: General: **plmtex(side, disp, pos, just, text)**

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

## ARGUMENTS

- *side* (**PLCHAR\_VECTOR**(3plplot), 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**(3plplot), 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**(3plplot), input)

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

- *just* (**PLFLT**(3plplot), 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**(3plplot), input)

  A UTF-8 character string to be written out.

## AUTHORS

Many developers (who are credited at http://plplot.org/credits.php) have contributed to PLplot over its long history.

## SEE ALSO

PLplot documentation at http://plplot.org/documentation.php.