{"name":"reveal","operator":null,"title":"reveal","type":"command","url":"https://community.bistudio.com/wiki/reveal","revid":369307,"updated":"2024-09-03T18:42:54Z","groups":["Object Manipulation"],"status":"ok","replaced_by":[],"games":[{"game":"ofp","name":"Operation Flashpoint","version":"1.00"},{"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":"ofp","name":"Operation Flashpoint","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":"global","effect":"local","server_exec":false},"exec":null,"description":"Reveals a target to a group. If *toWhom* is a unit, unit's group is considered. If *toWhom* is a vehicle, vehicle commander's group is considered.  The knowledge value will be set to the highest level any unit of the revealing side has about the revealed target. If the revealing side has *no* knowledge about the revealed target, the value will be set to 1.\n\n> [!NOTE]\n> The knowledge level can only be increased by this command, not decreased. Use forgetTarget first if you need to decrease value.","syntaxes":[{"syntax":"toWhom reveal target","since":null,"effect":null,"exec":null,"params":[{"name":"toWhom","type":"Object or Group","optional":false,"default":null,"description":"which receives revealing information","types":["Object","Group"],"since":null,"text":"toWhom: Object or Group - which receives revealing information"},{"name":"target","type":"Object","optional":false,"default":null,"description":"which is revealed","types":["Object"],"since":null,"text":"target: Object - which is revealed"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"toWhom","types":["Object","Group"]},"right":{"text":"target","types":["Object"]}},{"syntax":"toWhom reveal [target, accuracy]","since":"arma2oa 1.60","effect":null,"exec":null,"params":[{"name":"toWhom","type":"Object or Group","optional":false,"default":null,"description":"which receives revealing information","types":["Object","Group"],"since":null,"text":"toWhom: Object or Group - which receives revealing information"},{"name":"target","type":"Object","optional":false,"default":null,"description":"which is revealed","types":["Object"],"since":null,"text":"target: Object - which is revealed"},{"name":"accuracy","type":"Number","optional":false,"default":null,"description":"knowledge value, clamped to 0..4 range","types":["Number"],"since":null,"text":"accuracy: Number - knowledge value, clamped to 0..4 range"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"toWhom","types":["Object","Group"]},"right":{"text":"[target, accuracy]","types":["Array"]}}],"examples":[{"text":"```sqf\n_soldierOne reveal _soldierTwo; // soldierOne knowsAbout information about soldierTwo is updated\n```","code":["_soldierOne reveal _soldierTwo; // soldierOne knowsAbout information about soldierTwo is updated"]},{"text":"```sqf\nplayer reveal cursorObject; // player knowsAbout information about object under cursor is updated\n```","code":["player reveal cursorObject; // player knowsAbout information about object under cursor is updated"]},{"text":"```sqf\n_soldierOne reveal [_soldierTwo, 1.5];\n```","code":["_soldierOne reveal [_soldierTwo, 1.5];"]}],"multiplayer":"targetKnowledge and knowsAbout information only get updated on the PC where this command was executed.","problems":null,"aliases":[],"see_also":["nearTargets","knowsAbout","forgetTarget","ignoreTarget"],"notes":[],"categories":["ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Object Manipulation","Introduced with Operation Flashpoint version 1.00","Operation Flashpoint: Elite: Scripting Commands","Operation Flashpoint: New Scripting Commands","Operation Flashpoint: Scripting Commands","Scripting Commands","Scripting Commands: Local Effect","Take On Helicopters: Scripting Commands"]}