Constants Reference

Installation Paths (Constants.ahk)

The following constants may be used to refer to all the relevant locations of the Simulator Controller distribution.

kHomeDirectory, kResourcesDirectory, kSourcesDirectory, kIncludesDirectory, kLibrariesDirectory, kPluginsDirectory, kBinariesDirectory, kConfigDirectory

All these constants define paths pointing to a specific folder in the Simulator Controller distribution. In deviation to Windows standards, the paths contain a trailing backslash, since in allmost all cases, a filename will be concatenated to one of these constants in order to access this file.

kSplashMediaDirectory, kScreenImagesDirectory, kButtonBoxImagesDirectory, kIconsDirectory

Paths for graphical and audio resources contained in the Simulator Controller distribution.

kUserHomeDirectory, kUserConfigDirectory, kUserSplashMediaDirectory, kUserScreenImagesDirectory, kUserPluginsDirectory, kLogsDirectory

A special folder Simulator Controller will be created in the user Documents folder. It will contain various subfolders for adding user-specific extensions or substitutions (media, plugins, ...), and for storing configuration and log files.

kSimulatorConfigurationFile, kSimulatorSettingsFile

Paths for the most important configuration files used by Simulator Controller.

---

Global Configuration Map (Constants.ahk)

One global configuration map exists for Simulator Controller, which define the capabilities, the controller mapping and the configuration of all active plugins.

kSimulatorConfiguration

The global configuration map, which is read from kSimulatorConfigurationFile. The content is fully maintained by the configuration tool.

---

Log Levels (Constants.ahk)

See the dcoumentation about Debugging & Logging for more information.

kLogInfo, kLogWarn, kLogCritical, kLogOff

Define the various log levels used by the logging functions. These are numerical values where kLogInfo < kLogWarn < kLogCritical < kLogOff.

---

Controller Function Types (Constants.ahk)

Used to identify the different types of hardware controller functions in a configuration map. See the subclasses of Function for reference.

k1WayToggleType, k2WayToggleType, kButtonType, kDialType, kCustomType

All currently defined controller function types.

---

Miscellaneous Constants (Constants.ahk)

Additional constants used by Simulator Controller.

kUndefined

May be used by functions to denote a default value for optional parameters that might be boolean values.

kVersion

The current version of Simulator Controller according to the VERSION document in the root folder.

kSilentMode

If this is true, most applications of Simulator Controller will adopt accordingly and will not use any splash screens or other visual or audio feedback.

kTrue, kFalse, kActivate, kDeactivate, kIncrease, kDecrease

Miscellaneous constants, which define string representations for often used code constants.