For example the command
quickplot file0.txt file1.wav file2.csv file3.dat
will make four graphs in four tabs in one main window.
The command
quickplot file0.txt file1.wav file2.csv --new-window file3.dat --no-new-window
will make two windows with two graphs in each window. You see: file1.wav will be forced to be graphed when the parser hits the argument file2.csv, and file2.csv will be forced to be graphed when the parser hits the file3.dat argument, at which time the --new-window is in effect which causes a new window to be used for file2.csv. file3.dat will be graphed in the same window as file2.csv because the --new-window option is not longer in effect when file3.dat is forced to be graphed at the end of the command line.
The command
quickplot load1.txt --no-grid --no-lines load2.txt --lines=y --line-width=9 -F
will make a graph from data in file load1.txt with no connecting lines and no grid. It will make a graph from the data in load2.txt with lines with width 9 pixels and no grid. The main window displayed will not be full screen since the -F option was given after the main window would have been created. The two graphs will be in two different tab pages in the one main window.
The command
quickplot --fullscreen --no-gui load1.txt --default-graph --gui --no-buttons --no-fullscreen --geometry=400x400-0+0 --new-window --graph "0 1" --geometry=400x400+0-0 load2.txt --background-color='rgba(140,140,200,0.6)' --cairo-draw
will make main window with a graph in full screen without GUIs, another smaller main window with the same plot in the top right corner with GUIs except for the buttons bar, and another small main window in the bottom left corner with a default graph of the file load2.txt drawn with Cairo with a translucent blueish gray background. The main windows are made when they have to be, which at the --default-graph, --graph "0 1", and at the end of the command line when for the default graph of the file load2.txt must be displayed. Notice all the graphs are made in a new main window. That's because the --new-window flag was set and is not unset as it could be with the --no-new-window command.
The command
echo -e "graph zoom 2 1 -.5 0\ninput `tty`\n" | quickplot /usr/share/tuxpaint/sounds/areyousure.wav --shell --no-gui --no-pipe
will graph the tuxpaint areyousure.wav file with the view zoomed to the right half of the graph. If you ran this from a bash (or tcsh) shell with a tty, Quickplot program will connect a Quickplot shell to the tty and give you an interactive Quickplot shell after running the input tty command. The --no-pipe option keeps Quickplot from reading the standard input as graph data so that it can be read by the Quickplot shell. The Quickplot shell will be started after all the command line arguments are applied, so the shell command graph zoom 2 1 -.5 0 is applied to the graph that is showing after the all the command line arguments are processed. Type help at the Quickplot shell prompt. If you would like Quickplot to save your Quickplot shell history between sessions just create a .quickplot_history in your home directory with a command like `touch ~/.quickplot_history'.
The following GTK+ options are parsed by the GTK+ APIs (application programming interfaces), which Quickplot uses:
--class=CLASS | Program class as used by the window manager |
--display=DISPLAY | X display to use |
--g-fatal-warnings | Make all warnings fatal |
--gdk-debug=FLAGS | Gdk debugging flags to set |
--gdk-no-debug=FLAGS | Gdk debugging flags to unset |
--gtk-debug=FLAGS | Gtk+ debugging flags to set |
--gtk-module=MODULE | Load an additional Gtk module |
--gtk-no-debug=FLAGS | Gtk+ debugging flags to unset |
--gxid-host=HOST | |
--gxid-port=PORT | |
--name=NAME | Program name as used by the window manager |
--screen=SCREEN | X screen to use |
--sync | Make X calls synchronous |
Quickplot has GUIs for all of the following immutable keyboard short-cuts:
a | show information about Quickplot using a web browser |
b | show/hide the button bar |
c | copies the current focused main window so long as it is not maximized or in fullscreen |
d | delete the main window. This will not close the last main window. |
e | toggles the visibility of the main window border |
f | toggles full screen viewing |
g | show/hide the graph detail widget |
h | show help using a web browser |
i | save a PNG image of the graph |
m | show/hide the menu bar or do nothing if there is a globel menu bar |
n | make a new graph |
o | open a data file |
q | quit |
r | toggles the between drawing with Cairo and X11 |
s | show/hide of the status bar |
t | show/hide of the graph tabs |
u | show/hide of all GUIs |
w | makes a new main window |
x | toggles the X11 shape extension on and off |
z | zoom out one level |
Z | Zoom out all the way |
esc | close the current focused window. This will not close the last main window. If the current focused window is in full screen this will change it to non-full screen. |
left/right arrow | the right and left arrow keys cycle though graph tabs when the buttons and tabs are not showing |