drawIcon: Difference between revisions
Jump to navigation
Jump to search
m (Text replace - "{{uc:{{PAGENAME}}}}" to "{{uc:{{PAGENAME}}}} {{uc:{{PAGENAME}}}}") |
Lou Montana (talk | contribs) m (Text replacement - "|= Game version" to "|Game version=") |
||
(26 intermediate revisions by 11 users not shown) | |||
Line 1: | Line 1: | ||
{{Command|= | {{Command|Comments= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| arma | | | arma |Game name= | ||
|1.00| | |1.00|Game version= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| | | Draws an icon on the map. The command needs to be called every frame, preferably with "Draw" control event handler [[ctrlAddEventHandler]]. | ||
|DESCRIPTION= | |||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| map '''drawIcon''' [texture, color, position, width, height, angle, text, shadow] |= | | map '''drawIcon''' [texture, color, position, width, height, angle, text, shadow, textSize, font, align] |SYNTAX= | ||
|p1= map: [[Control]] |PARAMETER1= | |||
|p2 = [texture, color, position, width, height, angle, text, shadow, textSize, font, align] : [[Array]] | |||
|p3= texture: [[String]] - icon texture |= | |||
|p4= color: [[Array]] - text and icon color in format [r,g,b,a] |= | |||
|p5= position: [[Position2D]] or [[Position3D]] or [[Object]] |= | |||
|p6= width: [[Number]] - width of the icon but not text|= | |||
|p7= height: [[Number]] - height of the icon but not text|= | |||
|p8= angle: [[Number]] - rotation angle of the icon but not text|= | |||
|p9= text (Optional): [[String]] |= | |||
|p10= shadow (Optional): [[Number]] or [[Boolean]] - 0/false: no shadow, 1: shadow (for text), 2/true: outline (works for text and for icon only if icon angle is 0)|= | |||
|p11= textSize (Optional): [[Number]] - size of the text in UI units (since Arma 3 v0.72)|= | |||
|p12= font (Optional): [[String]] - (since Arma 3 v0.72) |= | |||
|p13= align (Optional): [[String]] - (since Arma 3 v0.72) "left", "right", "center". Default is "right" |= | |||
| | | [[Nothing]] |RETURNVALUE= | ||
| | |x1= Red icon with text: <code>[[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlAddEventHandler]] ["Draw", | ||
{ | |||
_this [[select]] 0 [[drawIcon]] | |||
[ | |||
"iconStaticMG", | |||
[1,0,0,1], | |||
[[getPos]] [[player]], | |||
24, | |||
24, | |||
[[getDir]] [[player]], | |||
"Player Vehicle", | |||
1, | |||
0.03, | |||
"TahomaB", | |||
"right" | |||
] | |||
}];</code>|EXAMPLE1= | |||
| [[ | |x2= Green text only: <code>[[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlAddEventHandler]] ["Draw", | ||
{ | |||
_this [[select]] 0 [[drawIcon]] | |||
[ | |||
"#(rgb,1,1,1)color(1,1,1,1)", | |||
[0,1,0,1], | |||
[[player]], | |||
0, | |||
0, | |||
0, | |||
[[name]] [[player]] | |||
] | |||
}];</code>|EXAMPLE2= | |||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| [[drawArrow]], [[drawEllipse]], [[drawLine]], [[drawRectangle]] |= | | [[drawArrow]], [[drawEllipse]], [[drawLine]], [[drawRectangle]], [[drawPolygon]], [[drawTriangle]] |SEEALSO= | ||
}} | }} | ||
Line 26: | Line 70: | ||
<dl class="command_description"> | <dl class="command_description"> | ||
<!-- Note Section BEGIN --> | <!-- Note Section BEGIN --> | ||
<dd class="notedate">Posted on July 03, 2013 - 15:35 | |||
<dt class="note">'''[[User:Druid|Druid]]'''<dd class="note">Support of paremeters <i>textSize</i>, <i>font</i> and <i>align</i> is in the game since Arma 3 version 0.72.<br/> | |||
<dd class="notedate">Posted on March 22, 2014 | |||
<dt class="note">'''[[User:Waffle SS.|Waffle SS.]]''' | |||
<dd class="note">icon will always remain the same width and height, if you want an icon scaled to the map, use:<code>('''sizeInMeters''' * 0.15) * 10^(abs log (ctrlMapScale _ctrl))</code> for width and height (guessimated). | |||
<BR><BR> | |||
<!-- Note Section END --> | <!-- Note Section END --> | ||
Line 35: | Line 87: | ||
[[Category:Scripting Commands ArmA|DRAWICON]] | [[Category:Scripting Commands ArmA|DRAWICON]] | ||
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]] | [[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]] | ||
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]] | |||
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]] | [[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]] | ||
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]] | [[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]] | ||
[[Category:Command_Group:_Editor_Control|{{uc:{{PAGENAME}}}}]] | [[Category:Command_Group:_Editor_Control|{{uc:{{PAGENAME}}}}]] | ||
<!-- CONTINUE Notes --> | |||
<dl class="command_description"> | |||
<dd class="notedate">Posted on July 20, 2014 - 16:59 (UTC)</dd> | |||
<dt class="note">[[User:AgentRevolution|AgentRevolution]]</dt> | |||
<dd class="note"> | |||
If you want only text with no icon, you can use "#(argb,8,8,3)color(0,0,0,0)" as texture. | |||
</dd> | |||
</dl> | |||
<!-- DISCONTINUE Notes --> | |||
<!-- CONTINUE Notes --> | |||
<dl class="command_description"> | |||
<dd class="notedate">Posted on July 7, 2015 - 21:27 (UTC)</dd> | |||
<dt class="note">[[User:Waffle SS.|Waffle SS.]]</dt> | |||
<dd class="note"> | |||
Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate. | |||
</dd> | |||
</dl> | |||
<!-- DISCONTINUE Notes --> | |||
<!-- CONTINUE Notes --> | |||
<dl class="command_description"> | |||
<dd class="notedate">Posted on January 4, 2016 - 05:41 (UTC)</dd> | |||
<dt class="note">[[User:Benargee|Benargee]]</dt> | |||
<dd class="note"> | |||
Arma 3 1.54<br/> | |||
This command doesn't seem to play nice with [[onEachFrame]]. It seems to draw on the main screen while maintaing position relative to the map position<br/> | |||
Example: | |||
<code>[[onEachFrame]] { | |||
[[findDisplay]] 12 [[displayCtrl]] 51 [[drawIcon]] ['iconStaticMG',[1,0,0,1],[[getPos]] [[player]],24,24,[[getDir]] [[player]],'Player Vehicle',1,0.03,'TahomaB','right']; | |||
};</code> | |||
</dd> | |||
</dl> | |||
<!-- DISCONTINUE Notes --> | |||
<!-- CONTINUE Notes --> | |||
<dl class="command_description"> | |||
<dd class="notedate">Posted on October 13, 2016 - 21:12 (UTC)</dd> | |||
<dt class="note">[[User:Icaruk|Icaruk]]</dt> | |||
<dd class="note"> | |||
If you unPBO the following addon:<br> | |||
<code>@ui_f_data.pbo<br></code> | |||
You can find the possible icons inside this folder:<br> | |||
<code>ui_f\data\map\vehicleicons</code><br> | |||
For example:<br> | |||
If you want to use "iconman_ca.paa" you will write "iconman" on the texture string. | |||
</dd> | |||
</dl> | |||
<!-- DISCONTINUE Notes --> |
Revision as of 13:19, 31 August 2019
Description
- Description:
- Draws an icon on the map. The command needs to be called every frame, preferably with "Draw" control event handler ctrlAddEventHandler.
- Groups:
- Uncategorised
Syntax
- Syntax:
- map drawIcon [texture, color, position, width, height, angle, text, shadow, textSize, font, align]
- Parameters:
- map: Control
- [texture, color, position, width, height, angle, text, shadow, textSize, font, align] : Array
- texture: String - icon texture
- color: Array - text and icon color in format [r,g,b,a]
- position: Position2D or Position3D or Object
- width: Number - width of the icon but not text
- height: Number - height of the icon but not text
- angle: Number - rotation angle of the icon but not text
- text (Optional): String
- shadow (Optional): Number or Boolean - 0/false: no shadow, 1: shadow (for text), 2/true: outline (works for text and for icon only if icon angle is 0)
- textSize (Optional): Number - size of the text in UI units (since Arma 3 v0.72)
- font (Optional): String - (since Arma 3 v0.72)
- align (Optional): String - (since Arma 3 v0.72) "left", "right", "center". Default is "right"
- Return Value:
- Nothing
Examples
- Example 1:
- Red icon with text:
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw", { _this select 0 drawIcon [ "iconStaticMG", [1,0,0,1], getPos player, 24, 24, getDir player, "Player Vehicle", 1, 0.03, "TahomaB", "right" ] }];
- Example 2:
- Green text only:
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw", { _this select 0 drawIcon [ "#(rgb,1,1,1)color(1,1,1,1)", [0,1,0,1], player, 0, 0, 0, name player ] }];
Additional Information
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
Notes
- Posted on July 03, 2013 - 15:35
- Druid
- Support of paremeters textSize, font and align is in the game since Arma 3 version 0.72.
- Posted on March 22, 2014
- Waffle SS.
- icon will always remain the same width and height, if you want an icon scaled to the map, use:
(sizeInMeters * 0.15) * 10^(abs log (ctrlMapScale _ctrl))
for width and height (guessimated).
Bottom Section
- Posted on July 20, 2014 - 16:59 (UTC)
- AgentRevolution
- If you want only text with no icon, you can use "#(argb,8,8,3)color(0,0,0,0)" as texture.
- Posted on July 7, 2015 - 21:27 (UTC)
- Waffle SS.
- Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.
- Posted on January 4, 2016 - 05:41 (UTC)
- Benargee
-
Arma 3 1.54
This command doesn't seem to play nice with onEachFrame. It seems to draw on the main screen while maintaing position relative to the map position
Example:onEachFrame { findDisplay 12 displayCtrl 51 drawIcon ['iconStaticMG',[1,0,0,1],getPos player,24,24,getDir player,'Player Vehicle',1,0.03,'TahomaB','right']; };
- Posted on October 13, 2016 - 21:12 (UTC)
- Icaruk
-
If you unPBO the following addon:
@ui_f_data.pbo
You can find the possible icons inside this folder:
ui_f\data\map\vehicleicons
For example:
If you want to use "iconman_ca.paa" you will write "iconman" on the texture string.