VolEditor | User’s Guide

Last Updated: April 04, 2007

For questions and comments, contact:

Loading and Saving | Background Color | Navigation Controls | Painting | Brush Style and Size

Erasing and Restoring | Mouse Controls in Painting Mode | Clipping Planes| Segments | Render Options

1. Loading and Saving Datasets

In the Loading tab, click on the Load button. Navigate to the desired .uff file and click Open. The dataset will load into the main window of VolEditor.

To save the file click on the Save button. The file will be saved in .uff format.

2. Background Color

In the Loading tab, choose between Solid or Gradient.

When Solid is selected, click on the Background button to bring up the color palatte. Choose the desired color and click ok.

When Gradient is selected, click on the Top and Bottom button to choose the desired colors..

Noise Removal

This option will remove excess or floating voxels around the main dataset. The numbers on the slider decide the tolerance of the removal.

Taking a Screen Shot

To save a single image of the work window, click on the Take Picture option. The image will be saved in .png format.


3. Mouse Controls for Navigation

• LMB = Left Mouse Button
• RMB = Right Mouse Button
• MMB = Middle Mouse Button

• LMB and drag to rotate the image.
• MMB and drag for panning the image in any direction.
• RMB and drag for zooming in and out. To zoom in RMB drag down. To zoom out RMB drag up.
• RMB towards the left and right of the screen will rotate the image in z-axis.

Note: The mouse controls have different functions when Painting Mode is active.

4.1 Painting

Paint By Tool: Click on the color box next to this option to bring up the color palate. Select any color and click OK. LMB and drag on the image to paint the surface of the image.

Paint By Segment: This option allows you to continue working on a previously painted segment.

4.2 Changing the Brush Style and Size

Click on the dropdown menu under the Tool Style and Size section of the Painting Tab. Choose from the various styles available. Change the brush size by moving the slider under the styles menu. Following styles are available:
Point: Paints one voxel at a time.
Square: Paints an area on the surface of the data within a specified boundry.
Circle: Paints an area on the surface of the data within a specified radius.
Box: Paints an area on the data within the 3D volume of the box not just on the surface.
Sphere: Paints an area on the data within the 3D volume of the sphere.

4.3 Picking Color

You can pick a color from the painted area using the Grab Color option. Click on the box next to the Grab Color option and then click on the desired color painted on the surface of the dataset.

4.4 Erasing and Restoring

Remove Voxels: Erase By Tool:
This will erase the 3D data from the area that's being painted.

Painted data of a specific segment can also be erased through the
Remove Segment option in the segments tab.

Click on Restore Original button and use LMB to drag over the painted area to restore original color of the data.
Restore By Tool: Restores original color of the data (LMB) when the option is selected.

4.6 Mouse Controls in the Painting Mode

• LMB = Left Mouse Button
• RMB = Right Mouse Button
• MMB = Middle Mouse Button

When the Paint button is active,
• LMB will paint the surface
• RMB will restore original color of the data (without activating the Restore Original button)
• MMB will rotate the data.
To be able to go back to the original mouse controls for navigation you can click on the Manipulate button.
5. Using Clipping Planes

Under the Clipping Plane tab, click on the check box for Enable to activate this mode. Choose the axis and move the slider to section the dataset.

X, Y and Z axis will clip the image in those respective axes as set in the original orientation of the dataset. The View axis is a plane parallel to the frame of reference and is independant of the orientation of the dataset. Use Manipulate to orient the data to desired angle for sectioning.
For any of the available axes the Invert button reverses the direction in which the clipping plane operates.

Arrow keys on the keyboard can also be used to move the clipping plane forward and back.

6. Segments

Naming segments allows you to apply identities to painted areas. As you start painting over an area, automatically a segment is created which has a default name, an ID and a color.

Segments can be added, edited or removed through the options provided under the segments tab. Removing a segment will restore the painted area of that segment to default color of the dataset. It will not remove the voxels of that segment.

Segments can also be imported from other files by clicking on the Import Button.

To view only a particular segment and hide the rest of the dataset, select the segment and enable the Toggle Showing Only Segments option.

7. Render Options

The number of samples on the slider determine the resolution of the dataset. Increasing the number of samples smoothes the image at the same time slows down the rendering time.

Render Types enables you to view the dataset in different shading conditions such as Depth, Lambertian, Light or Default shading.

Back to Top