## page was renamed from FreeviewGeneralUsage:FreeviewInterface
||Up to FreeviewGuide ||Back to [[FreeviewGuide/FreeviewGeneralUsage/FreeviewQuickStart|FreeviewQuickStart]] ||Continue to [[FreeviewGuide/FreeviewGeneralUsage/FreeviewViewingArea|FreeviewViewingArea]] ||


= Interface =
Freeview consists of one window. In this window there is the main viewing area, to the left is the control panel, at the top is the toolbar, at the bottom are the cursor and mouse coordinates, and if you are in the "Voxel Edit" mode or "Recon Edit" mode, there will be a floating "Drawing" toolbox.

== Display Window ==

{{attachment:new_fv_screenshot.jpg||height="510",width="800"}}

Here's a look at the program. In this instance, the user has chosen the 2x2 viewing option, and can see all 3 planes plus 3D together in one window. In this view, when you move the red crosshair to a point in one window, the view within the other 3 windows will move to the corresponding slice at those coordinates where the crosshair was placed. In the 3D window (bottom right), you can hold down the left mouse button and rotate the volume by dragging it.

Freeview has only one window. This display Window shows the currently displayed slice. Multiple panes can show multiple orientations and configurations. 

Information about the currently displayed data can be obtained by moving the mouse over the Display window or by clicking to set the cursor. As the mouse is moved in the display window, the Cursor/Mouse sections on the bottom will display information about the voxel (or volume element) under the tip of the mouse arrow. 

It is possible to display multiple orientations of data simultaneously in the Display Window. This is done by splitting the window up into multiple viewing panes, each with a different slice, orientation, or other viewing characteristics. The cursor is linked between the panes so that a click in one pane to set the cursor/crosshair will update the cursor in all the other panes. There are four built-in configurations: 1x1, 2x2 (4 equal panes), 1x3 (1 large, and 3 smaller, equal planes on the bottom), and 1x3 horizontal (1 large pane, and 3 smaller, equal planes on the right). These can be activated by clicking on the appropriate icon in the main Toolbar ({{attachment:layout_1x1.gif}}, {{attachment:layout_2x2.gif}}, {{attachment:layout_1n3.gif}}, {{attachment:layout_1n3_h.gif}})

In the latter three views, there is more than one pane in the Display Window. A red border is drawn around the active pane. To make another pane active, click in it to set the cursor. The Mouseover section of the Tools Window will only display information about the voxel under the mouse if it is in the active pane. Moving the crosshair/cursor in one pane will however, move the crosshair in all the other panes accordingly. 

== Toolbar ==
{{attachment:new_toolbar.png}}
|| {{attachment:navigate.gif}} ||Navigate Tool || {{attachment:voxel_edit.gif}} ||Voxel Edit Tool ||
|| {{attachment:ControlPanelIcon.gif}} ||Control Panel On/Off Button || {{attachment:layout_1x1.gif}} ||1x1 Screen View ||
|| {{attachment:roi_edit.png}} ||Edit ROI (in ROI panel) || {{attachment:waypoints_edit.png}} ||Edit Waypoints (in Waypoints Panel) ||
|| {{attachment:edit_undo_16.png}} ||Undo Last Edit || {{attachment:edit_redo_16.png}} ||Redo Last Edit ||
|| {{attachment:layout_2x2.gif}} ||2x2 Screen View || {{attachment:layout_1n3.gif}} ||1x3 Screen View ||
|| {{attachment:layout_1n3_h.gif}} ||1x3 Horizontal Screen View || {{attachment:view_sagittal.gif}} ||Saggital Volume View ||
|| {{attachment:view_coronal.gif}} ||Coronal Volume View || {{attachment:view_axial.gif}} ||Axial Volume View ||
|| {{attachment:view_3d.gif}} ||3D Volume View || {{attachment:A.gif}} ||Show Coordinate Annotation ||
|| {{attachment:colorbar.gif}} ||Show Color Scale Bar || {{attachment:screenshticon.gif}} ||Take Screenshot ||
|| {{attachment:recon_item.png}} || Show edit panel to edit a recon ||  ||  ||



== Control Panel ==
In the control panel on the left you can see all the volumes, ROIs, Surfaces, and Way Points that have been loaded. Each one has it's own set of controls and options described below. The images below correspond to the most recent version of Freeview, if you are working with an older version of freeview the control panel is slightly different. 

=== Volumes ===
When working with volumes, under '''Color Map''', you can select '''Grayscale''', '''Heat''', '''Jet''', and '''Lookup Table.''' Grayscale, Heat and Jet have similar control panel options.

==== Grayscale, Heat, Jet: ====
{{attachment:new_controlpanelgrayscale.jpg}}

In the panel shown you can see your volumes listed at the top, in this case the volume is called '''orig'''. The box next to the volume name is checked, meaning the volume is active for editing and visible in the viewing screen. The fact that it is highlighted in blue or selected means that any action you take (drawing, editing, rotating, saving, etc.) will happen on this volume.

Below, you can adjust the opacity between 0, completely transparent, and 1, completely opaque. Checking '''Smoothing display''' will smooth the edges of anything you have drawn on the volume. Underneath this is the Color Map drop down menu where you can choose Grayscale, Heat, Jet or Lookup Table.

Using the sliding bars for Window, Level, Min, and Max you can adjust the '''contrast''' of the volume.

==== Lookup Table ====
{{attachment:new_controlpanelcolor.gif}}

In the panel shown, Lookup Table has been selected as the Color Map. Here too, you can adjust opacity between 0 and 1 with the sliding bar.

Below that is a list of different brain regions, and their associated colors. From this menu you can choose which brain region you are going to code or label. This is generally used in the Voxel Edit mode or Recon Edit mode (at which point the '''Drawing Toolbox''' [described below] will pop up).

=== ROIs ===
ROIs can be adjusted visually by changing the opacity, color, and threshold of the ROI. The color of the ROI can either be a solid color, or a heatscale. In addition, ROIs can also be mapped to any of the surfaces that are also loaded in Freeview. 

{{attachment:ROI-panel.png}}

=== Surfaces ===
The colored box next to the surface's file name indicates the edge color selected for the surface. The edge color can be changed by clicking the colored box next to "Edge color" and selecting a different color. In addition, increasing the value next to "Edge thickness" causes the edge to increase in width. 

{{attachment:Surfs_panel.png}}

=== Way Points and Control Points ===
Loading or creating a new point set opens the Point Set control panel. This panel (shown below) can be used to change the opacity, radius, and color of your point set. In addition, selecting "Snap to voxel center", causes the control points to be moved to the center of the voxel they were placed in. The "Go to" option can be used to move your cursor to the exact location of the point which can be beneficial when multiple points are spread out across a subject. Additional information can be added to the point in the "Statistics" and "Comments" boxes. 

{{attachment:way-points-panel.png}}

== Drawing Toolbox ==
{{attachment:new_voxel_edit.jpg}}

In this toolbox you can choose different drawing tools, adjust the brush size between 1 (smallest) and 10 (largest), and set limitations. To draw on pixels of a specific value set the min and max as that value and select the box that says only draw on pixels in this range. Below is the name of each tool:
|| {{attachment:freehand.gif}} ||Freehand tool ||
|| {{attachment:polyline.gif}} ||Polyline tool ||
|| {{attachment:livewire.gif}} ||Livewire tool ||
|| {{attachment:fill.gif}} ||Fill tool ||
|| {{attachment:contour_button.jpg}} ||Contour tool ||
|| {{attachment:colorpicker.gif}} ||Color Picker tool ||
|| {{attachment:replacelabelbutton.jpg}} ||Replace Label tool ||




The '''Freehand''' tool allows you to draw voxels in any shape. The '''Polyline''' tool creates a line between every left click you make and returns to the origin when you right click.  The '''Livewire''' tool 'hugs' continuous boundaries starting every left click.  The current trace is cancelled once you hit the right click.  The '''Fill''' tool will draw/delete the voxel you left click on, as well as any neighboring voxels.  The degree of similarity between the selected voxel and neighboring voxels to be drawn/deleted can be adjusted.  Typically, you want to stay in the 2-10% range.  The '''Contour''' tool is a semi-automatic contour finder that can speed up label drawing.  It outlines all the possible contours based on the threshold value set by the user.  Once you have decided on a contour you can then fine-tine it. Use the '''Color Picker''' tool to left click on any voxel whose value you want to replicate.  Once you click on a voxel, the brush value should be updated accordingly.  Now you can switch to another tool to draw using that brush value.  The '''Replace Label''' tool allows you to change the brush/color value of certain labels within one slice or throughout the entire volume.
||Continue to [[FreeviewGuide/FreeviewGeneralUsage/FreeviewViewingArea|FreeviewViewingArea]] for more information ||