TV::GUI:: Namespace

Note:   The variables in this section only have meaning (and in some cases, a value) when your are displaying TotalView's GUI.

TV::GUI::chase_mouse

When this variable is set to true, TotalView displays dialog boxes at the location of the mouse cursor. If this is set to false, TotalView displays them centered in the upper third of the screen.

Permitted Values: true or false

Default: true

TV::GUI::display_font_dpi

Indicates the video monitor DPI (dots per inch) at which fonts are displayed.

Permitted Values: An integer

Default: 75

TV::GUI::enabled

When this is set to true, you invoked the CLI from the GUI or a startup script. Otherwise, this read-only value is false.

Permitted Values: true or false

Default: true if you are running the GUI even though you are seeing this in a CLI window; false if you are only running the CLI

TV::GUI::fixed_font

Indicates the specific font TotalView uses when displaying program information such as source code in the Process Window or data in the Variable Window. This variable contains the value set when you select a Code and Data Font entry in the Fonts Page of the File > Preferences Dialog Box.

This is a read-only variable.

Permitted Values: A string naming a fixed font residing on your system

Default: While this is platform specific, here is a representative value:
-adobe-courier-medium-r-normal--12-120-75-75-m-70-iso8859-1

TV::GUI::fixed_font_family

Indicates the specific font TotalView uses when displaying program information such as source code in the Process Window or data in the Variable Window. This variable contains the value set when you select a Code and Data Font entry of the Fonts Page of the File > Preferences Dialog Box.

Permitted Values: A string representing an installed font family

Default: fixed

TV::GUI::fixed_font_size

Indicates the point size at which TotalView displays fixed font text. This is only useful if you have set a fixed font family because if you set a fixed font, the value entered contains the point size.

Font sizes are indicated using printer points.

Permitted Values: An integer

Default: 12

TV::GUI::font

Indicates the specific font used when TotalView writes information as the text in dialog boxes and in menu bars. This variable contains the information set when you select a Select by full name entry in the Fonts Page of the File > Preferences Dialog Box.

Permitted Values: While this is platform specific, here is a representative value:
-adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1

Default: helvetica

TV::GUI::force_window_position

Setting this variable to true tells TotalView that it should use the version 4 window layout algorithm. This algorithm tells the window manager where to set the window. It also cascades windows from a base location for each window type. If this is not set, which is the default, newer window managers such as kwm or Enlightment can use their smart placement modes.

Dialog boxes still chase the pointer as needed and are unaffected by this setting.

Permitted Values: true or false

Default: false

TV::GUI::geometry_call_tree

Specifies the position at which TotalView displays the Tools > Call Tree Window. This position is set using a list containing four values: the window's x and y coordinates. These are followed by two more values specifying the windows width and height.

If you set any of these values to 0 (zero), TotalView uses its default value. This means, however, you cannot tell TotalView to place a window at x, y coordinates of 0, 0. Instead, you'll need to place the window at 1, 1.

If you specify negative x and y coordinates, TotalView aligns the window to the opposite edge of the screen.

Permitted Values: A list containing four integers indicating the windows x and y coordinates and the windows width and height.

Default: {0 0 0 0}

TV::GUI::geometry_cli

Specifies the position at which TotalView displays the Tools > CLI Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_globals

Specifies the position at which TotalView displays the Tools > Program Browser Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_help

Specifies the position at which TotalView displays the Help Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_memory_stats

Specifies the position at which TotalView displays the Tools > Memory Statistics Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinate's and the windows width and height.

Default: {0 0 0 0}

TV::GUI::geometry_message_queue

Specifies the position at which TotalView displays the Tools > Message Queue Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_message_queue_graph

Specifies the position at which TotalView displays the Tools > Message Queue Graph Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_modules

Specifies the position at which TotalView displays the Tools > Fortran Modules Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_process

Specifies the position at which TotalView displays the Process Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the windows x and y coordinates and the windows width and height.

Default: {0 0 0 0}

TV::GUI::geometry_ptset

Specifies the position at which TotalView displays the Tools > P/T Set Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_pvm

Specifies the position at which TotalView displays the Tools > PVM Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_root

Specifies the position at which TotalView displays the Root Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_thread_objects

Specifies the position at which TotalView displays the Tools > Thread Objects Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_variable

Specifies the position at which TotalView displays the Variable Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::geometry_variable_stats

Specifies the position at which TotalView displays the Tools > Statistics Window.

See TV::GUI::geometry_call_tree for information on setting this list.

Permitted Values: A list containing four integers indicating the window's x and y coordinates and the window's width and height.

Default: {0 0 0 0}

TV::GUI::keep_search_dialog

When this is set to true, TotalView doesn't remove the Edit > Find Dialog Box after you select that dialog box's Find button. If you select this option, you will need to select the Close button to dismiss the Edit > Find box.

Permitted Values: true or false

Default: true

TV::GUI::pop_at_breakpoint

When this is set to true, TotalView sets the Open (or raise) process window at breakpoint check box to be selected by default. If this variable is set to false, it sets that check box to be deselected by default.

Permitted Values: true or false

Default: false

TV::GUI::pop_on_error

When this is set to true, TotalView sets the Open process window on error signal check box in the File > Preferences's Option Page to be selected by default. If you set this to false, TotalView sets that check box to be deselected by default.

Permitted Values: true or false

Default: true

TV::GUI::single_click_dive_enabled

When set, you can perform dive operations using the middle mouse button. Diving using a left-double-click still works. If you are editing a field, clicking the middle mouse performs a paste operation.

Permitted Values: true or false

Default: true

TV::GUI::ui_font

Indicates the specific font used when TotalView writes information as the text in dialog boxes and in menu bars. This variable contains the information set when you select a Select by full name entry in the Fonts Page of the File > Preferences Dialog Box.

Permitted Values: While this is platform specific, here is a representative value:
-adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1

Default: helvetica

TV::GUI::ui_font_family

Indicates the family of fonts that TotalView uses when displaying such information as the text in dialog boxes and menu bars. This variable contains the information set when you select a Family in the Fonts Page of the File > Preferences Dialog Box.

Permitted Values: A string

Default: helvetica

TV::GUI::ui_font_size

Indicates the point size at which TotalView writes the font used for displaying such information as the text in dialog boxes and menu bars. This variable contains the information set when you select a User Interface Size in the Fonts Page of the File > Preferences Dialog Box.

Permitted Values: An integer

Default: 12

TV::GUI::using_color

Not implemented.

TV::GUI::using_text_color

Not implemented.

TV::GUI::using_title_color

Not implemented.

TV::GUI::version

This number indicates which version of the TotalView GUI is being displayed. This is a read-only variable.

Permitted Values: A number