A.1 - Creating a Custom Configuration File

Table of Contents

• A.1.1 Using Include Statements in DI-Guy Configuration Files

DI-Guy is configured by default to give you access to all the characters available.

If you need to ship a smaller configuration, you can create a configuration file that culls out elements you do not need. You can specify that your new configuration file be used with a call to diguy_set_cfg_file() before calling diguy_*_initialize(). We recommend that you put your configuration in ./custom/config.

For a quick start:

1. Copy diguy.cfg from ./config to ./custom/config/myfastdiguy.cfg. 
2. If you are not using expressive faces, gestures, or motion textures, comment out the lines that refer to them.
3. Change the reference to diguy_characters.cfg to be myfastdiguy_characters.cfg.
4. Change the reference to diguy_actors.cfg to be myfastdiguy_actors.cfg.
5. Change the reference to diguy_appearances.cfg to be myfastdiguy_appearances.cfg.
6. Copy diguy_characters.cfg from ./config/diguy to ./custom/config/diguy/myfastdiguy_characters.cfg.
7. Delete or comment lines referring to characters that you do not plan to use.
8. Copy diguy_actors.cfg from ./config/diguy to ./custom/config/diguy/myfastdiguy_actors.cfg. 
9. Delete or comment lines referring to actors your characters do not need.
10. Copy diguy_appearances.cfg from ./config/diguy to ./custom/config/diguy/myfastdiguy_appearances.cfg. 
11. Comment our lines referring to appearances you do not need.
12. Change the reference to appearances_base.cfg to myfastappearances_base.cfg.
13. Copy appearances_base.cfg from ./config/diguy to ./custom/config/diguy/myfastappearances_base.cfg. 
14. Comment out any unused appearances.

A.1.1 Using Include Statements in DI-Guy Configuration Files

DI-Guy behaves as if a preprocessor executed all of the include lines before DI-Guy started to read the file. The four include directives work as follows:

• include file. Replace the line with the contents of file. Report an error if the file cannot be read.
• include_once file. Replace the line with the contents of file, unless file has already been included. Report an error if file cannot be read.
• include_optional file. Replace the line with the contents of file. Do not report an error if file cannot be read.
• include_optional_once file. Replace the line with the contents of file, unless file has already been included. Do not report an error if file cannot be read.

[Home] [Top of Page]