>
Using Echoview>
Echoview configuration dialog box

Echoview Configuration dialog box

The Echoview Configuration dialog box is used to set properties relating to the global (not EV file specific) operation of Echoview.

To display the Echoview Configuration dialog box:

On the File menu, click Configuration.

The Echoview Configuration dialog box contains the following pages:

General
Interface
3D Preferences
File locations
Performance
Scripting
Live Viewing

General page

Startup
Keyboard shortcuts
Network
Python

Startup

Select one of the following for When Echoview starts:

Setting

Description

Open AutoOpen.ev at program start up

Select this setting to open AutoOpen.EV file when you start Echoview.

Note: AutoOpen.EV must be located in the same folder as Echoview.exe or it will not be opened regardless of whether the checkbox is selected.

Check for updates at program start up

Clear this setting to disable automatic update checks. See Updating Echoview for more information.

Keyboard shortcuts

Manage custom and default Echoview keyboard shortcuts.

Settings	Description
Edit...	Use Edit to create custom shortcuts, re-assign existing shortcuts and save the edits. For more information on the rules for the content of this file refer to User-defined keyboard shortcuts.
Reload File	Use Reload to allow Echoview to use your custom shortcut file.
Restore Defaults	Use Restore Defaults to allow Echoview to revert to default shortcut key assignments.

Network

Select Disable non-essential Echoview downloads to disable Internet connection requests from non-essential parts of Echoview (WMS maps).

Python

Python source file editor specifies the editing program for Python® files used with the Code operator. The default editor is Windows Notepad. Use ... to browse to a desired editing program.

Listed details relate to the Echoview installed Python version and Echoview API version.

Interface page

Interface
Graph windows
Messages
Regions

Interface

The Interface settings affect windows and toolbars. See also: Navigating Echoview.

Settings	Description
Show captions on toolbar buttons	The Show captions on toolbar buttons list is used to select whether a caption is displayed next to applicable toolbar buttons. See Echogram toolbar for more information.
Initial state when opening a new window:	Specifies how new windows open. The list includes: Dock with an existing window Float above other windows
Remember the previous docked/floating state when reopening a window	Select or Clear this setting to determine the behavior when reopening a window.
Remember the last tool used on each window	Select or Clear this setting to determine tool/window behavior. Affects cruise track and echogram windows. The default for the setting is Clear.
Show the mouse pointer on secondary windows (Mouse pointer duplication)	Select or Clear this setting to duplicate the active mouse pointer time position in open echograms, cruise tracks, alongtrack displays and supported graphs. See also Mouse pointer duplication.

Graph Windows

The Linking mode for new graphs box is used to select the default linking mode (if any) for newly created graphs. See About Linking Graphs for more information.

Messages

Settings	Description
Echoview	Click the desired option to re-enable messages to which you have previously chosen not to display.
Other Programs
Show message dialogs only for messages that require an answer	Select when you want to see only message dialog boxes that require more than a simple OK response.
Log messages you interact with to the message bar	Select when you want to send messages that you interact with to the Message bar. This action keeps a record of important messages.
Disable the Code operator warning message	Select when you want to turn off the Code operator warning message. See also Using the Code operator: Security. Note: A new version of Echoview returns Disable the Code operator warning message to unselected.

Regions

The Synchronize echograms to activated region box is used to select whether open echograms are synchronized to display the currently activated region when using the Region Browser dialog box and the Regions window.

3D Preferences page

3D Mouse navigation

The settings in this area are used to customize the performance of your mouse for 3D Navigation.

Setting	Description
Horizontal sensitivity	Used to set the sensitivity of the mouse on the horizontal axis.
Vertical sensitivity	Used to set the sensitivity of the mouse on the vertical axis.
In-out sensitivity	Used to set the sensitivity of the mouse in the in-out axis.
Reverse horizontal and vertical motion	Selecting (and clearing) this option switches the relationship between mouse movements and the resulting on-screen movement, e.g. in one selection state a left movement with the mouse will result in a left movement on the screen, in the other selection state a left movement with the mouse will result in a right movement on the screen.
Restore Defaults	Click this button to reset Echoview's default 3D mouse navigation settings.

3D display quality

Rendering 3D scenes and 3D single target graphs requires large amounts of RAM and can cause slow performance or performance problems on some machines. The 3D Visualization slider allows you to choose a display setting that is biased for better quality or better performance. Selecting a performance biased setting may reduce rendering times by up to 50% depending on your computer hardware, operating system and graphics card. Echoview will choose an initial setting based on the amount of RAM available to your graphics card, but you can change this at any time. See also 3D display problems.

Navigation

The setting Default navigation mode for (Scene) new windows can be one of three modes: Rotate, Move or Pan. Rotate is the default mode. See 3D Navigation for a description of these three modes.

File locations page

The File locations page of the Echoview Configuration dialog box is used to specify default file paths for Echoview to save files to and look for files in. These settings are saved on the computer you are using and do not move with the EV file. The following settings are available:

Setting	Description
File Types/Location	You may specify the default location when Echoview displays an Open, Save, Import or Export dialog box: Data files Calibration files Export files Import files EV Files Map and waypoint files Color schemes Templates Live viewing templates Console files Python source files Select a file type to Clear the current setting or to Edit it (see below). Notes: Echoview scans for templates in the default location and in the user-specified locations (see The templates folders). To display templates from the user-specified location only, empty the default location of template files. The paths set here for data or calibration files are referenced by the %Configured Folder% variables in the corresponding settings on the EV File page.
Clear	Click to clear the folder for a selected file type.
Edit	Click to specify the folder for a selected file type.
Use most recently accessed location for this session	If you want the Open, Save, Import or Export dialog boxes for each file type to remember the folder to which you browsed last time, and display that folder again select this option. The first time the dialog box is displayed in any Echoview session it will display the location defined in the File Types table above (or generally the last location used by any dialog box in Echoview if the File Types list above has no entry).

Performance page

The Performance page of the Echoview Configuration dialog box is used to monitor performance and caching, and to specify cache settings. A diagnostic message is displayed when Echoview starts up if the cache settings differ from the defaults, and we strongly advise against changing any setting on this page as it may severely affect performance. In particular, do not set Limit Factor to zero.

Cache

Echoview caches ping data in memory, discarding it in reverse order of last use.

Setting	Description
Auto-limit memory usage	Echoview knows how much more memory is available to it. It adds that quantity to the amount already used by the cache to get the total fluid memory. When Auto-limit memory usage is selected Echoview restricts the amount of data in the cache to be less than the specified percentage of fluid memory. The amount of fluid memory varies with the amount of fixed data Echoview stores, and with the demands of other applications. When Auto-limit memory usage is cleared, Echoview restricts the amount of data in the cache to be less than the specified fixed limit. Limit factor (%) specifies the maximum percentage of fluid memory usable by the cache. Available (MB) displays available cache memory. Limit (MB) displays the cache memory limit. Used (MB) displays the used cache memory. Item count displays the items using cache memory. Cache hit rate (%) displays how often Echoview finds an item in the cache. Note: This setting will be unavailable when live viewing.
Restore Defaults	Click this button to restore the default settings on this page.
Clear Cache	Click this button to clear as many items as possible from the cache. Note, some items may not be able to be cleared.

Ping generation

Displays ping generation diagnostic information.

Scripting page

This page displays the details of the registered Echoview COM object. Displayed are details of registered COM objects found by Echoview and the version of Echoview that can be used with the COM interface. Refer to Scripting with COM objects: Known issues and Scripting with COM objects: Specifying Echoview for more information.

Echoview's COM interface supports a wide range of Echoview settings and actions that you can script. For more information refer to:

Live Viewing page

The Live Viewing page of the Echoview Configuration dialog box is used to set up file management and variable displays during live viewing.

Setting	Description
Automated EV file management during live viewing	This option is designed for unattended live viewing. Rather than create a single (potentially huge) EV file, it allows you to specify that after a certain period has elapsed, Echoview should remove some or all of the echosounder data files from the EV file, assign a new EV file name, and continue live viewing. Warning: If this option is not enabled, the file(s) being logged will continue to grow until they exceed available memory and Echoview will eventually crash as a result. Echoview Software strongly recommends you enable automated EV file management and that you enter settings that limit file size to that level that will not exceed the memory available on the logging computer. Warning: This option reduces, but does not eliminate the need for attended live viewing. For example, modal dialog boxes must be cleared manually or Echoview will eventually crash during live viewing. This occurs because a modal dialog box suspends automated file management and the files will continue to grow until they exceed available memory.
Retain EV files in folder	If this option is checked and a folder specified, then each of the EV files will be saved in the specified folder during live viewing. If this is not checked then the EV files will not be saved to disk. Note: You cannot change the specified folder while live viewing. If you try to change the folder while live viewing a message will be displayed to warn you that the changes will not be applied unless you exit and restart Echoview.
Create new EV file every (hours)	Specifies the number of hours of data that can be contained in a single EV file before a new one is started.
Minimum hours overlap with previous EV file	Used to determine the number of echosounder data files to retain from the previous EV file. If this number is zero then only the current log file will be retained in the EV file and the overlap time is determined by the amount of data in the file.
Automatically start live viewing when a logger is detected	If this option is selected, upon starting Echoview live viewing will automatically start when a logger is detected. You can then display the desired data by selecting a raw variable from the fileset.
Log a heartbeat while live viewing	If this option is selected, a message is sent at regular intervals (while live viewing with Echoview) to the Echoview log file. This can be used by automated systems to detect and confirm that Echoview is currently running and live viewing.