cg-configuration

The class of the Common Graphics configuration object, which contains a variety of options for the way that Common Graphics behaves, either in the IDE or in a standalone application. Most of the options appear on the Tools | Options dialog, chiefly on the CG tab. The complete set of Common Graphics options may be viewed or modified in the IDE Inspector by using the Tools | Inspect System Data | CG Configuration Options menu command.

The Common Graphics configuration object may also be accessed programmatically with the expression (cg:configuration cg:*system*) (see configuration and *system*). For example, to set the global tooltip delay in a Common Graphics application to 500 milliseconds (the default is 1000), the application's startup code should include the following form:

(setf (tooltip-delay (configuration *system*)) 500)

The IDE normally saves all Common Graphics and IDE configuration options in a allegro-ide-options.cl file, so that future IDE sessions will retain option settings that were made in earlier sessions. (See save-options-on-exit.) In a standalone Common Graphics application, on the other hand, Common Graphics options must be set programmatically in application code, and IDE options are of course not available.

See also ide-configuration, which covers IDE options.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 9.0 page.
Created 2015.5.21.