setMarkerColor: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
No edit summary
 
(40 intermediate revisions by 3 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


|gr1 = Markers |GROUP1=
|game3= arma1
|version3= 1.00


|eff= global |Multiplayer Effects=
|game4= arma2
|version4= 1.00


|Sets marker color. Marker color names and their corresponding RGBA values for Arma 3 could be found here: [[CfgMarkerColors_Arma_3]]
|game5= arma2oa
{{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).}}
|version5= 1.50
|DESCRIPTION=


| markerName '''setMarkerColor''' color |SYNTAX=
|game6= tkoh
|version6= 1.00


|p1= markerName: [[String]] |PARAMETER1=
|game7= arma3
|version7= 0.50


|p2= color: [[String]] |PARAMETER2=
|gr1= Markers


| [[Nothing]] |RETURNVALUE=
|eff= global
 
|x1= <code>"MarkerOne" [[setMarkerColor]] "ColorBlack";</code> |EXAMPLE1=


|[[setMarkerColorLocal]], [[markerColor]], [[getMarkerColor]], [[setMarkerBrush]], [[createMarker]], [[setMarkerDir]], [[setMarkerPos]], [[setMarkerShape]], [[setMarkerSize]], [[setMarkerText]], [[setMarkerType]], [[setMarkerAlpha]] |SEEALSO=
|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).
}}
 
|s1= markerName [[setMarkerColor]] colour
 
|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]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>"MarkerOne" setMarkerColor "ColorBlack";</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x2= <sqf>"MarkerOne" setMarkerColor "#(1,0,0,1)"; // red color - since {{arma3}} v2.20</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[setMarkerColorLocal]] [[markerColor]] [[getMarkerColor]] [[setMarkerBrush]] [[createMarker]] [[setMarkerDir]] [[setMarkerPos]] [[setMarkerShape]] [[setMarkerSize]] [[setMarkerText]] [[setMarkerType]] [[setMarkerAlpha]]
[[Category:Scripting Commands|SETMARKERCOLOR]]
}}
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|SETMARKERCOLOR]]
[[Category:Scripting Commands OFP 1.46|SETMARKERCOLOR]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

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