CAVERNUS

Crumbs

Controls:

In the bin directory...
1) run 'vss' to start the sound server
2) run 'Crumbs filename' where filename is an MRC dataset file. Two example datasets are in the data directory.

So try 'Crumbs ../data/sperm.mrc' to run this.
Or, if you're not on a CAVE or immersadesk, try the command
'Crumbs -simulator y -displaymode mono ../data/sperm.mrc'.
This will bring the program up in simulator mode.

Basic use:
Right wand button: brings up menus.
Middle wand button: 2 uses (programable by the menus)

1) Marking points - placing 'crumbs' into the volume

2) Scaling - making the data larger or smaller. Press down and hold the middle button. If you point toward the ceiling, the data volume gets bigger. If you point toward the floor, it gets smaller.

Wand joystick: this will rotate the data volume about it's center.

Toolbox: There are 3 tools on the left. They consist of:

1) the colormap - the sliders on this (moved when the colormap is highlighted and you press the middle button) provide contrast enhancement

2) the "clearbox" icon - press the left button when this icon is highlighted and you'll get an instance of a volume rendering box. The resolution of the box is set ahead of time with menus that are activated with the right button when the icon is highlighted and you press the right button.

3) the "slice plane" icon - works the same as the clearbox icon, but it brings up one 2D slice plane upon a left button push instead of a volume rendering box.

Menu items:
Middle Button - Program the middle wand button to either mark points or scale (zoom) the dataset.

Color Map - Use this submenu to control color map editing. Submenus include:

Edit Colormap:
Brings up a cube which represents RGB space with a spline curve. The curve represents the linear range data value range (0 -> 255) and has 7 nodes which can be moved with the middle buttons.

Edit Opacity:
Brings up a 2D graph. The x-axis is data value range (0->255). The y-axis is alpha value (0->1).

Reset Gray:
Reset a straight grayscale linear colormap and a ramp from (0,0) to (255,1) in opacity.

Save Colormap:

Load Colormap:

These functions write the colormap information to a file called "filename.lut". A 'save' request will overwrite that file.

Toggle Grid - An old testing grid. It has no bearing to any physical dimensions.

Toggle Low Res VR - Turns on a 32x32x32 resolution volume rendering of the entire data volume.

Wand Type - The wand can be a sword (default) or a slice plane. The hot spot on the slice plane is the middle of the front image.

Crumbs - This submenu allows some Crumbs bookkeeping.

Arclength: The computer will tell you the current arclength of the crumbs curve. It also writes the value to the window.

Toggle Crumbs: Keeps the crumbs list in memory. This selection just determines if they're visible or not.

Load Crumbs: Reads in points from disk file "filename.pts.bin"

Clear Crumbs: Removes all crumbs points from memory

Save Crumbs: Writes points to disk file "filename.pts.bin". This will overwrite any existing file named that.. so beware!

Reset - The transform matrix for the dataset (pink box) occasionally gets corrupted. You'll notice it going off into hyper - space whenever you push the left button. This menu item resets that matrix to the identity.

back to CAVERNUS