brakedancer Files

brakedancer: This is an analog waveform viewer.  Unique to most viewers,
brakedancer allows you to overlay any signals by specifying the signals y
origin point.

BUILDING FROM SOURCE: You need 'gcc' and 'gtk+' development files.  Use 'make
install'

USING: From your source directory, run 'brakedancer bd-test.csv'.
Windows users:  It is easiest to create a shortcut and drag-n-drop a *.csv
file onto the shortcut.  Opening brakedancer.exe by itself without an input
file will simply close right away.

ZOOMING: press 'e' or 'q' to zoom in/out.  scroll your mouse wheel to zoom
in/out.
Shift+Click+Drag (from left to right) to zoom in to selected window.
Shift+Click+Drag (from right to left) to zoom out to previous view.
Shift+RightClick+Drag (from left to right) to zoom x only.
Shift+RightClick+Drag (from right to left) to zoom out to previous view.

PANNING: press 'w', 'a', 's', 'd' to pan.  Think gaming.  WheelClick+Drag to
pan.

SIGNAL NAME HINTS: press 'h' to toggle hints when hints are active: Click+Drag
over a signal to see it's name

TIME HINTS: press 't' to toggle time hint

VALUE HINTS: press 'g' to toggle 'grab mode' on.  select the signals of
interest in the graph window.  press 'g' to toggle 'grab mode' off.  Click+Drag
and see the value hints of the selected signals.  press 'g' to toggle 'grab
mode' on. select an area of the graph not containing a signal to de-select all
signals.  press 'g' to toggle 'grab mode' off.

DATA FILES: brakedancer only works with CL, CSV, and VCD files.

CSV NOTES: The first line of the files is assumed to be the signal names.  The
first column is assumed to be the x axis (usually time).

VCD NOTES: Limited compliance to Verilog specification (mostly due to immature
parser).

CL NOTES: CL is a binary CAN format developed by the HLA Team at Eaton Corp.
In order to decode it, you must have a CAN Database (dbc) file named "bd.dbc" in
the default configuration file location (see below).

CONFIGURATION FILE: This is also a CSV file.  Play with it to change
how/where/if signals are displayed (using Gnumeric or Excel).
It is installed by default at
GNU/Linux: $HOME/.brakedancer/bd-conf.csv
Windows: C:\Documents and Settings\user\My Documents\_brakedancer\bd-conf.csv
Press '1' to reload the configuration file from disk.  This is helpful
for trace layout/setup.  Open the file you want with brakedancer.  Open bd-conf.csv
with your spreadsheet program.  Tweak the configuration in bd-conf.csv.  Save
bd-conf.csv.  Press '1' in brakedancer.  Repeat.

Version History
 * 1.7.3: shift + scroll wheel zooms
 * 1.7.2: scroll wheel only scrolls measurement window
 * 1.7.1: fix missing isFloat setting in import_csv.c
 * 1.7.0: fix vcd import bug, better memory error reporting
 * 1.6.0: data stored as float or unsigned long (previously only float)
 * 1.5.0: remove tree view, replace with custom drawable
 * 1.4.0: File->Open dialog (added Menu Bar)
 * 1.3.0: fix configuration file reloading and measurement auto-sizing
 * 1.2.0: add icon for windows allow import/conversion of *.cl file (using
 *     *.dbc file)