To set up one of the four predefined AUTOGRAPH labels (see §2.30 et seq. in the AUTOGRAPH document), the following call may be used:
CALL SNX_AGLAB( LNAME, TEXT )
LNAME and TEXT are both character strings. The first character of LNAME is the label name (`R', `L', `B' or `T' for right, left, bottom, top respectively) and TEXT is the label text. Trailing blanks are ignored so that the text proper is correctly centred - for deliberate trailing blanks, use `$' as an endmark. Also, PWRITX function codes can be inserted for special characters (see § and §). For LNAME `T' or `L', the AUTOGRAPH line number is set to 100; for `B' or `R', the line number is .
Illegal LNAME values cause the top label to be set to
'*** AGLAB LABEL ERROR ***'.
The SNX_AGLAB routine can be used in conjunction with the AUTOGRAPH facilities. For example, the following calls will create a 2-line `B' label (beneath the x-axis), with the second line (numbered ) of character height 0.03 grid units. Here, one grid unit is the height of the box within which the curve is plotted.
CALL SNX_AGLAB( 'B', 'This is the first line of text' ) CALL AGSETC( 'LABEL/NAME.', 'B' ) CALL AGSETI( 'LINE/NUMBER.', -200 ) CALL AGSETF( 'LINE/CHARACTER.', 0.03 ) CALL AGSETC( 'LINE/TEXT.', 'This is the second line of text' )
It is permissible to omit the AGSETC call which specifies the `B' label as this will have been done already by SNX_AGLAB.
SNX --- Starlink Extensions to the NCAR Graphics Utilities