an open-source digital signal processing and sound synthesis language
about · links · contact
plottable - generate a graphics plot of the contents of a table given an associated table-handle variable


Synopsis

plottable(table_handle[, pause][, "gnuplot_cmd1", "gnuplot_cmd2", ... ])

Parameters inside the [brackets] are optional.


Description

plottable is a useful utility that will create a graphics plot of a table associated with a particular table-handle. The plot appears in a separate window, and uses the public-domain gnuplot program. Macintosh OS X users will also need to have the public-domain aquaterm package installed for gnuplot to run correctly.


Arguments

table_handle
The table-handle identifier for the table to be plotted.

pause
The length of time (in seconds) to display the plot before proceeding with scorefile processing. The default is 10 seconds.
    NOTE: Under MacOS X, using Aquaterm to display the output pause has no effect. Also, you can only do one plot per run of RTcmix under OS X, because gnuplot dies if there's already another one running.

gnuplot_cmd1, ... gnuplot_cmdN
These optional string arguments are plotting commands that gnuplot may use to modify the generated graph. See the gnuplot documentation for more information about these commands. The default is "with lines".

If something goes wrong with the gnuplot syntax, there'll be some leftover files in the /tmp directory, with names like "rtcmix_plot_data_xAb5x8."


Examples

   table = maketable("wave", 1000, 1, 0.1, 0.3)
   plottable(table, 30)

The above score will produce the following plot in a separate window (it will appear for 30 seconds on non MacOS X systems):



This scorefile:
   table = maketable("wave", 1000, 1, 0.1, 0.3)
   plottable(table, 15, "with points")
will produce this plot:



and display it for 15 seconds (on non MacOS X systems). The following scorefile:
   table = maketable("wave", 1000, 1, 0.1, 0.3)
   plottable(table, "with impulses")
generates this kind of plot:




See Also

dumptable, maketable, makeconverter, makefilter, modtable, tablelen, samptable