use.legacy.graphics(use=NULL)
use
is
NULL
the current setting of this
flag is returned. Otherwise, the setting before the value was changed
is returned.
In S-PLUS 8 much of the low-level Ratfor and S version 2 interface
code was rewritten in C, and enhancements made in a variety of areas.
Enhancements include: a) global palette and image palette; b) separate
col arguments for different graph elements such as col.main; c)
ability to specify colors as a string "red" or "#FF0000"; d) additional
vectorized parameters such as
col
in
plot
.
One known change in default behavior is that previously this command
would create a plot in which all elements are blue:
plot(1:10,col=2)
. Now only the points are blue. While
this is the desired behavior in most cases, users may conceivably want
to revert to the old behavior.
As this was a substantial code change, other currently unknown inconsistencies may be present. Hence a setting was added that controls whether the S code calls the new C code, or calls the same code as was called in previous releases. It is anticipated that users will only take advantage of this if they experience problems with the new graphics code, and that this setting will become obsolete as any problems are identified and fixed.
This is an application-level setting that cannot be changed while
devices exist. If any devices are open and
use
is
specified, the function will stop with an error message.
Note that a separate setting is available for users interested in taking
advantage of the new code while still using device-specific palettes. See
the function
use.device.palette
for details.
# Set the flag to use the older graphics code use.legacy.graphics(T)