Page History

{composition-setup}
----
{center}
!ImageControls_compact.bmp!!ImageControls.bmp!
*IMAGE CONTROLS Panel*
{center}
-----
The *IMAGE CONTROLS* panel contains controls related to the ScanImage [_Image Display Figures_|SI3.6_ImageDisplay] -- MATLAB figure windows which present, in various manners, the most recently acquired image data obtained by ScanImage on each of its up to 4 input _Channels_. These figures are: the _Channel 1-4_ displays, _Channel 1-4 Max Projection_ displays, and the _Channel Merge_ display. 

h3. Section A: {blue:White/Black} Levels
These input values, entered directly as numeric values or by using the slider controls, specify  the pixel data values of the [processed input data|SI3.6_InputDigitization] for each input _Channel_ that will be mapped to the highest and lowest entries, respectively in the 256-level _colormap_ used to display each _Channel's_ data on the [_Image Display Figures_|SI3.6_ImageDisplay]. 
* Pixel data values above the {blue:White} level are mapped to the highest entry in the _colormap_
* Pixel data values below the {blue:Black} levels are mapped to the lowest entry in the _colormap_
* Pixel data values between the {blue:White} and {blue:Black} levels are mapped linearly to entries within the _colormap_.

{vi-indent:2}
(/) Refer to [_Image Display Figures_|SI3.6_ImageDisplay] for further information about the _colormap_ used by each of the figures, the pixel data mapping, and some further display options.
(/) The {blue:White/Black} levels do not affect the data stored to the stored [_Image Files_|SI3.6_ImageFiles] which remain the original pixel data value without remapping. However the {blue:White/Black} levels are stored to the [_Image Header_|SI3.6_ImageFiles#ImageHeader], so it is possible to recover the display at the time of ScanImage acquisition.
{vi-indent}

{comment}Consider including an excerpt about colormap issues here{comment}

h3. Section B: Image Display Interactive Tools
This section consists of {blue:Image Tools} that involve graphical user interaction with one of the ScanImage [_Image Display_|SI3.6_ImageDisplay] figures.

{anchor:GraphInteractionTools}
The {blue:Default Target} control selects the target of these and other _graphical interaction tools_ in ScanImage:
{panel:title=SCANIMAGE CONCEPT: Graphical Interaction Tools}{include:Graphical Interaction Tools (r3.6)}{panel}

{anchor:DisplayZoomTool}
{blue:Display Zoom} !DisplayZoom.bmp!
This button toggles on/off the Matlab [zoom tool|http://www.mathworks.com/access/helpdesk/help/techdoc/creating_plots/f4-44425.html] in the target figure. With the zoom tool, it is possible to zoom in on selected areas of the image, _without affecting the scan command signals_ generated -- ScanImage continues to scan the larger scan area determined by the current [_Configuration_|SI3.6_Config].
{vi-indent:2}
(/) This is helpful for investigating a subregion of an image without actually scanning a smaller subregion, which often causes excessive photodamage/photobleaching. 
(/) This capability is particularly useful for [optimizing bidirectional scan configurations|SI3.6_FastScanDetails#BidiOptimization] at low {blue:Zoom} levels.
{vi-indent}

The Matlab zoom tool remains active on the targeted [_Image Display Figure_|SI3.6_ImageDisplay] until the button is pressed again, toggling the feature off. While the feature remains active, the tool's context menu (right-click menu) can be used to zoom back out of regions. Thus the tool allows one to change the selected subregion repeatedly.

{blue:Display Data Tips} !DisplayDataTip.bmp!
This button toggles on/off the Matlab [data cursor tool|http://www.mathworks.com/access/helpdesk/help/techdoc/creating_plots/f4-44221.html] in the target figure. With the data cursor tool, one or more 'datatips' can be added to the target figure, allowing the pixel value at any position in the image to be displayed as a small note. Once added, datatips can be moved freely throughout the image figure, with the noted value updating to reflect the image pixel location.

{comment}Show datatip figure here?{comment}
The Matlab data cursor tool remains active on the targeted [_Image Display Figure_|SI3.6_ImageDisplay] until the button is pressed again, toggling the feature off. While the feature remains active, the tool's context menu (right-click menu) can be used to add further datatips, as well as to remove datatips. Note that datatips left active when the tool is toggled off will remain displayed -- it is often recommended to _Delete All Datatips_ via the context menu before toggling the tool off.

{blue:Display Histogram} !DisplayHistogram.bmp!
This button will compute and display a Matlab figure containing a histogram of the pixel data values.
* The histogram _bins_ correspond to the 256 _colormap_ entries in the targeted [_Image Display Figure_|SI3.6_ImageDisplay].
* The histogram _counts_ correspond to the number of pixels assigned to each entry

The computed histogram depends on the {blue:White/Black} levels selected for the given _Channel_.

{vi-indent:2}
(/) This tool is useful for visually determining the quality the _colormap_ mapping determined by the {blue:White/Black} levels chosen
(i) This tool cannot be used with the _Channel Merge_ figure
{vi-indent} 

{blue:Display Statistics} !DisplayStatistics.bmp!
This button will compute and display to the Matlab command line basic statistics (max, min, median, mean, mode) of the pixel data values in the targeted [_Image Display Figure_|SI3.6_ImageDisplay], as mapped to _colormap_ entries in that target.

The computed statistics depends on the {blue:White/Black} levels selected for the given _Channel_.

{vi-indent:2}
(i) This tool cannot be used with the _Channel Merge_ figure
{vi-indent}