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.