13.3.1 The LogView Class

The LogView class provides the general variables, functions, and interface components for all the LogView subclasses. Visually all LogView objects have a common interface at the top of the LogView window. In the top middle of each LogView widow is a set of four buttons used for scrolling the visible region of the LogView throughout the data and data logfile:

|< Full Rewind
Load the first data_bufsz lines of data from the file.
< Rewind
Move back data_shift lines in the datatable.
> Forward
Move forward data_shift lines in the datatable.
>| Full Forward
Load the last data_bufsz lines of data from the file.

To the left of the scroll buttons is a toggle switch which sets the LogView's updating on or off. To the right of the scroll buttons are the Update, Init, and Clear buttons. The Update button is the most benign. Its action merely refreshes the display. The Init button is does a bit more by rescaling, recentering and recreating the graphical representation of the LogView based on the settings of the ViewSpecs and the LogView object. The Clear button destructively removes all the data from the log and re-initializes the display. It is useful if you are restarting your Training for example and want to clear out the statistics gathered for the last Training run. The Clear button does not affect the log files.

All LogViews have the following functions in their Actions menu:

EditViewSpec(ViewSpec* vs)
Brings up an Edit Dialog for the chooses Viewspec vs
ToggleViewSpec(ViewSpec* vs)
Toggles the visibility of the ViewSpec vs turning it ON or OFF

And as mentioned above, all LogViews have the following Variables:

bool display_toggle
Determines if screen updates from the Update Processes will affect the display or not. It is sometimes useful to turn off the complex display updating of the LogView to speed up the Processes. This variable does not affect the recording of the Log information. Thus if the display_toggle is toggled off while a Process is running, and then toggled back on, the LogView display will reflect all of the data received when the LogView display was turned off.
int view_bufsz
The maximum number of lines of Log data visible in the Display
float view_shift
The percentage of view_bufsz to shift when the data exceeds the view_range
MinMax view_range
The range of currently visible data lines.
DT_ViewSpec viewspec
This DataTable View specification is the place holder for all the ViewSpecs for the individual columns of data in the log. In addition it may contain some global LogView parameters depending on the the type of LogView it is associated with.