Military Symbols: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "[[Image:" to "[[File:")
 
(24 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Category:ArmA_2:_Editor_Modules]]
{{TOC|side}}
[[Military Symbols]] allow to display units' military symbol in real time either in-game (above units), on map or both.


With Military Symbols it's possible to display units' military symbol in real time either in-game (above units), on map or both.
== Initialization ==


== Initialization==
=== Module Location ===
=== Paths ===
Editor: <code>Modules (F7) > Military Symbols</code>


Data: <code>ca\modules\Marta</code>
* {{arma2}}: Modules (F7)
* {{arma3}} [[:Category:Eden Editor|Eden Editor]]: Systems (F5) > Modules > Other > Military Symbols


=== Enable Icons ===
=== Enable Icons ===
Place "Military Symbols" module and include following in init line [http://forums.bistudio.com/showpost.php?p=1414167&postcount=19]:
:: <pre>setGroupIconsVisible [param1,param2];</pre>
Where:
* param1 (boolean) - enable icons on the map
* param2 (boolean) - enable icons in world, over the group leader`s head


::Example: <pre>setGroupIconsVisible [true,true];</pre>
Place the "Military Symbols" module and include the following code in the init line: <sqf>setGroupIconsVisible [true /* markers on map */, true /* 3D markers */];</sqf>


=== Optional parameters ===
=== Set up Module ===
====Set variables to BIS_marta_mainscope with desired values====


*'''rules = <array>;''' - custom settings which defines how will be each side/faction shown. Array contains of array in format [<prefix>,<markercolor>]. Prefix is one of NATO marker prefixes ("b_" for BLUFOR,"o_" for OPFOR or "n_" for NEUTRAL) and markercolor is color of marker from CfgMarkerColors. If number of array items is 4, it's applied to sides. Otherwise it's applied to factions.
==== Set variables to BIS_marta_mainscope with desired values ====
::Example: <pre>BIS_marta_mainscope setvariable ["rules",[["o_","colorred"],["b_","colorgreen"],["n_","colorgreen"],["n_","coloryellow"]]];</pre>
* '''rules = <array>;''' - custom settings which defines how will be each side/faction shown. Array contains of array in format [<prefix>,<markercolor>]. Prefix is one of NATO marker prefixes ("b_" for BLUFOR,"o_" for OPFOR or "n_" for NEUTRAL) and markercolor is color of marker from CfgMarkerColors. If number of array items is 4, it is applied to sides. Otherwise it is applied to factions.
::Default value: [["o_","colorred"],["b_","colorgreen"],["n_","colorgreen"],["n_","coloryellow"]]
:: Example: <sqf>BIS_marta_mainscope setVariable ["rules", [["o_", "colorred"], ["b_", "colorgreen"], ["n_", "colorgreen"], ["n_", "coloryellow"]]];</sqf>
:: Default value: [["o_", "colorred"], ["b_", "colorgreen"], ["n_", "colorgreen"], ["n_", "coloryellow"]]


*'''delay = <number>;''' - Refresh delay in seconds
To set up colors in RGB format put the following into module`s init line:
::Example: <pre>BIS_marta_mainscope setvariable ["delay",0.1];</pre>
:: Example: <sqf>this setVariable ["rules", [["o_", [0.00001, 1, 0, 1]], ["b_", [1, 0, 0, 1]], ["n_", [0, 0.7, 0, 1]], ["n_", [0.8, 0.8, 0, 0]]], true]</sqf>
::Default value:  0.5
Where array after prefix has format : [Red, Green, Blue, Alpha (transparency)]
 
* '''delay = <number>;''' - Refresh delay in seconds
:: Example: <sqf>BIS_marta_mainscope setVariable ["delay", 0.1];</sqf>
:: Default value:  0.5
<!--
<!--
*'''step = <number>;''' - Time in which are all markers refreshed (0 will halt program until all markers are refreshed, which can cause lag when number of groups is large).
* '''step = <number>;''' - Time in which are all markers refreshed (0 will halt program until all markers are refreshed, which can cause lag when number of groups is large).
::Example: <pre>BIS_marta_mainscope setvariable ["step",1];</pre>
:: Example: <sqf>BIS_marta_mainscope setVariable ["step", 1];</sqf>
::Default value:  0.5
:: Default value:  0.5
-->
-->
*'''duration = <number>;''' - duration defines how long will be markers shown after group get out from detection area (destroyed groups will have 1/10 of this duration)
* '''duration = <number>;''' - duration defines how long will be markers shown after group get out from detection area (destroyed groups will have 1/10 of this duration)
::Example: <pre>BIS_marta_mainscope setvariable ["duration",600];</pre>
:: Example: <sqf>BIS_marta_mainscope setVariable ["duration", 600];</sqf>
::Default value: 300 (=5 minutes)
:: Default value: 300 (5 minutes)


*'''minSize = <number>;''' - Minimal size of group which is requested to draw a marker.
* '''minSize = <number>;''' - Minimal size of group which is requested to draw a marker.
::Example: <pre>BIS_marta_mainscope setvariable ["minSize",3];</pre>
:: Example: <sqf>BIS_marta_mainscope setVariable ["minSize", 3];</sqf>
::Default value: 1
:: Default value: 1
<!--
<!--
*'''offset = <number>;''' - defines how inaccurate will be enemy marker position. Value is maximal possible distance in metres.
* '''offset = <number>;''' - defines how inaccurate will be enemy marker position. Value is maximal possible distance in metres.
::Example: <pre>BIS_marta_mainscope setvariable ["offset",100];</pre>
:: Example: <sqf>BIS_marta_mainscope setVariable ["offset", 100];</sqf>
::Default:  50
:: Default:  50
-->
-->
*'''WPgroups = <array>;''' - Set which groups will have displayed waypoints.
* '''WPgroups = <array>;''' - Set which groups will have displayed waypoints.
::Example: <pre>BIS_marta_mainscope setvariable ["WPgroups",[group soldier1, group player]];</pre>
:: Example: <sqf>BIS_marta_mainscope setVariable ["WPgroups", [group soldier1, group player]];</sqf>
::Default value:  empty array
:: Default value:  empty array
 
=== Set up groups ===
 
* '''MARTA_customIcon = <string>;''' - Define custom marker class for given group
:: Example: <sqf>(group player) setVariable ["MARTA_customIcon", "b_recon"];</sqf>
 
* '''MARTA_WP_isText = <boolean>;''' - true if waypoints numbers are to be displayed
:: Example: <sqf>(group ruOfficer) setVariable ["MARTA_WP_isText", true];</sqf>


====Set variables to group with desired values====
=== Set up units ===
*'''MARTA_customIcon = <string>;''' - Define custom marker class for given group
::Example: <pre>(group player) setvariable ["MARTA_customIcon","b_recon"];</pre>


*'''MARTA_alwaysShow = <boolean>;''' - true if group will be visible no matter of it was already spotted
* '''MARTA_showRules = <array>;''' - Custom show rules of specific unit for given faction (1 is always show, 0 means automatic detection when spotted, -1 is never show).
::Example: <pre>(group ruOfficer) setvariable ["MARTA_alwaysShow",true];</pre>
:: Example: <sqf>player setVariable ["MARTA_showRules", ["USMC", 1, "CDF", 0]];</sqf>
:: (GeneralCarver, 11/27/10) - As of Arma 2 v1.7 and Operation Arrowhead v1.55 this command seems to be ignored in multiplayer, but works in single player.
:: A complete list of factions can be found here: [[faction]]


*'''MARTA_WP_isText = <boolean>;''' - true if waypoints numbers are to be displayed
::Example: <pre>(group ruOfficer) setvariable ["MARTA_WP_isText",true];</pre>


====Set variables to unit with desired values====
* '''MARTA_reveal = <array>;''' - Groups which will be always visible for given unit.
*'''MARTA_showRules = <array>;''' - Custom show rules of specific unit for given faction (1 is always show, 0 means automatic detection when spotted, -1 is never show).
:: Example: <sqf>player setVariable ["MARTA_reveal", [group ruTarget]];</sqf>
::Example: <pre>player setvariable ["MARTA_showRules",["USMC",1,"CDF",0]];</pre>


*'''MARTA_reveal = <array>;''' - Groups which will be always visible for given unit.
* '''MARTA_hide = <array>;''' - Groups which will be always hidden for given unit.
::Example: <pre>player setvariable ["MARTA_reveal",[group ruTarget]];</pre>
:: Example: <sqf>player setVariable ["MARTA_hide", [group usmcPatrol]];</sqf>


*'''MARTA_hide = <array>;''' - Groups which will be always hidden for given unit.
::Example: <pre>player setvariable ["MARTA_hide",[group usmcPatrol]];</pre>


== Functions ==
== Functions ==
<span style="color:red;">'''Functions can't be called in init field of units or init.sqf script. Use some delay before you use them'''</span>
 
{{Feature | important | In {{arma2}} you have to use <sqf inline>waitUntil { not isNil "BIS_fnc_init" };.</sqf>.}}


=== Get visible groups ===
=== Get visible groups ===
[<position, radius>] call BIS_Marta_getVisibleGroups
 
*<position, radius> - none (using whole map data) or both arguments
<sqf>[centre, radius] call BIS_Marta_getVisibleGroups;</sqf>
*Returned value: list of groups that have visible NATO marker (in given circle)
* centre, radius - none (using whole map data) or both arguments
*Returned value: Group - marker associated with group
* Returned value: list of groups that have visible NATO marker (in given circle)
* Returned value: Group - marker associated with group


<!--
<!--
=== Find group by marker ===
=== Find group by marker ===
  ["GROUP",<marker>] call BIS_Marta_getParams
 
*<marker> - one of "BIS_Marta_#" markers
  ["GROUP", <marker>] [[call]] [[BIS_Marta_getParams]]
*Returned value: Group - marker associated with group
* <marker> - one of "BIS_Marta_#" markers
* Returned value: Group - marker associated with group


=== Find marker by group ===
=== Find marker by group ===
  ["MARKER",<group>] call BIS_Marta_getParams
 
*<marker> - group
  ["MARKER", <group>] [[call]] [[BIS_Marta_getParams]]
*Returned value: String - group associated with marker
* <marker> - group
* Returned value: String - group associated with marker


=== Get list of all markers ===
=== Get list of all markers ===
  ["MARKERS"] call BIS_Marta_getParams
 
*Returned value: Array containing all Marta markers
  ["MARKERS"] [[call]] [[BIS_Marta_getParams]]
* Returned value: Array containing all Marta markers


=== Add zone with forced detection ===
=== Add zone with forced detection ===
  ["ADD",<zone>,<factions>,<types>] call BIS_Marta_zone
 
*<zone> - Array or Object - can be array with [center,radius] or trigger
  ["ADD", <zone>, <factions>, <types>] [[call]] [[BIS_Marta_zone]]
*<factions> - Array - array of sides or factions which will have zone available (can contain both, e.g. [resistance,"INS"])
* <zone> - Array or Object - can be array with [center,radius] or trigger
*<types> - Array - Optional param - Filter witch defines what unit classes and subclasses will be detected in zone.
* <factions> - Array - array of sides or factions which will have zone available (can contain both, e.g. [resistance,"INS"])
*Returned value: ID used for deleting zone
* <types> - Array - Optional param - Filter witch defines what unit classes and subclasses will be detected in zone.
* Returned value: ID used for deleting zone


=== Remove zone with forced detection ===
=== Remove zone with forced detection ===
  ["REMOVE",<id>] call BIS_Marta_zone
 
*<id> - Number - ID of zone
  ["REMOVE", <id>] [[call]] [[BIS_Marta_zone]]
*Returned value: True
* <id> - Number - ID of zone
* Returned value: True


=== Check if some unit is in zone ===
=== Check if some unit is in zone ===
  ["CHECK",<unit>] call BIS_Marta_zone
 
*<unit> - Object or Group - Checked unit
  ["CHECK", <unit>] [[call]] [[BIS_Marta_zone]]
*Returned value: Boolean (true if unit is in one of zones)
* <unit> - Object or Group - Checked unit
* Returned value: Boolean (true if unit is in one of zones)
-->
-->




== Marker list ==
== Marker list ==
[[Image:APP-6.jpg|right|]]
[[File:APP-6.jpg|right|]]
 
Icon name consists of '''prefix''' and '''name'''. Prefix is used to define side and can be one of following:


icon name consists of '''prefix''' and '''name'''. Prefix is used to define side and can be one of followings:
{| class="wikitable"
b_ ... BLUFOR
! Value !! Description
o_ ... OPFOR
|-
n_ ... Neutral
| b_ || BLUFOR
|-
| o_ || OPFOR
|-
| n_ || neutral
|}


Name defines purpose of the icon. See picture on the right or code below to get visual list of icons:
Name defines purpose of the icon. See picture on the right or code below to get visual list of icons:
--- Currently used ---
inf - Infantry
motor_inf - Motorized infantry
mech_inf - Mechanized infantry
armor - Armored platoon
air - Rotary wing aircraft
maint - Maintanance group
hq - Headquarters
supply - Supply convoy
plane - Fixed wing aircraft
art - Artillery
mortar - Mortar
med - Medical
recon - Reconnaisance team
uav - Unmanned Aerial Vehicle
empty - Unknown


For example, to set icon of enemy artillery, use prefix ''o_'' and type ''art'' to get ''o_art'' icon type.
{| class="wikitable"
! Value !! Description
|-
| inf || Infantry
|-
| motor_inf || Motorized infantry
|-
| mech_inf || Mechanized infantry
|-
| armor || Armored platoon
|-
| air || Rotary wing aircraft
|-
| maint || Maintanance group
|-
| hq || Headquarters
|-
| supply || Supply convoy
|-
| plane || Fixed wing aircraft
|-
| art || Artillery
|-
| mortar || Mortar
|-
| med || Medical
|-
| recon || Reconnaissance team
|-
| uav || Unmanned Aerial Vehicle
|-
| empty || Unknown
|}
 
For example, to set icon of enemy artillery, use prefix {{hl|o_}} and type {{hl|art}} to get {{hl|o_art}} icon type.


Icons are defined in ''cfgGroupIcons'' section.
Icons are defined in ''cfgGroupIcons'' section.
{{GameCategory|arma2|Editor Modules}}
{{GameCategory|arma3|Editor Modules}}

Latest revision as of 00:11, 21 November 2023

Military Symbols allow to display units' military symbol in real time either in-game (above units), on map or both.

Initialization

Module Location

  • Arma 2: Modules (F7)
  • Arma 3 Eden Editor: Systems (F5) > Modules > Other > Military Symbols

Enable Icons

Place the "Military Symbols" module and include the following code in the init line:

setGroupIconsVisible [true /* markers on map */, true /* 3D markers */];

Set up Module

Set variables to BIS_marta_mainscope with desired values

  • rules = <array>; - custom settings which defines how will be each side/faction shown. Array contains of array in format [<prefix>,<markercolor>]. Prefix is one of NATO marker prefixes ("b_" for BLUFOR,"o_" for OPFOR or "n_" for NEUTRAL) and markercolor is color of marker from CfgMarkerColors. If number of array items is 4, it is applied to sides. Otherwise it is applied to factions.
Example:
BIS_marta_mainscope setVariable ["rules", [["o_", "colorred"], ["b_", "colorgreen"], ["n_", "colorgreen"], ["n_", "coloryellow"]]];
Default value: [["o_", "colorred"], ["b_", "colorgreen"], ["n_", "colorgreen"], ["n_", "coloryellow"]]

To set up colors in RGB format put the following into module`s init line:

Example:
this setVariable ["rules", [["o_", [0.00001, 1, 0, 1]], ["b_", [1, 0, 0, 1]], ["n_", [0, 0.7, 0, 1]], ["n_", [0.8, 0.8, 0, 0]]], true]

Where array after prefix has format : [Red, Green, Blue, Alpha (transparency)]

  • delay = <number>; - Refresh delay in seconds
Example:
BIS_marta_mainscope setVariable ["delay", 0.1];
Default value: 0.5
  • duration = <number>; - duration defines how long will be markers shown after group get out from detection area (destroyed groups will have 1/10 of this duration)
Example:
BIS_marta_mainscope setVariable ["duration", 600];
Default value: 300 (5 minutes)
  • minSize = <number>; - Minimal size of group which is requested to draw a marker.
Example:
BIS_marta_mainscope setVariable ["minSize", 3];
Default value: 1
  • WPgroups = <array>; - Set which groups will have displayed waypoints.
Example:
BIS_marta_mainscope setVariable ["WPgroups", [group soldier1, group player]];
Default value: empty array

Set up groups

  • MARTA_customIcon = <string>; - Define custom marker class for given group
Example:
(group player) setVariable ["MARTA_customIcon", "b_recon"];
  • MARTA_WP_isText = <boolean>; - true if waypoints numbers are to be displayed
Example:
(group ruOfficer) setVariable ["MARTA_WP_isText", true];

Set up units

  • MARTA_showRules = <array>; - Custom show rules of specific unit for given faction (1 is always show, 0 means automatic detection when spotted, -1 is never show).
Example:
player setVariable ["MARTA_showRules", ["USMC", 1, "CDF", 0]];
(GeneralCarver, 11/27/10) - As of Arma 2 v1.7 and Operation Arrowhead v1.55 this command seems to be ignored in multiplayer, but works in single player.
A complete list of factions can be found here: faction


  • MARTA_reveal = <array>; - Groups which will be always visible for given unit.
Example:
player setVariable ["MARTA_reveal", [group ruTarget]];
  • MARTA_hide = <array>; - Groups which will be always hidden for given unit.
Example:
player setVariable ["MARTA_hide", [group usmcPatrol]];


Functions

In Arma 2 you have to use waitUntil { not isNil "BIS_fnc_init" };..

Get visible groups

[centre, radius] call BIS_Marta_getVisibleGroups;

  • centre, radius - none (using whole map data) or both arguments
  • Returned value: list of groups that have visible NATO marker (in given circle)
  • Returned value: Group - marker associated with group


Marker list

APP-6.jpg

Icon name consists of prefix and name. Prefix is used to define side and can be one of following:

Value Description
b_ BLUFOR
o_ OPFOR
n_ neutral

Name defines purpose of the icon. See picture on the right or code below to get visual list of icons:

Value Description
inf Infantry
motor_inf Motorized infantry
mech_inf Mechanized infantry
armor Armored platoon
air Rotary wing aircraft
maint Maintanance group
hq Headquarters
supply Supply convoy
plane Fixed wing aircraft
art Artillery
mortar Mortar
med Medical
recon Reconnaissance team
uav Unmanned Aerial Vehicle
empty Unknown

For example, to set icon of enemy artillery, use prefix o_ and type art to get o_art icon type.

Icons are defined in cfgGroupIcons section.