Compatible volume files
For the moment, BrainBrowser Navigator works only with Minc 2.0 files but NIfTi is on our roadmap.
User Interface Components
Here is how Navigor looks like when a volume file is loaded:
The windows is split in two parts: the controls on the left and the views on the right, such as:
The View Side
The view itself is composed of four parts:
The same color code is used all across Navigator: blue for the reference projection, green for the projection orthogonal in U (arbitrary) and red for the projection orthogonal in V.
The gimbal, from the volume view, is the device used to navigate easily within the data.
If we have a look at the color code, we realize the reference projection is always coplanar to the blue circle.
Two kinds of controls are available: rotations and translation.
To perform a rotation, the user must grab one of the colord circle and drag it around.
To perform a translation, you must grab the blue/yellow arrow that lays in the middle of the volume and drag it forward/backward to move along the normal vector of the reference plane. To move the arrow within the reference plane, hold SHIFT + click to drag the arrow.
As long as the gimbal is move or rotated, the image projections are updating to the new position.
The three projections are displayed in canvas, this allows some controls like panning using a mouse drag, and zooming using the scroll wheel.
The top left projection is called reference because it is the one mapped on the volume.
View Quick Controls
To each projection is associated a micro toolbox located on its corner:
The up and down arrow icons can be used to jump forward or backward in the volume. The size of the jump is the number from the text field (editable). Keep in mind the jump is performed along the normal vector of the plane, possibly in an oblique direction.
The two lower projections (othogonal U, in green and V, in red) have an option to make them the reference projection. Click on the cube icon and the two concerned projections, as well as the volume, will be swaped and updated accordingly.
The Control Side
Undo & Redo
Needless to precise what this feature is about, still, keep in mind only the position and rotation of the gimbal are taken into consideration for building the history.
Center & Normal
Both are 3D coordinates (x, y, z).
Center is the center of the gimbal, where lays the blue/yellow arrow. The position has to be within the boundaries of the volume.
Normal is the normal vector of the reference plane, in other words, the direction of the blue arrow that lays at the center of the blue circle of the gimbal. This vector is supposed to be normalized but if you set a vector with a norm greater than 1, the normalization process will be done internally.
Two Points Section
A two points section allows to move along a segment defined by two points. A practical case is an AC-PC section. The reference projection will be orthogonal to this segment and the blue arrow will be along this segment.
To place the the first point (P1), move the gimbal (by dragging or using the center from the above section), and click on P1. Repeat the procedure for P2 and click on update to setup the section.
Write an angle (in degrees), pick an axis and press Update. Note that the rotation is relative to the current state and the center of rotation is alway the center of the gimbal (center of the double blue/yello arrow). The x rotation is around the red circle, y rotation is around the green circle and z rotation is around the blue circle.
Bookmark Current Settings
Bookmarking is a way to keep in memory the current position and orientation of the gimbal and thus, the related projections.
To add a bookmark, you just need to give it a name.
For the moment, bookmarks are not persistent un the browser, meaning if you refresh the page, bookmarks will be lost. (this feature is on our roadmap)
The whole point of bookmarking a gimbal setting is to be able to retrieve it. Select an item from the drop-down menu to update the gimbal and the projections.
A bookmark named _original_ is always present. It restores the original settings and act like a reset button.
This simple feature makes the gimbal invisible in order to show only the data and let the user interact with volume in a more handy way (no risk to grab a cirle when just trying to rotate the view).