createTrigger: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(alt syntax)
(Object supported for position)
Line 38: Line 38:
|p1= [type, position]: [[Array]] |= Parameter 1
|p1= [type, position]: [[Array]] |= Parameter 1
|p2= type: [[String]] |= Parameter 2
|p2= type: [[String]] |= Parameter 2
|p3= position: [[Position]] |= Parameter 3
|p3= position: [[Position2D]], [[Position3D]] or [[Object]] |= Parameter 3


| [[Object]] |= Return value
| [[Object]] |= Return value
Line 46: Line 46:
|p21= [type, position, makeGlobal]: [[Array]] |= Parameter 1
|p21= [type, position, makeGlobal]: [[Array]] |= Parameter 1
|p22= type: [[String]] |= Parameter 2
|p22= type: [[String]] |= Parameter 2
|p23= position: [[Position]] |= Parameter 3
|p23= position: [[Position2D]], [[Position3D]] or [[Object]] |= Parameter 3
|p24= makeGlobal: [[Boolean]] - locality flag, true - trigger is global {{EffArg|cmd|eff|glob}}, false - trigger is local {{EffArg|cmd|eff|local}} |= Parameter 3
|p24= makeGlobal: [[Boolean]] - locality flag, true - trigger is global {{EffArg|cmd|eff|glob}}, false - trigger is local {{EffArg|cmd|eff|local}} |= Parameter 3



Revision as of 13:15, 21 June 2015

-wrong parameter ("Arma") defined!-1.00
Hover & click on the images for description

Description

Description:
Creates a sensor (trigger) of the given type and at the given position. The type must be a class name in CfgNonAIVehicles or CfgVehicles with simulation = detector. An array containing all units that have activated the trigger is available via list triggerobj. Created triggers can be deleted using deleteVehicle.

NOTE: Since Arma 3 v1.43.129935 triggers can be created locally on clients using the alternative syntax.

Triggers are created with default params, which are:
  • a - 50.0
  • b - 50.0
  • angle - 0
  • rectangular - false
  • activationBy - None
  • activationType - Present
  • repeating - false
  • timeoutMin - 0
  • timeoutMid - 0
  • timeoutMax - 0
  • interruptable - true
  • type - None
  • text - ""
  • name - ""
  • expCond - "this"
  • expActiv - ""
  • expDesactiv - ""
Multiplayer:
Triggers are global and will be present on all machine(s) when this command is run.
Groups:
Uncategorised

Syntax

Syntax:
createTrigger [type, position]
Parameters:
[type, position]: Array
type: String
position: Position2D, Position3D or Object
Return Value:
Object

Alternative Syntax

Syntax:
createTrigger [type, position, makeGlobal]         (available since Arma 3 v1.43.129935)
Parameters:
[type, position, makeGlobal]: Array
type: String
position: Position2D, Position3D or Object
makeGlobal: Boolean - locality flag, true - trigger is global Template:EffArg, false - trigger is local Template:EffArg
Return Value:
Object

Examples

Example 1:
_trg = createTrigger ["EmptyDetector", getPos player]; _trg setTriggerArea [5, 5, 0, false]; _trg setTriggerActivation ["CIV", "PRESENT", true]; _trg setTriggerStatements ["this", "hint 'Civilian near player'", "hint 'no civilian near'"];

Additional Information

See also:
setTriggerActivationsetTriggerAreasetTriggerStatementssetTriggerTextsetTriggerTimeoutsetTriggerTypesetEffectConditionsetSoundEffectsetMusicEffectsetTitleEffectdeleteVehiclesynchronizeWaypointsynchronizeTrigger

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Notes

Posted on March 6, 2013 - 14:15 (CEST)
teaCup
Calling list immediately after creating a trigger this way (and setting up activation, area, statements, timeout, etc..), will return <null> instead of an array. It seems the trigger needs about 1 second to initialise, after which it will behave as expected: returning an array of all the objects inside the trigger (the ones matching the criteria), or an empty array.

Bottom Section