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.
The name to be used as the GUI window title.
A Rect providing coordinates for the GUI location.
Plots are line-plots by default. Set this to
The number of interleaved channels that an array represents. For Buffers this argument is not available, since it's filled in automatically.
Minimum value(s) for the display range. For a Buffer this defaults to
Maximum value(s) for the display range. For a Buffer this defaults to
When finding the right display range in multi channel plots, do this together for all or keep them separate.
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.
By default labels appear at the top left of the plot giving a data readout based on mouse position. Set this argument to
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,
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.