Next: alltrue() Up: MacAnova Help File Previous: addpoints()   Contents


addstrings([Graph,] x,y, strings:charVec,[, graphics keyword phrases])
addstrings([Graph,] [x,y, strings:charVec],keys:str), str a structure
  whose component names are graphics keywords

Keywords: plotting
addstrings(x,y,strings:charVec) displays the plot in LASTPLOT and then
writes the i-th element of CHARACTER vector charVec at position (x[i],
y[i]), updating LASTPLOT to include the new information.  It is
completely equivalent to stringplot(x,y,strings:charVec,add:T).

It is not an error when x or y is NULL; a warning message is printed and
no plotting occurs.

For backward compatibility with earlier versions, keyword 'strings' can
be omitted (addstrings(x,y,charVec)).

When option 'dumbplot' has been set False (see subtopic
'options:"dumbplot"'), the plot will be a low resolution plot unless
'dumb:F' is an argument.

addstrings(Graph,x,y,strings:charVec), displays GRAPH variable Graph,
adding the string or strings in charVec, and saves the modified plot in
LASTPLOT.  Graph is not changed (unless it is LASTPLOT).

In contrast with other plotting commands, non-NULL x and y must both be
vectors of the same length.  The most usual use is when both x and y are
REAL scalars and charVec is a quoted string or CHARACTER scalar to be
written at coordinates (x,y).  A typical usage would be
  Cmd> addstrings(110,20,strings:"Frequency 1 cycle/week")).

By default, each string is written centered at (x[i], y[i]).  However,
if 'justify:"l"' or 'justify:"r"' is an argument following charVec, each
string will be left or right justified.

addstrings(x,y,strings:charVec,keep:F) suppresses any change to

addstrings(x,y,strings:charVec,show:F) suppresses immediate display of
the modified graph but updates LASTPLOT.  This is useful when you are
building a complex graph in stages using addlines(), addchars(),
addpoints(), or addstrings().  When you are done, simply type
showplot().  You can't use both show:F and keep:F.

Keywords 'dumb', 'xmin', 'xmax', 'ymin', 'ymax', 'logx', 'logy', 'xlab',
'ylab', 'title', 'xaxis', 'yaxis', 'borders', 'ticks', 'xticks',
'yticks', 'xticklen', 'yticklen', 'xticklabs', 'yticklabs', 'height',
'width', 'pause', 'silent' and 'notes' may be used as for other plotting
commands.  See topics 'graph_keys', 'graph_border' and 'graph_keys'.
Keywords 'impulse' and 'lines' are ignored.

addstrings([Graph,] keys:structure(x:x,y:y,strings:charVec [other
keyword phrases)) is equivalent to addstrings([Graph,] x:x,y:y,
strings:charVec [other keyword phrases]).  See topic 'graph_keys' for

A value of MISSING for any of xmin, xmax, ymin or ymax (for example,
xmin:?) forces determination of a value from the current data and data
already in the graph.

New labels and title may be set only by keywords 'xlab', 'ylab' and

addstrings(x,y,strings:s,add:F, ...) is equivalent to stringplot(x,y,
strings:s, ...).

See topic 'graphs' for general information on plots and on variable
LASTPLOT.  See topic 'graph_keys' for information on keywords.  See
topic 'graph_files' for information on writing a graph to a file.

Gary Oehlert 2003-01-15