Back|Forward

DCL:GRPH2:U[XYZ]PACK: Cartesian Coordinate Axis Routines: Explanation of Subroutines: Lower-Level Applications (LLA)

3.8.3 uxplbl/uyplbl

1.
Function
Draws labels specified by text.
2.
Call
NumRu::DCL.uxplbl(cside,islct,ux,ch,nc)
NumRu::DCL.uyplbl(cside,islct,uy,ch,nc)
3.
Explantion of Parameters
cside (C*1) Specifies the position of the axis on which to draw the label. (See Section 3.2.)
islct (I) Specifies the attributes of the label to be drawn. (See Section 3.4.)
ux, uy (R) An array of length n containing the positions to draw the labels (specified in values in UC).
ch (C*(NC)) A character-type array of length n with character length nc  containing the labels to draw.
nc (I) The character length of array ch.
n (I) The length of array ux, uy, ch.
4.
Notes
(a)
In this package, there are two ways to draw labels. They are, in UXPLBL/UYPLBL, 
  • draw label CH(i) at position UX(i)/UY(i).
  • draw label CH(i) in between the positions  UX(i)/UY(i) and UX(i+1)/UY(i+1).
The internal variable 'LBTWN' specifies which of these two is selected. When 'LBTWN' is .true., the labels are drawn in between, and when .false., are drawn on the position. (The initial value is .false..) However, even when a label is specified to be drawn in between, it is not drawn when it is larger than the space between the two points. No message is printed.
(b)
The character height of the label is specified by the internal variable 'RSIZELi'.
(c)
The angle of rotation of the label text is specified by the internal variable 'IROTLzs'.
(d)
The centering option of the label text is specified by the internal variable 'ICENTzs'.
(e)
The line index of the line for the characters in the label is specified by the internal variable 'INDEXLi'.
(f)
The character length of the text CH(i) is specified by lenc (see CHRLIB in the user's manual for "MATH1"). In other words, all trailing blanks will be ignored.
(g)
When a parameter besides 'U' is specified as CSIDE, the labels are always drawn on the outside of the window. When 'U' is specified as cside, the side of the axis the labels are drawn is specified by the internal variable 'IFLAG'. When 'IFLAG' is positive, the labels are drawn above the axis for uxplbl and on the right for , uyplbl.  When 'IFLAG' is negative, the labels are drawn on the opposite sides. The initial value is -1.
(h)
The distance between the label to be drawn and the last axis component drawn is specified by the internal variable 'PAD1'. The initial value is 0.7, when the height of the label to be drawn is 1.