Main   Class List   Namespace List   Wiki

Console
[Core]

The basis of the TorqueScript system and command execution. More...

Classes

class  ScriptGroup
 Essentially a SimGroup, but with onAdd and onRemove script callbacks. More...
class  ScriptObject
 A script-level OOP object which allows binding of a class, superClass and arguments along with declaration of methods. More...
class  SimDataBlock
 Root DataBlock class. More...
class  SimGroup
 A collection of SimObjects that are owned by the group. More...
class  SimObject
 Base class for almost all objects involved in the simulation. More...
class  SimSet
 A collection of SimObjects. More...

Modules

 Logging
 

Functions for logging messages, warnings, and errors to the console.


 Debugging
 

Functionality to help spot program errors.


 Scripting
 

Functions for working with script code.


 Packages
 

Functions relating to the control of packages.


 Messaging
 

Script classes and functions used for passing messages and events between classes.


Functions

void cls ()
 Clears the console output.
void debugEnumInstances (string className, string functionName)
 Call the given function for each instance of the given class.
void deleteDataBlocks ()
 Delete all the datablocks we've downloaded.
bool dumpEngineDocs (string outputFile)
 Dumps the engine scripting documentation to the specified file overwriting any existing content.
SimXMLDocument exportEngineAPIToXML ()
 Create a XML document containing a dump of the entire exported engine API.
string getCategoryOfClass (string className)
 Returns the category of the given class.
string getDescriptionOfClass (string className)
 Returns the description string for the named class.
bool isClass (string identifier)
 Returns true if the passed identifier is the name of a declared class.
bool isMemberOfClass (string className, string superClassName)
 Returns true if the class is derived from the super class.
bool isValidObjectName (string name)
 Return true if the given name makes for a valid object name.
SimObject loadObject (string filename)
 Loads a serialized object from a file.
void preloadClientDataBlocks ()
 Preload all datablocks in client mode.
bool saveObject (SimObject object, string filename)
 Serialize the object to a file.
void unitTest_runTests ([searchString[, bool skipInteractive]])
 Run unit tests, or just the tests that prefix match against the searchString.

Variables

string $instantGroup
 The group that objects will be added to when they are created.
bool $Con::alwaysUseDebugOutput
 Determines whether to send output to the platform's "debug" system.
bool $Con::logBufferEnabled
 If true, the log buffer will be enabled.
int $Con::printLevel
 This is deprecated.
bool $Con::useTimestamp
 If true a timestamp is prepended to every console message.
bool $Con::warnUndefinedVariables
 If true, a warning will be displayed in the console whenever a undefined variable is used in script.

Detailed Description

The basis of the TorqueScript system and command execution.


Function Documentation

void cls (  ) 

Clears the console output.

void debugEnumInstances ( string  className,
string  functionName 
)

Call the given function for each instance of the given class.

Parameters:
className Name of the class for which to enumerate instances.
functionName Name of function to call and pass each instance of the given class.
Note:
This function is only available in debug builds and primarily meant as an aid in debugging.
void deleteDataBlocks (  ) 

Delete all the datablocks we've downloaded.

This is usually done in preparation of downloading a new set of datablocks, such as occurs on a mission change, but it's also good post-mission cleanup.

bool dumpEngineDocs ( string  outputFile  ) 

Dumps the engine scripting documentation to the specified file overwriting any existing content.

Parameters:
outputFile The relative or absolute output file path and name.
Returns:
Returns true if successful.
SimXMLDocument exportEngineAPIToXML (  ) 

Create a XML document containing a dump of the entire exported engine API.

Returns:
A SimXMLDocument containing a dump of the engine's export information or NULL if the operation failed.
string getCategoryOfClass ( string  className  ) 

Returns the category of the given class.

Parameters:
className The name of the class.
string getDescriptionOfClass ( string  className  ) 

Returns the description string for the named class.

Parameters:
className The name of the class.
Returns:
The class description in string format.
bool isClass ( string  identifier  ) 

Returns true if the passed identifier is the name of a declared class.

bool isMemberOfClass ( string  className,
string  superClassName 
)

Returns true if the class is derived from the super class.

If either class doesn't exist this returns false.

Parameters:
className The class name.
superClassName The super class to look for.
bool isValidObjectName ( string  name  ) 

Return true if the given name makes for a valid object name.

Parameters:
name Name of object
Returns:
True if name is allowed, false if denied (usually because it starts with a number, _, or invalid character
SimObject loadObject ( string  filename  ) 

Loads a serialized object from a file.

Parameters:
Name and path to text file containing the object
void preloadClientDataBlocks (  ) 

Preload all datablocks in client mode.

(Server parameter is set to false). This will take some time to complete.

bool saveObject ( SimObject  object,
string  filename 
)

Serialize the object to a file.

Parameters:
object The object to serialize.
filename The file name and path.
void unitTest_runTests ( [searchString[, bool skipInteractive] ]   ) 

Run unit tests, or just the tests that prefix match against the searchString.


Variable Documentation

string $instantGroup

The group that objects will be added to when they are created.

bool $Con::alwaysUseDebugOutput

Determines whether to send output to the platform's "debug" system.

Note:
This is disabled in shipping builds.
bool $Con::logBufferEnabled

If true, the log buffer will be enabled.

int $Con::printLevel

This is deprecated.

It is no longer in use and does nothing.

bool $Con::useTimestamp

If true a timestamp is prepended to every console message.

bool $Con::warnUndefinedVariables

If true, a warning will be displayed in the console whenever a undefined variable is used in script.



Copyright © GarageGames, LLC. All Rights Reserved.