Diagnostics and configuration

[[module omega]]

Last revision: ver. 4.1-alpha2 - 18 Jun 2013

These functins are used to configure various aspects of the application, and to print debug information.

[x, y] getDisplayPixelSize()

Returns the size in pixels of the main display. The size returned by this function depends on the display configuration. Tiled planar and cylindrical display systems return the cumulative resolution of the tiled display. Custom display configurations lacking a planar mapping return the pixel size of the first tile created.

bool getBoolSetting(string section, string name, bool default)

Reads a boolean setting name from setting section section. The section is searched inside the app configuration file first, then in system configuration. If the setting is not found, the function return the specified default value.

string getStringSetting(string section, string name, string default)

Reads a string setting name from setting section section. The section is searched inside the app configuration file first, then in system configuration. If the setting is not found, the function return the specified default value.

EventFlags getButtonSetting(string section, string name, EventFlags default)

Reads a button setting name from setting section section. The section is searched inside the app configuration file first, then in system configuration. If the setting is not found, the function return the specified default value. This function is useful to configure system-dependent button names in an application.

printChildren(node, depth)

Prints the tree of children of node up to the specified depth

overridePanopticStereo(value)

When set to true, switches from panoptic stereo tracking to standard tracking. This option is used only when panoptic stereo is enabled for the current display system.

listTiles()

Return a list of the names of all the tiles used by the current configuration

toggleStereo()

Switches between mono and stereo rendering mode on systems with stereo rendering support.

toggleStats(stats)

Enables or disables statistics output from a specific source in the statitics window. The statistics window must be enabled for the configuration. The stats parameter is a list of statistic or tile names separated by spaces.

Example:

	# Starts displaying statistics for tile 0x0
	toggleStats('0x0')
	
	# Stops displaying statistics for tile 0x0
	toggleStats('0x0')
	
	# Starts displaying statistics for tile 1x0, 1x1, 0x1
	toggleStats('1x0 1x1 0x1')
	
	# Displays statistics for all available sources
	toggleStats('all')
	
	# Displays statistics in compact mode
	toggleStats('compact')

printObjCounts()

Prints a list and count of currently allocated refcounted objects

printModules()

Lists the modules currently active in the application