setMarkerColor: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[[cC]ategory:[sS]cripting [cC]ommands\|[a-z A-Z 0-9_]+\]\]" to "")
No edit summary
 
(33 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| ofp
|game1= ofp
|version1= 1.21


|1.21
|game2= ofpe
|version2= 1.00


|gr1 = Markers
|game3= arma1
|version3= 1.00
 
|game4= arma2
|version4= 1.00
 
|game5= arma2oa
|version5= 1.50
 
|game6= tkoh
|version6= 1.00
 
|game7= arma3
|version7= 0.50
 
|gr1= Markers


|eff= global
|eff= global


|Sets marker color. Marker color names and their corresponding RGBA values for Arma 3 could be found here: [[CfgMarkerColors_Arma_3]]
|descr= Set marker's colour. {{arma3}}'s marker colour names and their corresponding RGBA values can be found here: [[Arma 3: CfgMarkerColors]].
{{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).}}
{{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).
}}


| markerName '''setMarkerColor''' color
|s1= markerName [[setMarkerColor]] colour


|p1= markerName: [[String]]
|p1= markerName: [[String]]


|p2= color: [[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]]


| [[Nothing]]
|r1= [[Nothing]]
 
|x1= <code>"MarkerOne" [[setMarkerColor]] "ColorBlack";</code>


|[[setMarkerColorLocal]], [[markerColor]], [[getMarkerColor]], [[setMarkerBrush]], [[createMarker]], [[setMarkerDir]], [[setMarkerPos]], [[setMarkerShape]], [[setMarkerSize]], [[setMarkerText]], [[setMarkerType]], [[setMarkerAlpha]]
|x1= <sqf>"MarkerOne" setMarkerColor "ColorBlack";</sqf>
}}


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


[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
|seealso= [[setMarkerColorLocal]] [[markerColor]] [[getMarkerColor]] [[setMarkerBrush]] [[createMarker]] [[setMarkerDir]] [[setMarkerPos]] [[setMarkerShape]] [[setMarkerSize]] [[setMarkerText]] [[setMarkerType]] [[setMarkerAlpha]]
[[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

Logo A0.png1.21ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
GEGlobal
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
Retrieved from "https://community.bistudio.com/wiki?title=setMarkerColor&oldid=370055"