plptex3: Write text inside the viewport of a 3D plot.

The PLplot Plotting Library: Programmer's Reference Manual
Prev | Chapter 17. The Common API for PLplot | Next

### `plptex3`: Write text inside the viewport of a 3D plot.

`plptex3` (x, y, z, dx, dy, dz, sx, sy, sz, just, text);

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 `(`x`, `y`, `z`)` 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.

`x` (`PLFLT`, input) x coordinate of reference point of string. `y` (`PLFLT`, input) y coordinate of reference point of string. `z` (`PLFLT`, input) z coordinate of reference point of string. `dx` (`PLFLT`, 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`, input) Together with ``dx` and `dz``, this specifies the inclination of the string. `dz` (`PLFLT`, input) Together with ``dx` and `dy``, this specifies the inclination of the string. `sx` (`PLFLT`, 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`, input) Together with ``sx` and `sz``, this specifies shear of the string. `sz` (`PLFLT`, input) Together with ``sx` and `sy``, this specifies shear of the string. `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` (`const char *`, input) The string to be written out.

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

This function is used in example 28.

Prev | Home | Next
`plptex`: Write text inside the viewport | Up | `plreplot`: Replays contents of plot buffer to current device/file