>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  TEXTPLOT

TEXTPLOT

TEXTPLOT

Name


      TEXTPLOT

Purpose


      Plot text with 2-d alignment. Also return bounding box.

Category


Calling Sequence


      textplot, x, y, txt

Inputs


      x,y = Text x,y position. in
      text = text to plot. in

Keyword Parameters


Keywords


        /ANTI means use antialiased text. Slow but looks better.
        CHARSIZE=character size (def=1).
        COLOR=clr Text color (may be 1-d array).
          If not given defaults to !p.color first time. If you
          switch to PS color you may have to set to non-white.
        BOLD=bld Text bold value (=CHARSIZE. may be 1-d array).
        SHIFT=shft Shift between colors (for drop shadows).
        PIXELS=p number of pixels to use for each shift (def=1).
          For hardcopy try 5 or 10.
          SHIFT and PIXELS do not apply if /ANTI used.
        ORIENTATION=ang Text angle CCW from horizontal (deg).
        ALIGNMENT=fx or [fx,fy] Text alignment as fraction of
          text size in x or x and y relative to x,y
          (def=lower left corner = [0,0]).
        OFFSET=off Along text offset in characters (def=0).
          Useful with alignment fx=0 and off=1 to offset 1 char.
        /DEVICE,/NORMAL,/DATA coordinate system to use (def=DATA).
        TXDEV=tx, TYDEV=ty Returned lower left corner of plotted
          text in device coordinates.
        DX=dx, DY=dy Returned width and height of text in pixels.
        DM=dm returned width of one character in pixel.
          These 5 keywords are useful in building a plot legend.
        MARGIN=mar Expand bounding box by margin (pixels, def=0).
        FACTOR=fact Text height factor (def=1) for current font.
          This factor is applied to bounding box height.
        BOX=bclr Set bounding box color (-1 for none).
        FILL=fclr Set bounding box fill color (-1 for none).
        /TEST plot bounding box and reference point.
        /SET save any given keyword values for future calls.
        HREF=href Give a URL to be used in an image map when
          clicking inside the bounding box. Def=none.
        CODE=code Returned image map code if given a non-null
          URL.
        FRONT_CODE=front HTML code for the image and start of
          the image map.
        TAIL_CODE=tail HTML code to terminate the image map.
        IMAGE=img Name of image map image (def=IMAGE).
        XCROP=[x1,x2] Min and Max image pixels to keep in X.
        YCROP=[y1,y2] Min and Max image pixels to keep in Y.
        XBOX=bx, YBOX=by returned bounding box (device). Useful
          for avoiding crowded labels.
        /NOPLOT do not plot text (useful for just finding size).

Outputs


Common Blocks


      textplot_com

Notes


Modification History


      R. Sterner, 2000 Nov 13
      R. Sterner, 2001 May 11 --- Made /DATA default system.
      R. Sterner, 2002 Jan 07 --- Returned bounding box.
      R. Sterner, 2002 Feb 10 --- Added /NOPLOT.
      R. Sterner, 2002 Feb 21 --- Added OFFSET=off
      R. Sterner, 2002 Jul 26 --- Added /ANTI.
      R. Sterner, 2008 Feb 21 --- Added NOCLIP=noclip.
      R. Sterner, 2008 Feb 26 --- Added TXDEV, TYDEV, DX, DY, DM.
      R. Sterner, 2010 May 04 --- Converted arrays from () to [].
  Copyright (C) 2000, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us