UserActions: Difference between revisions
Jump to navigation
Jump to search
Dr Eyeball (talk | contribs) (A more complete class definition with all properties, in response to common queries) |
m (Improved link.) |
||
| Line 10: | Line 10: | ||
* '''showWindow''': number/(boolean) - If set to 1 or "true", players see the 'displayNameDefault' name appear near mid screen as they approach the object if the priority is higher than other available actions. Set to 0 or "false" to turn it off. | * '''showWindow''': number/(boolean) - If set to 1 or "true", players see the 'displayNameDefault' name appear near mid screen as they approach the object if the priority is higher than other available actions. Set to 0 or "false" to turn it off. | ||
* '''onlyForPlayer''': number/(boolean) - (Needs clarification.) Probably disables the action appearing in the Action list (option 6) on the main menu for AI. | * '''onlyForPlayer''': number/(boolean) - (Needs clarification.) Probably disables the action appearing in the Action list (option 6) on the main menu for AI. | ||
* '''shortcut''': string - One of the [[ | * '''shortcut''': string - One of the [[:Category:Key Actions|key mapping names]] defined in class 'CfgDefaultKeysMapping' in bin.pbo (e.g. "moveForward"). | ||
* '''condition''': string - Code that must return true for the action to be available. Some standard variables can be used in the evaluation. Variable [[this]] references the object to which action is attached to. (Needs confirmation: there must be a caller variable too (_this?).) | * '''condition''': string - Code that must return true for the action to be available. Some standard variables can be used in the evaluation. Variable [[this]] references the object to which action is attached to. (Needs confirmation: there must be a caller variable too (_this?).) | ||
* '''statement''': string - Code that is executed when the action is activated. Some standard variables can be used in the evaluation. Variable [[this]] references object to which action is attached to. | * '''statement''': string - Code that is executed when the action is activated. Some standard variables can be used in the evaluation. Variable [[this]] references object to which action is attached to. | ||
Revision as of 13:03, 16 March 2011
Description
Defines an action to be associated with the current object class. Commonly used for operating doors on vehicles.
Class Properties
- displayName: string - This is the name displayed in the action menu. It supports structured text syntax, for including icons or changing the text appearance.
- displayNameDefault: string - This is the name displayed near mid screen. It supports structured text syntax, for including icons or changing the text appearance. Often, only an icon is used in this case.
- priority: integer - Priority value of the action. Actions will be arranged descending according to this. Value can be negative or decimal. Actions with same values will be arranged in order which they were made, newest at the bottom. Typical range is 0 (low priority) to 6 (high priority).
- radius: number - Defines the range to the object at which the action will become available. Value is in metres.
- position: string - (Needs clarification.) Probably a named memory point which acts as the centre for the radius check.
- showWindow: number/(boolean) - If set to 1 or "true", players see the 'displayNameDefault' name appear near mid screen as they approach the object if the priority is higher than other available actions. Set to 0 or "false" to turn it off.
- onlyForPlayer: number/(boolean) - (Needs clarification.) Probably disables the action appearing in the Action list (option 6) on the main menu for AI.
- shortcut: string - One of the key mapping names defined in class 'CfgDefaultKeysMapping' in bin.pbo (e.g. "moveForward").
- condition: string - Code that must return true for the action to be available. Some standard variables can be used in the evaluation. Variable this references the object to which action is attached to. (Needs confirmation: there must be a caller variable too (_this?).)
- statement: string - Code that is executed when the action is activated. Some standard variables can be used in the evaluation. Variable this references object to which action is attached to.
Examples
Example 1:
class UserActions
{
class viewHUD
{
displayName = "<img image='\someAddon\images\icon1.paa' size='1' shadow='false' /> Show HUD";
displayNameDefault = "<img image='\someAddon\images\icon1.paa' size='3' shadow='false' />";
priority = 3;
radius = 20;
position = "camera";
showWindow = 0;
onlyForPlayer = 1;
shortcut = "reloadMagazine";
condition = "(player in [gunner this, driver this]) && (alive this)";
statement = "[this, 10] execVM ""\someAddon\scripts\showHUD.sqf"";";
};
};
Additional Information
See also: addAction