Configuring the application node

This page provides a complete list of all the configuration parameters for the Chromium application node/faker.

Examples of setting app node parameters:

	node = CRApplicationNode()
	node.Conf( 'application', 'atlantis' )
	node.Conf( 'minimum_window_size', [300, 300] )
	node.Conf( 'match_window_title', 'perfly' )
	node.Conf( 'show_cursor', 1 )

Parameter Name Value Types Description
application String This options specifies the application (and command line arguments) to be run by the application node. This option is equivalent to calling the appNode.SetApplication() function.
start_dir String This option specifies the directory to change to before starting the application program. This is equivalent to calling the appNode.StartDir() function.
client_dll String This option specifies the directory to search for the crfaker library. Setting this option is equivalent to calling the appNode.ClientDLL() function.
spu_dir String This options specifies the directory to search for Chromium SPU DLLs. Setting this option is equivalent to calling the appNode.SPUDir() function.
track_window_size Boolean This option controls whether Chromium monitors the application window for size changes. When this is enabled and the application window is resized the head SPU's WindowSize() function will be called with the new window dimensions. This is useful for dynamic tile sorting. The default is false/0.
track_window_position Boolean This option controls whether Chromium monitors the application window for position changes. When this is enabled and the application window is moved the head SPU's WindowPosition() function will be called with the new window position. This is useful for DMX. The default is false/0.
track_window_visibility Boolean This option controls whether Chromium monitors the application window for visibility. When this is enabled and the application window is hidden or displayed (aka mapped/unmapped) the head SPU's WindowShow() function will be called with the new visibility state. This is useful for Performer which creates a log of temporary windows during start-up that otherwise just clutter the screen. The default is false/0.
minimum_window_size 2 Integers This option is useful for running multi-context, multi-window OpenGL applications. It specifies the minimum window size (width and height) that Chromium should be allowed to render into. Smaller windows will be rendered into by the native OpenGL library.
maximum_window_size 2 Integers This option is useful for running multi-context, multi-window OpenGL applications. It specifies the maximum window size (width and height) that Chromium should be allowed to render into. NOTE: This must be used alongside the minimum_window_size parameter above. This allows to Chromium to clamp a certain window size.
match_window_title String This option is also useful for running multi-context, multi-window OpenGL applications. It specifies the name of the window which Chromium should render into. The name of a window is usually displayed in the titlebar at the top of a window. All other OpenGL windows will be rendered by the native OpenGL library. Wildcard prefixes and suffixes are allowed. For example: 'Model*' will cause Chromium to render into the first OpenGL window it finds that has a name beginning with 'Model'.
match_window_count Integer Specifies that the Nth OpenGL window created should be rendered by Chromium (other windows will use native OpenGL). As with the above options, this is useful for multi-window OpenGL applications.
ignore_window_list Multiple Integers Specifies that the Nth OpenGL window created should be rendered by the native OpenGL library. You can specify multiple integers here and they must be comma separated with no spaces. As with the above options, this is useful for multi-window OpenGL applications.
show_cursor Boolean This option causes a virtual cursor to be displayed on the render servers which tracks the location of the user's mouse. This feature is a bit of a hack and doesn't always work well. The main restriction is that the virtual cursor is only redrawn during SwapBuffers. Programs which continuously redraw their display, like the atlantis demo work reasonably well. Other programs which only occasionally redraw their display don't work as well. Specify '0' or '1' as the value. The default is 0.
Note: This option must also be set on the render SPU to make this work.
In the long run, a better solution will hopefully be implemented.
system_gl_path string Specifies the directory to find the system OpenGL library. This can be useful when an application uses a combination of Chromium and native OpenGL contexts. Default is "" (empty string).
ignore_freeglut_menus Integer If set, render freeglut's pop-up menus with native OpenGL instead of with Chromium. Default is 1 (set).