The plot method provides the ability to plot data in a GUI window. The method is implemented in the ArrayedCollection class but is also available for other classes for convenience, including Function, Bus, Env, Buffer, SoundFile, Wavetable.
All arguments are optional.
name |
The name to be used as the GUI window title. |
bounds |
A Rect providing coordinates for the GUI location. |
discrete |
Plots are line-plots by default. Set this to |
numChannels |
The number of interleaved channels that an array represents. For Buffers this argument is not available, since it's filled in automatically. |
minval |
Minimum value(s) for the display range. For a Buffer this defaults to |
maxval |
Maximum value(s) for the display range. For a Buffer this defaults to |
separately |
When finding the right display range in multi channel plots, do this together for all or keep them separate. |
parent |
By default the plot is placed in a new GUI window. This argument can be used to specify an existing GUI container to send the plot to. |
labels |
By default labels appear at the top left of the plot giving a data readout based on mouse position. Set this argument to |
If minval
and/or maxval
are set to nil
(this is default, except for Buffers), they will be automatically calculated from the dataset minimum and/or maximum. For multi-channel data, minval
and maxval
may be arrays, specifying the range independently for each channel (including use of nil
, in which case the min/max will be calculated for the specific channel rather than for the overall dataset). When the receiver contains nil
items, the plot fails with an error.
Hitting the E-key on the keyboard when the window is focussed toggles the lock, and the window can be used to edit the data.