TV::GUI:: Namespace

The variables in this section have meaning (and in some cases, a value) only when you are using the TotalView GUI. Note that some are specific to the Classic UI only.

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.

true or false

true

TV::GUI::display_bytes_kb_mb

When true, the Memory Debugger displays memory block sizes in megabytes. If set to false, it displays memory blocks sizes in kilobytes.

true or false

true

TV::GUI::display_font_dpi

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

 An integer

75

TV::GUI::enabled

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

true or false

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.

 A string naming a fixed font residing on your system

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.

 A string representing an installed font family

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.

An integer

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.

A string naming a fixed font residing on your system. While this is platform specific, here is a representative value:-adobe-helvetica-medium-r-normal--12-120-75-75-p-67-iso8859-1

helvetica

TV::GUI::force_window_positions

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 Enlightenment can use their smart placement modes.

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

true or false

false

TV::GUI::frame_offset_x

Not implemented.

TV::GUI::frame_offset_y

Not implemented.

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 window’s width and height.

If you set any of these values to 0 (zero), TotalView uses its default value. This means, however, you cannot 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.

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{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.

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{0 0 0 0}

TV::GUI::geometry_expressions

Specifies the position at which TotalView displays the Tools > Expression List Window.

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

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{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.

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{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.

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{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.

 A list containing four integers indicating the window’s x and y coordinate’s and the window’s width and height

{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.

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{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.

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{0 0 0 0}

TV::GUI::geometry_modules

Classic UI Only

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

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

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height.

{0 0 0 0}

TV::GUI::geometry_process

Classic UI Only

Specifies the position at which TotalView displays the Process Window.

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

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{0 0 0 0}

TV::GUI::geometry_ptset

No longer used.

TV::GUI::geometry_root

Classic UI Only

Specifies the position at which TotalView displays the Root Window.

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

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{0 0 0 0}

TV::GUI::geometry_thread_objects

Classic UI Only

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

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

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{0 0 0 0}

TV::GUI::geometry_variable

Classic UI Only

Specifies the position at which TotalView displays the Variable Window.

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

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{0 0 0 0}

TV::GUI::geometry_variable_stats

Classic UI Only

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

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

 A list containing four integers indicating the window’s x and y coordinates and the window’s width and height

{0 0 0 0}

TV::GUI::hand_cursor_enabled

Specifies whether the cursor should change to a hand cursor when hovering over an element you can dive into in the source pane of the process window.

true or false

true

TV::GUI::heap_summary_refresh

Not user settable.

TV::GUI::inverse_video

Not implemented.

TV::GUI::keep_expressions

Deprecated.

TV::GUI::keep_search_dialog

When 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.

true or false

true

TV::GUI::old_root_window

Classic UI Only

When true, TotalView replaces the Root Window with the Root Window used in versions prior to TotalView 8.15. You can override this value using the following command-line options:

-oldroot sets this variable to true

-newroot sets this variable to false

Using the previous-version Root Window may affect performance of applications containing thousands of threads/processes.

true or false

false

TV::GUI::pop_at_breakpoint

 

When true, TotalView automatically focuses on the active thread and/or process when your program reaches a breakpoint. In the TotalView UI, it sets the Automatically focus on threads/processes at breakpoint checkbox on the Action Points tab of the Preferences dialog to be selected by default. If this variable is set to false, this check box is unselected by default.

true or false

true

TV::GUI::pop_on_error

Classic UI Only

When 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.

true or false

true

TV::GUI::process_grid_wanted

Classic UI Only

When true, TotalView enables the Processes/Ranks Tab in the Process Window. Enabling this tab can significantly affect performance, particularly for large, massively parallel applications.

true or false

false

TV::GUI::show_startup_parameters

Setting this value to true tells TotalView to display that it should display the Process > Startup dialog box when you use a program name as an argument to the TotalView command.

true or false

true

TV:GUI:show_sys_thread_id

Displays the current thread’s system thread ID within the TotalView GUI.

true or false

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.

true or false

true

TV::GUI::toolbar_style

This value set defines toolbar display.

icons_above_text,icons_besides_text,icons,or text

icons_above_text

TV::GUI::tooltips_enabled

When true, variable tooltips are displayed in the Process Window Source Pane.

true or false

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.

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

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.

 A string

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.

 An integer

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.

 A number