BIS fnc setUnitInsignia: Difference between revisions

Revision as of 19:42, 7 April 2021

Hover & click on the images for description

Description:: Sets unit insignia (e.g., shoulder insignia on soldiers). See Arma 3: Unit Insignia for more details and a list of official insignias.
Execution:: call
Multiplayer:: ⚠
This function must not be remoteExecuted.
Groups:: Object Manipulation

Syntax:: [target, className] call BIS_fnc_setUnitInsignia
Parameters:: target: Object - unit to which the insignia is going to be attached
: class: String - CfgUnitInsignia class name to use. Use an empty string to remove the current insignia.
Return Value:: Boolean - Returns true if successful.

Example 1:: Place insignia: [player, "111thID"] call BIS_fnc_setUnitInsignia;
Example 2:: Remove insignia: [player, ""] call BIS_fnc_setUnitInsignia;

: 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 August 9, 2016 2300
Pierre MGI: In Arma 3: Unit Insignia, you can read:
«
« You can add a new insignia in Config.cpp and Description.ext. »

If it is possible to add a cfgUnitInsignia class in a description.ext, please note that the path of the texture differs for server and client in MP environment. Config.cpp (addon) is more reliable. Description.ext, in this case, should be used for SP mission only.
This function calls setObjectTextureGlobal, which is a broken command in MP (see feedback tracker) August 2016.

@@ Line 34: / Line 34: @@
 <dd class="notedate">Posted on August 9, 2016 2300</dd>
 <dt class="note>[[User:Pierre MGI|Pierre MGI]]
-<dd class="note">In [[Arma 3 Unit Insignia]], you can read:
+<dd class="note">In [[Arma 3: Unit Insignia]], you can read:
 {{Feature|quote|You can add a new insignia in Config.cpp and Description.ext.}}
 If it is possible to add a cfgUnitInsignia class in a description.ext, please note that the path of the texture differs for server and client in MP environment.