BIS fnc moduleCoverMap: Difference between revisions

Latest revision as of 09:51, 20 January 2024

Hover & click on the images for description

Description

Description:

Covers the map except for a defined area. This function was designed to be used by the Modules framework, but it can also be used without the module. The effect does not move with the centerObject.

⚠

It is essential for the function to work that centerObject has the objectArea variable defined.

centerObject setVariable ["objectArea", [sizeX, sizeY, rotation]]

centerObject: Object - object which is used as center
sizeX: Number - length in x in meters
sizeY: Number - length in y in meters
rotation: Number - shape's rotation in degree

Execution:

call

Groups:

Modules Map and Markers

Syntax

Syntax:: [centerUnit, units, init] call BIS_fnc_moduleCoverMap
Parameters:: centerUnit: Object - object which is used as center
: units: Array - Not used inside the function
: init: Boolean - true to create cover map effect, false to remove all markers and destroy the effect
Return Value:: Nothing

Examples

Example 1:: // covers the whole map except an area of 1000m by 1000m // can be used to dynamically change size of the area during mission centerObject setVariable ["objectArea",[1000, 1000, 0]]; // same format with triggerArea, except the function only needs first three [centerObject, [], true] call BIS_fnc_moduleCoverMap;

Additional Information

See also:: showMap

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

@@ Line 1: / Line 1: @@
+{{RV|type=function
-{{Function|= Comments
+|game1= arma3
-____________________________________________________________________________________________
+|version1= 1.00
-| arma3 |= Game name
+|gr1= Modules
-|1.00|= Game version
+|gr2= Map and Markers
-____________________________________________________________________________________________
-| {{wip}}Covers the map except a defined area to highlight the area of operation. Works on dedicated server. This function was designed to be used by the [[Modules|Modules framework]], but it can also be used with module.<br><br>It's essential for the function to work that '''centerUnit''' has the variable '''objectArea''' defined.<br>
+|eff= global
-<code>_centerObject [[setVariable]] ["objectArea",[sizeX,sizeY,rotation,unused,unused]]</code>|DESCRIPTION=
-____________________________________________________________________________________________
-| [centerUnit,units,init] call [[BIS_fnc_moduleCoverMap]]|SYNTAX=
+|descr= [[File:BIS_fnc_moduleCoverMap.jpg|right|500px]]
+Covers the map except for a defined area. This function was designed to be used by the [[Modules|Modules framework]], but it can also be used without the module. The effect does not move with the centerObject.
-|p1= centerUnit: [[Object]] - Unit which is used as center|Parameter 1=
+{{Feature|important|
-|p2= units: [[Array]] - '''Not used inside the function'''|Parameter 2=
+It is essential for the function to work that '''centerObject''' has the '''objectArea''' variable defined.
-|p3= init: [[Boolean]] - [[True]] to create cover map effect, [[false]] to remove all markers and destroy the effect|Parameter 3=
+<sqf>centerObject setVariable ["objectArea", [sizeX, sizeY, rotation]]</sqf>
+* centerObject: [[Object]] - object which is used as center
+* sizeX: [[Number]] - length in x in meters
+* sizeY: [[Number]] - length in y in meters
+* rotation: [[Number]] - shape's rotation in degree
+}}
-| |RETURNVALUE=
+|s1= [centerUnit, units, init] call [[BIS_fnc_moduleCoverMap]]
-____________________________________________________________________________________________
-|x1= <code>_centerObject [[setVariable]] ["objectArea",[1000,0000,0,[[false]],0]];
+|p1= centerUnit: [[Object]] - object which is used as center
-[_centerObject,[],[[true]] ] [[call]] [[BIS_fnc_moduleCoverMap]];//Covers the whole map except an area of 1000 m by 1000 m, can be used to dynamically change size of the area during mission</code> |=
-____________________________________________________________________________________________
-| |SEEALSO=
+|p2= units: [[Array]] - '''Not used inside the function'''
-}}
+|p3= init: [[Boolean]] - [[true]] to create cover map effect, [[false]] to remove all markers and destroy the effect
-<h3 style="display:none">Notes</h3>
+|r1= [[Nothing]]
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
+|x1= <sqf>
-</dl>
+// covers the whole map except an area of 1000m by 1000m
+// can be used to dynamically change size of the area during mission
+centerObject setVariable ["objectArea",[1000, 1000, 0]];	// same format with [[triggerArea]], except the function only needs first three
+[centerObject, [], true] call BIS_fnc_moduleCoverMap;
+</sqf>
-<h3 style="display:none">Bottom Section</h3>
+|seealso= [[showMap]]
-[[Category:Function Group: Misc|{{uc:moduleCoverMap}}]]
+}}
-[[Category:Functions|{{uc:moduleCoverMap}}]]
-[[Category:{{Name|arma3}}: Functions|{{uc:moduleCoverMap}}]]