Game Development Reference
In-Depth Information
Python-related Tools
Before you can run the suite, you will need to install some Python-related tools, which you can find in the
CTS\Prerequisites
directory. These include Python itself, the Win32 extensions, wxPython and pyOpenGL. Even
though the suite comes with the correct version of Python, you may have to install more than one version, but only
if your application needs them; some do, some don't. Check the "add software" panel on your computer before
installing anything to see if more recent versions of these tools are already installed. You must use the version
numbers shown in this directory or higher. If your copy of Python isn't installed in the standard location, you may
need to set its path in the config file. On Windows 7 and Vista, you have to install the Python tools as an administrator.
.NET Framework
Unless the Microsoft .NET Framework is installed, the framework won't be able to validate your COLLADA documents
(MSXML is the default validator), and you won't be able to enable crash detection. You can disable crash detection or
specify the timeout value in the config file.
Integration
Integration involves sending information back and forth between the test suite and the target application via a Python
script, which you write, and a config file that you modify. The Python script generates and executes other scripts.
To integrate your target application with the test suite, do the following:
Scripts
directory to map your application. You will usually
copy and modify an existing script.
•
Create the Python script in the
config.txt
in the top-level directory to set up your application path.
•
Update
•
Debug by running a small sample of the suite.
The Config File
The config file is held in the root of the CTS directory. Each line in the config file is a setting, with the description
on the left and the value on the right. Update the config file with the path for your application. Be sure to use a tab
delimiter between the key and value. (Watch for editors that convert tabs to spaces.) Do not leave a blank line at the
end of the file.
The Python Script
The
Scripts
folder of the CTS directory holds a variety of integration scripts:
•
FApplication is the basic script.
•
FMax is the script for Autodesk 3ds Max.
•
FMaya is the script for Autodesk Maya.
•
FMimic is a bare bones script that includes a placeholder for a target application. It doesn't
actually run an application, but it does let you run the tests.
•
FXsi is the script for Autodesk Softimage.
