{"name":"setTriggerArea","operator":null,"title":"setTriggerArea","type":"command","url":"https://community.bistudio.com/wiki/setTriggerArea","revid":364460,"updated":"2024-05-16T20:41:48Z","groups":["Triggers"],"status":"ok","replaced_by":[],"games":[{"game":"ofpe","name":"Operation Flashpoint: Elite","version":"1.00"},{"game":"arma1","name":"Armed Assault","version":"1.00"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"ofpe","name":"Operation Flashpoint: Elite","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":"global","effect":"local","server_exec":false},"exec":null,"description":"Defines the area monitored by the given trigger. The area could be either rectangular or elliptical.\n\n> [!NOTE]\n> Just like with a and b dimensions, c dimension will alter area in opposite directions from the trigger position along z axis. Therefore if the trigger position is on the surface, half of the trigger area will be above the surface and half below. To place the whole area above the surface, adjust trigger position (move it up c meters). If c is not specified or <= 0, the trigger's height is considered infinite like 2D triggers.","syntaxes":[{"syntax":"trigger setTriggerArea [a, b, angle, isRectangle, c]","since":null,"effect":null,"exec":null,"params":[{"name":"trigger","type":"Object","optional":false,"default":null,"description":"object of the type \"EmptyDetector\"","types":["Object"],"since":null,"text":"trigger: Object - object of the type \"EmptyDetector\""},{"name":"a","type":"Number","optional":false,"default":null,"description":"trigger area X size / 2, in meters","types":["Number"],"since":null,"text":"a: Number - trigger area X size / 2, in meters"},{"name":"b","type":"Number","optional":false,"default":null,"description":"trigger area Y size / 2, in meters","types":["Number"],"since":null,"text":"b: Number - trigger area Y size / 2, in meters"},{"name":"angle","type":"Number","optional":false,"default":null,"description":"trigger area rotation in degrees","types":["Number"],"since":null,"text":"angle: Number - trigger area rotation in degrees"},{"name":"isRectangle","type":"Boolean","optional":false,"default":null,"description":"true if rectangle","types":["Boolean"],"since":null,"text":"isRectangle: Boolean - true if rectangle"},{"name":"c","type":"Number","optional":true,"default":"-1","description":"trigger area Z size / 2, in meters. -1 for infinite height","types":["Number"],"since":"arma3 1.60","text":"c: Number - (Optional, default -1) trigger area Z size / 2, in meters. -1 for infinite height"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"trigger","types":["Object"]},"right":{"text":"[a, b, angle, isRectangle, c]","types":["Array"]}}],"examples":[{"text":"```sqf\n_trigger setTriggerArea [100, 50, 45, false];\n```","code":["_trigger setTriggerArea [100, 50, 45, false];"]},{"text":"```sqf\n_trigger setTriggerArea [100, 50, 45, false, 100];\n```","code":["_trigger setTriggerArea [100, 50, 45, false, 100];"]},{"text":"```sqf\n_trg = createTrigger [\"EmptyDetector\", getPos player, false];\n_trg setTriggerArea [5, 5, 0, false];\n_trg setTriggerActivation [\"CIV\", \"PRESENT\", true];\n_trg setTriggerStatements [\"this\", \"hint 'Civilian near player'\", \"hint 'no civilian near'\"];\n```","code":["_trg = createTrigger [\"EmptyDetector\", getPos player, false];\n_trg setTriggerArea [5, 5, 0, false];\n_trg setTriggerActivation [\"CIV\", \"PRESENT\", true];\n_trg setTriggerStatements [\"this\", \"hint 'Civilian near player'\", \"hint 'no civilian near'\"];"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["triggerArea","createTrigger","setTriggerActivation","setTriggerStatements","setTriggerText","setTriggerTimeout","setTriggerType","inArea","inAreaArray","triggerInterval","setTriggerInterval","enableSimulation","simulationEnabled"],"notes":[],"categories":["ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Triggers","Introduced with Operation Flashpoint: Elite version 1.00","Operation Flashpoint: Elite: New Scripting Commands","Operation Flashpoint: Elite: Scripting Commands","Scripting Commands","Scripting Commands: Local Effect","Take On Helicopters: Scripting Commands"]}