setMarkerColor: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Specified alpha colors are only in Arma 2)
No edit summary
 
(67 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.21


|1.21|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| Set marker color. Color is one of:
|game3= arma1
* '''"Default"'''
|version3= 1.00
* '''"ColorBlack"'''
* '''"ColorGrey"'''
* '''"ColorRed"'''
* '''"ColorRedAlpha"''' (Arma 2 only)
* '''"ColorGreen"'''
* '''"ColorGreenAlpha"''' (Arma 2 only)
* '''"ColorBlue"'''
* '''"ColorYellow"'''
* '''"ColorOrange"'''
* '''"ColorWhite"'''
* '''"ColorPink"'''
* '''"ColorBrown"'''
* '''"ColorKhaki"'''
* '''"ColorWEST"'''
* '''"ColorEAST"'''
* '''"ColorGUER"'''
* '''"ColorCIV"'''
* '''"ColorUNKNOWN"'''
* '''"Color1_FD_F"''' (Light red)
* '''"Color2_FD_F"''' (Light khaki)
* '''"Color3_FD_F"''' (Light orange)
* '''"Color4_FD_F"''' (Light blue)
|= Description
____________________________________________________________________________________________


| markerName '''setMarkerColor''' color |= Syntax
|game4= arma2
|version4= 1.00


|p1= markerName: [[String]] |= Parameter 1
|game5= arma2oa
|version5= 1.50


|p2= color: [[String]] |= Parameter 2
|game6= tkoh
|version6= 1.00


| [[Nothing]] |= Return value
|game7= arma3
____________________________________________________________________________________________
|version7= 0.50
 
|x1= <pre>"MarkerOne" setMarkerColor "ColorBlack"</pre> |= Example 1
____________________________________________________________________________________________


|[[setMarkerBrush]], [[createMarker]], [[setMarkerDir]], [[setMarkerPos]], [[setMarkerShape]], [[setMarkerSize]], [[setMarkerText]], [[setMarkerType]], [[setMarkerAlpha]]
|gr1= Markers
|= See also


|eff= global
|descr= Set marker's colour. {{arma3}}'s marker colour names and their corresponding RGBA values can be found here: [[Arma 3: CfgMarkerColors]].
{{Feature|informative|
'''Multiplayer optimisation:''' Global marker commands always broadcast the ''entire'' marker state over the network.
As such, the number of network messages exchanged when creating or editing a marker can be reduced by performing all but the last operation using local marker commands, then using a global marker command for the last change (and subsequent global broadcast of all changes applied to the marker).
}}
}}


<h3 style="display:none">Notes</h3>
|s1= markerName [[setMarkerColor]] colour
<dl class="command_description">
 
<!-- Note Section BEGIN -->
|p1= markerName: [[String]]
 
|p2= colour: [[String]]
* {{hl|{{Link|Arma 3: CfgMarkerColors|CfgMarkerColors}}}}'s class name
* {{GVI|arma3|2.20|size= 0.75}} direct colour definition in one of the following formats (values in range 0..1):
** "#(r,g,b)" (e.g {{hl|"#(1,0,1)"}}, {{hl|#FF00FF}} equivalent)
** "#(r,g,b,a)" (e.g {{hl|"#(0.678,0.749,0.514,0.5)"}}, {{hl|#ADBF8380}} equivalent). Alpha 'a' in this format is independent of [[markerAlpha]]
 
|r1= [[Nothing]]


<!-- Note Section END -->
|x1= <sqf>"MarkerOne" setMarkerColor "ColorBlack";</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|x2= <sqf>"MarkerOne" setMarkerColor "#(1,0,0,1)"; // red color - since {{arma3}} v2.20</sqf>
[[Category:Scripting Commands|SETMARKERCOLOR]]
 
[[Category:Scripting Commands OFP 1.96|SETMARKERCOLOR]]
|seealso= [[setMarkerColorLocal]] [[markerColor]] [[getMarkerColor]] [[setMarkerBrush]] [[createMarker]] [[setMarkerDir]] [[setMarkerPos]] [[setMarkerShape]] [[setMarkerSize]] [[setMarkerText]] [[setMarkerType]] [[setMarkerAlpha]]
[[Category:Scripting Commands OFP 1.46|SETMARKERCOLOR]]
}}
[[Category:Scripting Commands ArmA|SETMARKERCOLOR]]
[[Category:Command Group: Markers|SETMARKERCOLOR]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 13:42, 29 October 2024

Hover & click on the images for description

Description

Description:
Set marker's colour. Arma 3's marker colour names and their corresponding RGBA values can be found here: Arma 3: CfgMarkerColors.
Multiplayer optimisation: Global marker commands always broadcast the entire marker state over the network. As such, the number of network messages exchanged when creating or editing a marker can be reduced by performing all but the last operation using local marker commands, then using a global marker command for the last change (and subsequent global broadcast of all changes applied to the marker).
Groups:
Markers

Syntax

Syntax:
markerName setMarkerColor colour
Parameters:
markerName: String
colour: String
  • CfgMarkerColors's class name
  • Arma 3 logo black.png2.20 direct colour definition in one of the following formats (values in range 0..1):
    • "#(r,g,b)" (e.g "#(1,0,1)", #FF00FF equivalent)
    • "#(r,g,b,a)" (e.g "#(0.678,0.749,0.514,0.5)", #ADBF8380 equivalent). Alpha 'a' in this format is independent of markerAlpha
Return Value:
Nothing

Examples

Example 1:
"MarkerOne" setMarkerColor "ColorBlack";
Example 2:
"MarkerOne" setMarkerColor "#(1,0,0,1)"; // red color - since Arma 3 v2.20

Additional Information

See also:
setMarkerColorLocal markerColor getMarkerColor setMarkerBrush createMarker setMarkerDir setMarkerPos setMarkerShape setMarkerSize setMarkerText setMarkerType setMarkerAlpha

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