Using Modifier Keys
cInput supports the use of modifier keys. You can designate a key to be used as a modifier with
AddModifier(). Note that once a key has been designated as a modifier, it is forbidden from being used as an input all by itself. For example, if you designate
LeftShift as a modifier, then it can be used in multiple key combinations such as
LeftShift+1, but it cannot be used alone as just
LeftShift. To define an action to use a modifier key by default, create it in your setup script with
SetKey(), passing in the modifiers you want to use.
Modifier keys do not work with axes! If you use
SetKey() to define an action that uses a modifier, and then use that action with
SetAxis() to create an axis, the axis won't care if the modifier is pressed or not.
For example, say you have defined an action named
"Assign Group 1" which uses
LeftControl+Alpha1 (Ctrl+1) as the keys to activate it. If you then create an axis which uses
"Assign Group 1" as one of its inputs, then simply pressing
1 on your keyboard will activate the axis whether or not the
LeftControl key is being pressed.
If you have added a key as a modifier and would like to remove it from being used as a modifier, use