• Created by Unknown User (iyerv), last modified on Feb 27, 2011
This page contains macros or features from a plugin which requires a valid license.

You will need to contact your administrator.


MAIN CONTROLS Panel

Overview

The MAIN CONTROLS panel is the main ScanImage window. It is the panel from which image acquisitions are initiated (Section C). Closing the MAIN CONTROLS panel causes ScanImage as a whole to exit (after confirming intent). The panel is broken into two halves. The left half (Sections A-C) is always visible, while the right half (Sections D-F) can be shown or hidden. During certain types of acquisitions, the right half is hidden automatically to prevent certain commands from being processed during an ongoing acquisition.

Section A

  • : (Read-Only) Displays the name of the currently loaded Configuration (CFG file). If none is loaded, this field is blank.
  • : (Read-Only) When in acquisition mode, this indicates the number of repeat iterations that have been completed.
  • : (Read-Only) For /acquisitions, this keeps track of the number of slices that have been acquired (in the current repeat iteration, if using ), counting up to the value set in the window.
  • : (Read-Only) For /acquisitions, this keeps track of the number of frames that have been acquired (in the current repeat iteration, if using ), counting up to the value set in the window.
  • : For / acquisitions, this sets the stem of the filename to be saved for the next or ongoing acquisition. The is appended to the specified to create the full filename, e.g. beadTest3.tif in the example shown.
  • : For / acquisitions, this sets the number to append to the specified to create the full filename. This value is automatically incremented at the end of each acquisition (repeat iteration, if using ). The value can be manually edited, to affect the number that will be appended for the next acquisition.
  • : This displays a value in seconds, that depends on the current state and acquisition mode:
    • During and acquisitions, this displays a count-up value, in seconds, measuring the time elapsed for the ongoing acquisition.
    • For /acquisitions with External Triggering () enabled, a count-up value is displayed while waiting for the external trigger to arrive before beginning the acquisition (or next Repeat, if using ).
    • During LOOP acquisitions, the behavior of is described in LOOP Mode
  • : This initiates a Snapshot acquisition, which is a specially configured acquisition to acquire and display an average of the number of Frames specified in the adjoining text control.
    (tick) This is useful for quickly visualizing the specimen/field-of-view in between configured / acquisitions without adjusting the current ScanImage _Configuration nor risking overexposure with a acquisition.
  • : (CFG Value) This checkbox activates a Line Scan acquisition, forcing the amplitude of the scan in the slow scan dimension to be zero.
  • : This control toggles the display of the right half of the MAIN CONTROLS window.

Section B

This section consists of three components, from left to right:

  • : This checkbox determines whether Auto Save functionality is enabled for / mode, causing image data to be automatically saved to disk during the acquisition
    (info) A running buffer of the most recently acquired frames is maintained in the variable. The size of the running data buffer is specified by the values in the . A separate value is used depending on whether is selected or not.
  • : (Read-Only) This string displays status information regarding the state of ScanImage.
    (info) When the Status String specifies an error has occurred, it is recommended to look at the Matlab Command window to obtain additional information.
  • : (CFG Value) This toggle-button enables/disables External Triggering for / modes. It has no effect on FOCUS mode acquisition. If no external trigger is configured in the INI file, this button is disabled.

Section C

This section allows the user to begin a ScanImage image acquisition, using one of the 3 available acquisition modes – FOCUS, GRAB, and LOOP.

Upon selecting one of the buttons, acquisition begins (or is armed to wait for an External Trigger), and the corresponding button changes to read , while the others are hidden. Pressing stops acquisition immediately.

Section D

There are three groups of controls in this section – , , and – which affect the scan command generated by ScanImage during acquisition.
(tick) These controls can be adjusted while live imaging in FOCUS mode.
(tick) The , , and values all comprise part of the current ScanImage Configuration – i.e. their values are captured whenever a CFG file is saved.

In addition, this section contains:

  • controls in this section allow the , , and values to be rapidly restored to preset reference values.
  • controls on a docked sub-window, containing controls to facilitate beam and scan alignment.
Rotate Controls
  • : (CFG Value) Specifies angle, in degrees, by which the scan field-of-view is rotated.
    (info) At this time, scan rotation is not supported when Bidirectional Scanning is activated. The Rotate control is disabled in this circumstance.
  • : Resets the rotation value to 0 degrees.
  • : Activates a Graphical Interaction Tool allowing the user to select a line on the target image display window. The angle of the line updates the value accordingly; the center of the line updates the values accordingly.
    (info) As the control's name suggests, this control facilitates the configuration of scans for Line Scanning operation. Note however, that the updated and values apply regardless of whether Line Scanning is active or not.
    (info) Note that the length of the selected line has no effect.
Shift Controls
  • : (CFG Value) Specifies an offset, in optical degrees, to apply to the scan command signals in the Fast and Slow dimensions, shifting the field-of-view.
  • : The arrows allow the values to be adjusted without entering a new value. The value is adjusted (incremented or decremented) by the amount specified (in optical degrees) in the two nearby text edit controls – one each for horizontal and vertical adjustments.
  • : Resets the shift values to 0 degrees
  • : Activates a Graphical Interaction Tool allowing the user to select a point on the target image display window. The location of this point updates the values accordingly.
Zoom Controls
  • : (CFG Value) The 4 numbers represent the currently configured zoom factor and allow independent adjustment of the 1s, 10s, and 100s digit of that value. In additional, fractional zoom values can be specified with one decimal digit.
    • ScanImage simply divides the values (specified in the window) by the currently configured zoom factor, to determine the current scan amplitude.
    • The digits appear with a yellow background when the current zoom factor is below the Constant @ Zoom >= value specified in the window.
  • : Resets the currently configured {factor (and the Zoom Indicator) to 1, or to the value specified in the window.
Reset Controls
  • : By default, resets the , , and values to the values stored in the currently specified Configuration (CFG file). In other words, the unsaved CFG changes made by adjusting , , and are undone.
    (tick) If a set of , , and values are cached using , then restores those cached values instead.
  • : Caches the current , , and values so that subsequently pressing will restore these values.
    (info) Note that this does not save the current , , and values to the current Configuration (CFG file).
Align Controls
  • Toggles the display of the sub-panel, docked to the MAIN CONTROLS panel.


Section E

This section consist of controls to define/manage/load Regions of Interest (ROIs) within the scan's field-of-view. A Region of Interest consists of four items of information:

  1. value pair
  2. value
  4. Motor position (if motor is active)

Together these specify a square (or rhombus, if is nonzero) subregion within the most recently scanned field-of-view that can be scanned (at higher rates or pixel density, if desired).

The selected Region(s) of Interest are graphically depicted in the ROI Display window, with the current ROI displayed in blue.

  • : Activates a Graphical Interaction Tool allowing the user to select a square region on the target image display window. The currently configured and values are updated to reflect the size and center of the selected region.
    (info) At this time, ScanImage does not support rectangular regions-of-interest, although the box drawn with the ROI tool can be rectangular. The rectangular region is converted to a square region upon capturing the and values.
  • : Restores the , , and values prevailing prior to the previous Region of Interest selection with the tool.
  • : Captures the current , , and values as well as the current motor position (if motor is active) and stores values as a numbered ROI in the ROI Selection Menu.
  • : Removes the currently selected numbered ROI in the ROI Selection Menu from the list. Updates the currently selected numbered ROI value to a valid value (if any are left).
  • : Selection of numbered ROI value in dropdown menu updates currently configured , , and values to match those stored with numbered ROI. If motor is active, the X/Y/Z stage position(s) are also updated accordingly.
    (info) The left/right arrows to right of ROI Selection Menu can also be used to select the next lower/higher numbered ROI value.

Section F

This section contains 6 toggle buttons corresponding to the 6 Fast Configurations which can be defined in ScanImage. These correspond to ScanImage configurations (CFG Files), which can be loaded, or started, by pressing the single numbered button.

See for more information about set up and use of Fast Configurations.

(tick) When the current ScanImage configuration corresponds to one of the current Fast Configurations, that button appears depressed.
(tick) When the option is enabled for a particular Fast Configuration in the dialog, the corresponding button appears green in the MAIN CONTROLS panel
(tick) The tooltip for each Fast Configuration button contains the name of the CFG file saved as that particular Fast Configuration, so it is easy to identify the 6 Fast Configuration names.

  • : This toggle button shows/hides the window, which is used to set the majority of values specifying the ScanImage Configuration.

Menus

File Menu

Settings Menu

View Menu
  • No labels