Previous: plteu Up: ../plot79_p.html Next: pltfm


PLTEX

       SUBROUTINE  PLTEX (TLINES,LOC,LENGTH,WIDTH,HEIGHT)
 C$    (Text String Extent)
 C$    Determine the  plotted extent  of a  (possibly  multi-line)
 C$    text string, but do not actually plot it.  The current CORE
 C$    character positioning and  font attributes  are used.   All
 C$    character attributes and the  current point are  preserved.
 C$
 C$    Successive text lines are drawn underneath each other, with
 C$    their origin displaced along  a vector (DX,DY,DZ) lying  in
 C$    the character plane, perpendicular to the path, and on  the
 C$    opposite  side  of  the  path  from  the  up  vector  (i.e.
 C$    downwards).  With the usual situation that the character up
 C$    vector  is   perpendicular   to  the   path   vector,   the
 C$    displacement will  be along  the negative  up vector.   The
 C$    arguments are:
 C$
 C$    TLINES(*)......Hollerith character string to be drawn.  The
 C$                   special  character  sequence  "$N"  or  "$n"
 C$                   (dollar  N)  in  the  string  represents   a
 C$                   newline,  and   may  be   used  to   request
 C$                   multi-line text.  For example, the string
 C$
 C$                   "title 1$Ntitle 2$ntitle3"
 C$
 C$                   will generate three lines of the form
 C$
 C$                   title 1
 C$                   title 2
 C$                   title 3
 C$
 C$                   In the unlikely event that a $N is  actually
 C$                   needed in the  text, it can  be obtained  by
 C$                   bracketing either character with case switch
 C$                   characters.  With the default <PLOT79>  case
 C$                   switch characters,  this  would be  $<N>  or
 C$                   <$>N.
 C$    LOC............Offset  of  first  character  in  TLINES(*),
 C$                   normally 1.
 C$    LENGTH.........Number of characters  in TLINES(*).  Leading
 C$                   and trailing  blanks in  each line  will  be
 C$                   ignored.
 C$    WIDTH..........Width of the box enclosing all text lines.
 C$    HEIGHT.........Height of the box enclosing all text  lines.
 C$                   This includes interline spacing.
 C$    (18-JAN-83)