_AddEquationViewOnLive, _AddNewEquationView, _BackupLayouts, _CalciumViewSetup, _EditScale, _EquationViewSetup, _PearsonViewSetup, _PhysicalZoomProperties, _PhysicalZoomPropertiesCursor, _RatioViewSetup, _RestoreLayouts, _TitrationCalibration, AddEquationViewOnLive, AddNewEquationView, AllowZoomUnderBestFit, AutoZoomInMeasurement, BackupLayouts, DisplayColorSpace, DisplayOptions, EnableButtons, EnableLayouts, EnableZIntensityControl, EquationViewSetup, KeepPicWndAspect, KeepTextZoom, LoadTitration, LoadTitrationFromFile, MeasColors, ND_CloseAcqAfterRun, PearsonViewEnable, RatioViewAutoScale, RatioViewEnable, RatioViewSetup, Redraw, ReloadCurrentLayout, ReloadDefaultLayout, RemoveEquationView, RemoveEquationViewOnLive, ResetAutoScale, RestoreLayouts, RestoreLayoutsEx, SaveCurrentLayout, SaveCurrentLayoutAs, SaveCurrentLayoutAsDefault, SetBackground, SetColorScale, SetCommandText, SetDarkColorScheme, SetDefaultVDockerSide, SetInitialZoom, SetLayoutGuiZoom, SetLineThicknessEx, SetMultiWindowLiveZoom100, SetPhysicalZoom, SetSaveDialogPrompt, SetScreenTextEx, SetStatusBarZIndex, SetTitrationModulatedChannel, SetToolbarsPlacement, ShowComponentTabs, ShowGUI, ShowPhysicalZoom, ShowRatioScale, ShowScrollbars, ShowSplitCompAllChannels, ShowSplitCompCustomChannels, ShowSplitCompPerCamera, ShowTaskbar, ShowThumbsInProc, SplitCompVAASSync, StretchAppWindow, SuppressDisplay, SuppressLMDisplay, TitrationViewEnable, Toggle4KLayoutGuiZoom, ToggleColorScheme, ToggleShowPhysicalZoom, ToggleShowScrollbars, ToggleTaskbar, TransformEquationView, UseAdvacedButtons, ViewEquation, ViewPearson, ViewRatio, ViewSplitComponents, ViewTitration
Interactive command to this function: Applications > Ratio, Ca2+, FRET > Add New Equation View on Live
Description
AddEquationViewOnLive( char *EquationExpression
, char *EquationDescription
, char *EquationUnit
);
This function adds a custom equation view on live image.
Interactive command to this function: Applications > Ratio, Ca2+, FRET > Add New Equation View
Description
AddNewEquationView( char *EquationExpression
, char *EquationDescription
, char *EquationUnit
);
Processes image channels using a custom equation and displays the result as a separate channel. See and try Applications > Ratio, Ca2+, FRET > Add New Equation View.
Description
AllowZoomUnderBestFit(
int AllowZoomUnderBestFit
);
This function swaps the Edit > General Options > Appearance > Allow zoom factors lower than best fit option.
Description
AutoZoomInMeasurement(
int Enabled
);
This function swaps the Edit > General Options > Measurement > Automatically zoom in Length manual measurements option.
Description
BackupLayouts(
char *Filename
);
This function saves settings of all currently defined layouts to an XML file.
Description
DisplayColorSpace(
int ColorSpace
);
Changes coordinate space at the status bar from RGB to HSI and vice versa.
Description
DisplayOptions( intMacroName
, intUserText
, char *TextInCaption
);
This function enables you to customize the NIS-Elements caption.
Parameters
See Also
DisplayColorSpace, OverlayTransparency
Description
EnableButtons(
int benable
);
This function enables/disables buttons (binary, color, ..., overlay, user) on the right side of the screen.
Description
EnableLayouts(
bool EnableLayouts
);
This function enables/disables the application layout management. It corresponds to the Show Layout Tabs check box in the Options dialog window.
Parameters
See Also
_GeneralOptions
Description
EnableZIntensityControl(
int Enabled
);
This function enables/disables the Z Intensity control.
Description
EquationViewSetup( char *EquationExpression
, char *EquationDescription
, char *EquationUnit
);
This function defines a custom equation for processing the image.
Description
KeepPicWndAspect(
bool KeepPicWndAspect
);
This function corresponds to the Edit > General Options > Appearance > Keep picture window aspect check box. If checked, the document window with an image opened respects the image size while zooming.
See Also
_GeneralOptions
Description
KeepTextZoom(
int KeepTextZoom
);
This function corresponds to the Edit > General Options > Appearance > Keep text size while zooming check box. It makes the text annotations keep their size even if the image is being zoomed.
Description
LoadTitration(
char *Name
);
Loads titration settings previously saved by the Titration Calibration window.
button in theDescription
LoadTitrationFromFile( char *Name
, intOnlyColors
);
This function loads titration calibration previously saved to an XML file.
Description
MeasColors( intExcl
, intOut
);
Sets the colors for indicating measured objects status.
Description
ND_CloseAcqAfterRun(
int Enabled
);
Modifies the Close ND Acquisition Window after Run option status. See Edit > Options .
This function runs the Correlation View command.
Description
PearsonViewEnable(
int RatioViewEnable
);
Displays/hides the “Correlation” channel (view) of the current image.
Description
RatioViewAutoScale();
This function performs automatic estimation of limits of the Ratio View color scale. It equals the button in the Ratio View Setup.
This function runs the Applications > Ratio, Ca2+, FRET > Ratio View command.
Description
RatioViewEnable(
int RatioViewEnable
);
This function turns the Ratio View on/off. Ratio view displays the image as a ratio of its two channels.
Interactive command to this function: Applications > Ratio, Ca2+, FRET > Ratio Properties
Description
RatioViewSetup( charRatioViewNumer
, charRatioViewDenom
, intRatioViewNumerOffset
, intRatioViewDenomOffset
, doubleRatioViewMin
, doubleRatioViewMax
);
This function displays the current image in Ratio View according to the parameters.
Parameters
Description
Redraw();
This function redraws the screen. It handles non-standard situations, when the screen is not repainted properly.
This function runs the View > Layout > Reload Current Layout command.
Description
ReloadCurrentLayout();
This function reloads the current layout settings. It discards changes made from the moment it was last saved.
Description
ReloadDefaultLayout();
This function reloads default layout of the application.
Description
RemoveEquationView(
int RatioIndex
);
This function removes the defined equation view. Ratio Index set to 0 = shows the ratio view, 1 = shows the calcium view.
This function runs the Applications > Ratio, Ca2+, FRET > Remove Equation View from Live command.
Description
RemoveEquationViewOnLive(
int RatioIndex
);
This function removes defined equation view from live. Ratio Index set to 0 = shows the ratio view, 1 = shows the calcium view.
Description
ResetAutoScale();
This function sets FRET eff (FRET efficiency) color scale range to default values.
Description
RestoreLayouts(
char *Filename
);
This function loads settings of layouts from an XML file.
Description
RestoreLayoutsEx( char *Filename
, intOptions
);
This function loads settings of layouts from an XML file.
Parameters
This function runs the View > Layout > Save Current Layout command.
Description
SaveCurrentLayout();
This function saves changes of the current layout.
This function runs the View > Layout > Save Current Layout As command.
Description
SaveCurrentLayoutAs();
This function enables you to save the current layout under a different name. A dialog window appears. Select an existing layout to be overwritten or fill in a name for the new layout.
This function runs the View > Layout > Save Current Layout As Default command.
Description
SaveCurrentLayoutAsDefault();
This function saves the current layout of the application as default.
Description
SetBackground(
int Background
);
Changes the color and appearance of the image window background. The functions corresponds to setting the background in Appearance options.
Parameters
See Also
RGB
Description
SetColorScale(
int RatioIndex
);
A color transition (scale) can be selected for image views which support it, which is for example Ratio View. The Ratio Index can be set to the following values: 0 = Default, 1 = Rainbow, 2 = Iron, 3 = Green Fire, 4 = Green Fire Blue, 5 = Red Fire, 6 = Red Hot, 7 = Magenta Hot, 8 = Brown, 9 = Lemon Hot, 10 = Yellow Pale, 11 = Rainbow Contrast, 12 = Rainbow Dark.
Description
SetCommandText(
char *text
);
This function draws a text in the status bar.
Note
This is useful when running loops within a macro and the user is not interested to see flashing command line. Also it significantly speeds up the execution of the loops. When the macro is finished or you specify NULL (0) as a parameter then the command line is refreshed as usually.
Description
SetDarkColorScheme(
int DarkScheme
);
This function changes the application appearance.
Description
SetDefaultVDockerSide(
int DockingView
);
Determines the default side where the control panels are docked after double-clicking their caption.
Description
SetInitialZoom(
int InitialZoom
);
This function corresponds to the Edit > General Options > Appearance > Initial Zoom combo box. Sets the initial zoom of the document window.
Parameters
See Also
_GeneralOptions
Description
SetLayoutGuiZoom(
double LayoutGuiZoom
);
This function zooms the whole application window in/out and changes the size of the controls.
Description
SetLineThicknessEx( intThickness
, intColor
, inttransparent
);
This function defines thickness of the lines, color of the lines and transparency of the text for functions with output to the screen.
Thickness parameter specifies the thickness of the lines when drawing lines on screen. 1..10 line width in pixels.
Parameters
Description
SetMultiWindowLiveZoom100(
int Zoom100
);
Sets the option if the Live and Capture windows should start in 100% zoom.
Description
SetPhysicalZoom(
int Index
);
Displays the current (calibrated) image using the selected magnification as if you observed the sample using a magnifier glass with the zoom magnification specified by the Index parameter (0 = 25x, 1 = 50x, 2 = 100x, 3 = 200x, 4 = 400x, 5 = 800x).
Description
SetSaveDialogPrompt(
int Discard
);
This function changes the options offered in the dialog when an image is closed without saved changes.
Description
SetScreenTextEx( intFormat
, intShortFeat
);
Configures text annotations of the measurement.
Parameters
Description
SetStatusBarZIndex(
int ZIndex
);
This function sets which Z-drive info is displayed within the main status bar in case there are two Z drives connected to the system.
Description
SetTitrationModulatedChannel(
int RatioIndex
);
This function sets what channel to use for the Titration Calibration display. Ratio Index is the index number of the channel starting from 0 (0 = first channel, 1 = currently selected channel).
This function runs the Toolbars command.
Description
SetToolbarsPlacement(
int ToolbarsPlacement
);
This function sets the appearance and behaviour of the image toolbars.
Description
ShowComponentTabs(
int ViewingComp
);
Shows or hides the component tabs below the image.
Description
ShowGUI( boolShowGUITop
, boolShowGUILeft
, boolShowGUIImageTop
, boolShowGUIImageRight
, boolShowGUIChannelTabs
, boolShowGUIOrganizer
);
This function modifies the graphical user interface of the application. Main and document toolbars can be displayed or hidden.
Parameters
This function runs the Show Physical Zoom command.
Description
ShowPhysicalZoom(
int ShowPhysicalZoom
);
Displays the physical zoom of your image (how many times the image is magnified on your monitor compared to the real dimensions of the calibrated sample). Multiple monitors are supported.
See Also
Description
ShowRatioScale(
bool ShowRatioScale
);
When being in Ratio View, this function displays/hides its color scale.
This function runs the Show Scrollbars command.
Description
ShowScrollbars(
int ShowScrollbars
);
This function turns ON/OFF the visibility of the scroll bars when the image is zoomed in.
See Also
ToggleShowScrollbars
This function runs the Show Thumbnail of Merged All Channels command.
Description
ShowSplitCompAllChannels(
int SplitCompAllChannels
);
Sets the option whether the sub-view with all channels should be present in Split Components viewing mode
This function runs the Show Thumbnail of Merged Custom Channels command.
Description
ShowSplitCompCustomChannels(
int SplitCompCustomChannels
);
Sets the option whether Custom sub-view should be present in Split Components viewing mode
See Also
ShowSplitCompAllChannels, ViewSplitComponents
Description
ShowSplitCompPerCamera(
int SplitCompAllChannels
);
For acquisition with multiple cameras this command automatically creates a tile view merging components based on the camera type.
Description
ShowTaskbar(
int Show
);
This function shows or hides the task bar.
Parameters
See Also
ToggleTaskbar
Description
ShowThumbsInProc(
integer ShowThumbsInProc
);
This function turns the thumbnail preview mode in image processing dialogs ON/OFF.
Description
SplitCompVAASSync(
int SplitCompAllChannels
);
Enables synchronization of channels selection for VAAS images.
Description
StretchAppWindow(
int StretchAppWindow
);
On dual-screen systems, this function enables you to stretch the application desk-top to both screens. When the application window is in focus (active), it will be brought to front on both screens.
Description
SuppressDisplay();
This function suppresses display to speed up operations. This function is useful especially for automated measurement, where speed is the ultimate demand. This function has no menu equivalent.
See Also
SuppressLMDisplay
Description
SuppressLMDisplay(
int suppress
);
This function disables notification to NIS-Elements about changing views and processes. This function has no menu equivalent.
See Also
SuppressDisplay
This function runs the Applications > Ratio, Ca2+, FRET > Titration View command.
Description
TitrationViewEnable(
int RatioViewEnable
);
This function toggles the visibility of titration view.
Description
ToggleColorScheme();
This function switches appearance of the application between the dark scheme and the light scheme.
Description
ToggleShowPhysicalZoom();
Toggles between the physical zoom information on/off.
See Also
Description
ToggleShowScrollbars();
This function toggles visibility of the scroll bars when the image is zoomed in.
See Also
ShowScrollbars
Description
ToggleTaskbar();
This function calls the ShowTaskbar and switches its parameter (0 or 1).
See Also
ShowTaskbar
Description
TransformEquationView( intRatioIndex
, intRatioTransformFlag
);
Adds a new equation view. Ratio Index is the index number of the channel starting from 0 (0 = first channel, 1 = currently selected channel).
Description
UseAdvacedButtons(
bool UseAdvacedButtons
);
This function corresponds to the Edit > General Options > Appearance > Image Toolbar buttons. Sets an appearance of buttons on the right document toolbar.
See Also
_GeneralOptions
Description
ViewEquation(
int RatioIndex
);
Shows the equation view on the current image. Ratio Index set to 0 = shows the ratio view, 1 = shows the calcium view.
Description
ViewPearson(
int RatioIndex
);
Shows the correlation view on the current image once it has been enabled by the PearsonViewEnable function. The Ratio Index parameter is ignored (for future use).
Description
ViewRatio(
int RatioIndex
);
Shows the ratio view on the current image. Ratio Index set to 0 = shows the ratio view, 1 = shows the calcium view.
This function runs the View > Image > ND View > Switch to Split Component View command.
Description
ViewSplitComponents(
int ViewSplitComp
);
This function turns the split component view ON/OFF.
Description
ViewTitration(
int RatioIndex
);
Shows the titration view on the current image.
This function runs the Applications > Ratio, Ca2+, FRET > Add New Equation View on Live command.
Description
_AddEquationViewOnLive();
This command opens a window which defines a custom equation for processing the live image.
This function runs the Applications > Ratio, Ca2+, FRET > Add New Equation View command.
Description
_AddNewEquationView();
This function opens the Custom Equation control window.
Description
_BackupLayouts();
This function displays a dialog window for exporting layouts. Settings of all layouts can be saved to an XML file.
See Also
_BackupOptConf, _BackupObjectives
This function runs the Applications > Ratio, Ca2+, FRET > Calcium Properties command.
Description
_CalciumViewSetup();
Description
_EditScale(
int Type
);
This function displays a dialog window with the specified color scale definition.
Description
_EquationViewSetup();
This function opens the Custom Equation dialog window. Where you can define custom equation.
This function runs the Correlation Properties... command.
Description
_PearsonViewSetup();
Opens the “Correlation view” settings window if the correlation view is enabled. See PearsonViewEnable.
Description
_PhysicalZoomProperties();
Opens the Monitor Calibration dialog window where custom monitor calibration can be made.
Description
_PhysicalZoomPropertiesCursor();
Opens the Monitor Calibration dialog window where custom monitor calibration can be made.
This function runs the Applications > Ratio, Ca2+, FRET > Ratio Properties command.
Description
_RatioViewSetup();
This function displays the Ratio View Properties dialog box.
Description
_RestoreLayouts();
This function displays a dialog window which selects an XML file containing the layouts settings. Such *.XML file could have been created using the export option of the layout manager.
This function runs the Applications > Ratio, Ca2+, FRET > Titration Calibration in Vitro command.
Description
_TitrationCalibration();
This function opens the Titration Calibration in Vitro dialog window which defines the pseudo-color image display according to the ratio/intensity.