AUTOGRAPH Labels

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 $-100$.

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 $-200$) 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.