visibleMap: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]3(\|.*)\]\]" to "{{GameCategory|arma3|Scripting Commands}}")
m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma2 |Game name=
|game1= arma2
|version1= 1.00


|1.00|Game version=
|game2= arma2oa
|version2= 1.50


|gr1= Map |GROUP1=
|game3= tkoh
|version3= 1.00


|gr2= Interaction |GROUP2=
|game4= arma3
____________________________________________________________________________________________
|version4= 0.50


| Return true if the main map is shown (active). |DESCRIPTION=
|gr1= Map
____________________________________________________________________________________________


| '''visibleMap''' |SYNTAX=
|gr2= Interaction


|p1= |PARAMETER1=  
|descr= Return true if the main map is shown (active). In {{arma3}} it also returns true if the respawn screen map is visible.


|p2= |PARAMETER2=  
|s1= [[visibleMap]]


|p3= |PARAMETER3=  
|r1= [[Boolean]]


| [[Boolean]] |RETURNVALUE=  
|x1= <sqf>if (visibleMap) then {hint "You're showing the map !"};</sqf>


 
|seealso= [[forceMap]] [[openMap]]
|x1= <code>if (visibleMap) then {hint "You're showing the map !"}</code>|EXAMPLE1=
 
____________________________________________________________________________________________
 
| [[forceMap]], [[openMap]] |SEEALSO=
 
|  |MPBEHAVIOUR=
____________________________________________________________________________________________
}}
}}


<h3 style='display:none'>Notes</h3>
<dl class="command_description">
<dl class='command_description'>
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on 13 November 2017
<dt><dt>
<dt class="note>'''[[User:Jamesadamar|James]]'''
<dd class="notedate">Posted on 13 November 2017</dd>
<dt class="note">[[User:Jamesadamar|James]]</dt>
<dd class="note">
<dd class="note">
[[visibleMap]] does not work in all cases where a map might be part of a dialog like in a uav terminal or in a artillery computer dialog. Some of these cases can be covered with an [[addMissionEventHandler]] of type "Map". Just use the two magic variables     'mapIsOpened' and 'mapIsForced'. Skeleton might look something like
[[visibleMap]] does not work in all cases where a map might be part of a dialog like in a uav terminal or in a artillery computer dialog.
<pre>
Some of these cases can be covered with an [[addMissionEventHandler]] of type "Map".
Just use the two magic variables 'mapIsOpened' and 'mapIsForced'. Skeleton might look something like:
<sqf>
// update marker as long as map is open (works for uav stations as well)
// update marker as long as map is open (works for uav stations as well)
J_myGPSEH = addMissionEventHandler ["Map", {
J_myGPSEH = addMissionEventHandler ["Map", {
  params ["_mapIsOpened", "_mapIsForced"];


  if (_mapIsOpened) then {
params ["_mapIsOpened", "_mapIsForced"];
    systemChat "GPS aktiv";
    J_var_GPSOn = true;
   
    // no sheduled environment -> create one
    /* Triggered when map is opened or closed either by user action or script command openMap. */
    [] spawn {
      waitUntil{
        ... // do something as long as map is open;
        not J_var_GPSOn
      };
    };
  } else {
    J_var_GPSOn = false;
    systemChat "GPS inaktiv";
  };
}];
</pre>


if (_mapIsOpened) then
{
systemChat "GPS active";
J_var_GPSOn = true;


// no sheduled environment -> create one
/* Triggered when map is opened or closed either by user action or script command openMap. */
0 spawn {
waitUntil {
// ... // do something as long as map is open
not J_var_GPSOn
};
};
} else {
J_var_GPSOn = false;
systemChat "GPS inactive";
};
}];
</sqf>
</dd>


<!-- Note Section END -->
</dl>
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 19:43, 3 September 2024

Hover & click on the images for description

Description

Description:
Return true if the main map is shown (active). In Arma 3 it also returns true if the respawn screen map is visible.
Groups:
MapInteraction

Syntax

Syntax:
visibleMap
Return Value:
Boolean

Examples

Example 1:
if (visibleMap) then {hint "You're showing the map !"};

Additional Information

See also:
forceMap openMap

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
Posted on 13 November 2017
James
visibleMap does not work in all cases where a map might be part of a dialog like in a uav terminal or in a artillery computer dialog. Some of these cases can be covered with an addMissionEventHandler of type "Map". Just use the two magic variables 'mapIsOpened' and 'mapIsForced'. Skeleton might look something like:
// update marker as long as map is open (works for uav stations as well) J_myGPSEH = addMissionEventHandler ["Map", { params ["_mapIsOpened", "_mapIsForced"]; if (_mapIsOpened) then { systemChat "GPS active"; J_var_GPSOn = true; // no sheduled environment -> create one /* Triggered when map is opened or closed either by user action or script command openMap. */ 0 spawn { waitUntil { // ... // do something as long as map is open not J_var_GPSOn }; }; } else { J_var_GPSOn = false; systemChat "GPS inactive"; }; }];