reveal: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "|PARAMETER3= |r2=" to "|PARAMETER23= |r2=") |
Lou Montana (talk | contribs) |
||
Line 1: | Line 1: | ||
{{Command|Comments= | {{Command|Comments= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
Line 12: | Line 7: | ||
|arg= global |Multiplayer Arguments= | |arg= global |Multiplayer Arguments= | ||
|eff= local |Multiplayer Effects= | |eff= local |Multiplayer Effects= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| 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 [[knowsAbout|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. | | 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 [[knowsAbout|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.<br><br> | ||
Since ARMA 2 OA 1.60 the alternative syntax is available. Values greater than or equal 1.5 reveal the side of the target, too. The knowledge level can only be increased, not decreased by this command. Use [[forgetTarget]] first if you need to decrease value.<br><br> | |||
{{Informative | In multiplayer, [[targetKnowledge]] and [[knowsAbout]] infos get updated only on the PC where command was executed.}} |DESCRIPTION= | |||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| toWhom | | toWhom [[reveal]] target |SYNTAX= | ||
|p1= toWhom: [[Object]] or [[Group]] which receives revealing information|PARAMETER1= | |p1= toWhom: [[Object]] or [[Group]] which receives revealing information|PARAMETER1= | ||
Line 31: | Line 27: | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|s2= toWhom | |s2= toWhom [[reveal]] [target, accuracy] |SYNTAX2= | ||
|p21= toWhom: [[Object]] or [[Group]] which receives revealing information|PARAMETER21= | |p21= toWhom: [[Object]] or [[Group]] which receives revealing information|PARAMETER21= | ||
Line 37: | Line 33: | ||
|p22= target: [[Object]] which is revealed |PARAMETER22= | |p22= target: [[Object]] which is revealed |PARAMETER22= | ||
|p23= accuracy: [[Number]] - knowledge value, clamped to 0 | |p23= accuracy: [[Number]] - knowledge value, clamped to 0..4 range |PARAMETER23= | ||
|r2= [[Nothing]]|= | |r2= [[Nothing]]|RETURNVALUE2= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|x1= <code>_soldierOne [[reveal]] _soldierTwo; | |x1= <code>_soldierOne [[reveal]] _soldierTwo; {{cc|soldierOne [[knowsAbout]] information about soldierTwo is updated}}</code> |EXAMPLE1= | ||
|x2= <code>[[player]] [[reveal]] [[cursorObject]]; | |||
|x2= <code>[[player]] [[reveal]] [[cursorObject]]; {{cc|player [[knowsAbout]] information about object under cursor is updated}}</code> |EXAMPLE2= | |||
|x3= <code>_soldierOne [[reveal]] [_soldierTwo, 1.5];</code> |EXAMPLE3= | |x3= <code>_soldierOne [[reveal]] [_soldierTwo, 1.5];</code> |EXAMPLE3= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| [[nearTargets]], [[knowsAbout]], [[forgetTarget]] |SEEALSO= | | [[nearTargets]], [[knowsAbout]], [[forgetTarget]] |SEEALSO= | ||
}} | }} | ||
Line 56: | Line 53: | ||
<dd class="notedate">Posted on January 15, 2007 | <dd class="notedate">Posted on January 15, 2007 | ||
<dt class="note"> | <dt class="note">[[User:Ceeeb|Ceeeb]] | ||
<dd class="note">In '''OFP v1.96''', When a target is revealed to a unit, | <dd class="note">In '''OFP v1.96''', When a target is revealed to a unit, its knowsAbout rating is set to 1, unless it was already more than 1 in which case reveal does nothing. See [[knowsAbout]] for more details about knowsAbout ratings and limitations. | ||
<dd class="notedate">Posted on January 24, 2008 | <dd class="notedate">Posted on January 24, 2008 | ||
<dt class="note"> | <dt class="note">[[User:Doolittle|Doolittle]] | ||
<dd class="note">Use reveal to allow client to ''see'' a [[createVehicle|created vehicle]] faster - the associated menu interaction will become available therefore, like the player has option to get in sooner. | <dd class="note">Use reveal to allow client to ''see'' a [[createVehicle|created vehicle]] faster - the associated menu interaction will become available therefore, like the player has option to get in sooner. | ||
<code>_tank = "M1A1" createVehicle (position player); | |||
player reveal _tank; | |||
{{cc|get in user actions become available instantly}}</code> | |||
<dd class="notedate">Posted on January 15, 2012 | <dd class="notedate">Posted on January 15, 2012 | ||
<dt class="note"> | <dt class="note">[[User:kju|kju]] | ||
<dd class="note">The same idea from Doolittle's note applies to beaming of units. If you [[setPos]] an unit or a player, reveal (all) nearby objects and vehicles to make the interaction possible a lot quicker. | <dd class="note">The same idea from Doolittle's note applies to beaming of units. If you [[setPos]] an unit or a player, reveal (all) nearby objects and vehicles to make the interaction possible a lot quicker. | ||
<dd class="notedate">Posted on January 15, 2012 | <dd class="notedate">Posted on January 15, 2012 | ||
<dt class="note"> | <dt class="note">[[User:kju|kju]] | ||
<dd class="note">Revealing a targetUnit will also add it to [[nearTargets]] database of the given sourceUnit. The quality/detail level of the info depends on the [[knowsAbout]] value used with reveal. More detail in the [[nearTargets]] page. | <dd class="note">Revealing a targetUnit will also add it to [[nearTargets]] database of the given sourceUnit. The quality/detail level of the info depends on the [[knowsAbout]] value used with reveal. More detail in the [[nearTargets]] page. | ||
Line 79: | Line 75: | ||
<h3 style="display:none">Bottom Section</h3> | <h3 style="display:none">Bottom Section</h3> | ||
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]] | |||
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]] | |||
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]] | |||
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]] | [[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]] | ||
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]] | |||
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]] | [[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]] | ||
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]] | [[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]] |
Revision as of 15:02, 3 September 2019
Description
- 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.
Since ARMA 2 OA 1.60 the alternative syntax is available. Values greater than or equal 1.5 reveal the side of the target, too. The knowledge level can only be increased, not decreased by this command. Use forgetTarget first if you need to decrease value.
- Groups:
- Uncategorised
Syntax
- Syntax:
- toWhom reveal target
- Parameters:
- toWhom: Object or Group which receives revealing information
- target: Object which is revealed
- Return Value:
- Nothing
Alternative Syntax
- Syntax:
- toWhom reveal [target, accuracy]
- Parameters:
- toWhom: Object or Group which receives revealing information
- target: Object which is revealed
- accuracy: Number - knowledge value, clamped to 0..4 range
- Return Value:
- Nothing
Examples
- Example 1:
_soldierOne reveal _soldierTwo; // soldierOne knowsAbout information about soldierTwo is updated
- Example 2:
player reveal cursorObject; // player knowsAbout information about object under cursor is updated
- Example 3:
_soldierOne reveal [_soldierTwo, 1.5];
Additional Information
- See also:
- nearTargetsknowsAboutforgetTarget
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 January 15, 2007
- Ceeeb
- In OFP v1.96, When a target is revealed to a unit, its knowsAbout rating is set to 1, unless it was already more than 1 in which case reveal does nothing. See knowsAbout for more details about knowsAbout ratings and limitations.
- Posted on January 24, 2008
- Doolittle
- Use reveal to allow client to see a created vehicle faster - the associated menu interaction will become available therefore, like the player has option to get in sooner.
_tank = "M1A1" createVehicle (position player); player reveal _tank; // get in user actions become available instantly
- Posted on January 15, 2012
- kju
- The same idea from Doolittle's note applies to beaming of units. If you setPos an unit or a player, reveal (all) nearby objects and vehicles to make the interaction possible a lot quicker.
- Posted on January 15, 2012
- kju
- Revealing a targetUnit will also add it to nearTargets database of the given sourceUnit. The quality/detail level of the info depends on the knowsAbout value used with reveal. More detail in the nearTargets page.
Bottom Section
- Posted on October 21, 2014 - 15:37 (UTC)
- Killzone Kid
-
Units that have been previously subjected to enableSimulation false; or enableSimulationGlobal false; may stay unrecognised for a long time even after simulation was re-enabled, returning objNull as cursorTarget. Force revealing units with reveal command usually solves the problem. For example:
{player reveal _x} forEach allUnits;
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.00
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Command Group: Uncategorised
- Scripting Commands: Local Effect
- Scripting Commands OFP 1.46
- Scripting Commands OFP 1.96
- Scripting Commands OFP 1.99
- Scripting Commands ArmA
- Scripting Commands ArmA2
- Scripting Commands Arma 3
- Scripting Commands Take On Helicopters