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

# plptex3(3plplot)

Write text inside the viewport of a 3D plot

## NAME

**plptex3** - Write text inside the viewport of a 3D plot

## SYNOPSIS

**plptex3**(*wx*, *wy*, *wz*, *dx*, *dy*, *dz*, *sx*, *sy*, *sz*, *just*, *text*)

## DESCRIPTION

Writes text at a specified position and inclination and with a specified shear within the viewport.  Text is clipped at the viewport 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 reference point is placed at world coordinates (*wx*, *wy*, *wz*)  within the viewport. The inclination and shear of the string is specified in terms of differences of world coordinates making it easy to write text parallel to a line in a graph.

Redacted form: **plptex3(x, y, z, dx, dy, dz, sx, sy, sz, just, text)**

This function is used in example 28.

## ARGUMENTS

- *wx* (**PLFLT**(3plplot), input)

  x world coordinate of reference point of string.

- *wy* (**PLFLT**(3plplot), input)

  y world coordinate of reference point of string.

- *wz* (**PLFLT**(3plplot), input)

  z world coordinate of reference point of string.

- *dx* (**PLFLT**(3plplot), input)

  Together with *dy* and *dz* , this specifies the inclination of the string.  The baseline of the string is parallel to a line joining (*x*, *y*, *z*)  to (*x*+*dx*, *y*+*dy*, *z*+*dz*) .

- *dy* (**PLFLT**(3plplot), input)

  Together with *dx* and *dz*, this specifies the inclination of the string.

- *dz* (**PLFLT**(3plplot), input)

  Together with *dx* and *dy*, this specifies the inclination of the string.

- *sx* (**PLFLT**(3plplot), input)

  Together with *sy* and *sz* , this specifies the shear of the string.  The string is sheared so that the characters are vertically parallel to a line joining (*x*, *y*, *z*)  to (*x*+*sx*, *y*+*sy*, *z*+*sz*) . If *sx* = *sy* = *sz* = 0.)  then the text is not sheared.

- *sy* (**PLFLT**(3plplot), input)

  Together with *sx* and *sz*, this specifies shear of the string.

- *sz* (**PLFLT**(3plplot), input)

  Together with *sx* and *sy*, this specifies shear of the string.

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