# plptex3(3plplot) [debian man page]

PLPTEX3(3plplot) PLplot API PLPTEX3(3plplot)NAME

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

plptex3(x, y, z, 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 bound- aries. 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. Redacted form: plptex3(x, y, z, dx, dy, dz, sx, sy, sz, just, text) This function is used in example 28.ARGUMENTS

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 par- allel 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.AUTHORS

Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was automatically generated from the DocBook source of the PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere.SEE ALSO

PLplot documentation at http://plplot.sourceforge.net/resources. August, 2012 PLPTEX3(3plplot)

## Check Out this Related Man Page

PLVECT(3plplot) PLplot API PLVECT(3plplot)NAME

plvect - Vector plotSYNOPSIS

plvect(u, v, nx, ny, scale, pltr, pltr_data)DESCRIPTION

Draws a vector plot of the vector (u[nx][ny],v[nx][ny]). The scaling factor for the vectors is given by scale. A transformation routine pointed to by pltr with a pointer pltr_data for additional data required by the transformation routine is used to map indices within the array to the world coordinates. The style of the vector arrow may be set using plsvect(3plplot). Redacted form: plvect(u, v, scale, pltr, pltr_data) This function is used in example 22.ARGUMENTS

u, v (PLFLT **, input) Pointers to a pair of vectored two-dimensional arrays containing the x and y components of the vector data to be plotted. nx, ny (PLINT, input) Physical dimensions of the arrays u and v. scale (PLFLT, input) Parameter to control the scaling factor of the vectors for plotting. If scale = 0 then the scaling factor is automatically calcu- lated for the data. If scale < 0 then the scaling factor is automatically calculated for the data and then multiplied byIf scale > 0 then the scaling factor is set to scale. pltr (void (*) (PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer) , input) Pointer to function that defines transformation between indices in array z and the world coordinates (C only). Transformation func- tions are provided in the PLplot library: pltr0(3plplot) for identity mapping, and pltr1(3plplot) and pltr2(3plplot) for arbitrary mappings respectively defined by one- and two-dimensional arrays. In addition, user-supplied routines for the transformation can be used as well. Examples of all of these approaches are given in the PLplot documentation. The transformation function should have the form given by any of pltr0(3plplot), pltr1(3plplot), or pltr2(3plplot). pltr_data (PLPointer, input) Extra parameter to help pass information to pltr0(3plplot), pltr1(3plplot), pltr2(3plplot), or whatever routine that is externally supplied.-scale.AUTHORS

Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was automatically generated from the DocBook source of the PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere.SEE ALSO

PLplot documentation at http://plplot.sourceforge.net/resources. August, 2012 PLVECT(3plplot)