ncl_pwrzs man page

PWRZS — A character-plotting routine for plotting characters in three-space when using SRFACE.

Synopsis

CALL PWRZS (X,Y,Z,ID,N,ISIZE,LINE,ITOP,ICNT)

C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_pwrzs (float x, float y, float z, char *id,
int n, int isize, int line, int itop, int icnt)

Description

X,Y,Z
Positioning coordinates for the characters to be drawn. These are floating point numbers in the same three-space as used in SRFACE.
ID
Character string to be drawn. ID is of type CHARACTER.
N
The number of characters in ID.
ISIZE

Size of the character:

·
If between 0 and 3, ISIZE is 1., 1.5, 2., or 3. times a standard width equal to 1/128th of the screen width.
·
If greater than 3, ISIZE is the character width in plotter address units.
LINE
The direction in which the characters are to be written.

1 = +X -1 = -X
2 = +Y -2 = -Y
3 = +Z -3 = -Z
ITOP
The direction from the center of the first character to the top of the first character (the potential values for ITOP are the same as those for LINE as given above). Note that LINE cannot equal ITOP even in absolute value.
ICNT

Centering option.

-1 (X,Y,Z)
is the center of the left edge of the first character.
0 (X,Y,Z)
is the center of the entire string.
1 (X,Y,Z)
is the center of the right edge of the last character.

Note that the hidden character problem is solved correctly for characters near, but not inside, the three-space object.

C-Binding Description

The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

Usage

Call PWRZS after calling SRFACE and before calling FRAME.

Examples

Use the ncargex command to see the following relevant examples: fsrpwrzs, tpwrzs.

Access

To use PWRZS or c_pwrzs, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

See Also

Online: surface, surface_params, ezsrfc, setr, srface. ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

Info

March 1993 UNIX NCAR GRAPHICS