drawIcon: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "Position2D" to "Position2D")
No edit summary
 
(27 intermediate revisions by 5 users not shown)
Line 18: Line 18:
|gr1= GUI Control - Map
|gr1= GUI Control - Map


|descr= Draws an icon on the map. This command needs to be called every frame, preferably using the [[User_Interface_Event_Handlers#onDraw|onDraw]] UI Event Handler. Some useful icons can be found in {{ic|[[configfile]] >> "CfgVehicleIcons"}}.
|eff= local


|pr= Since command has to be drawn on each frame, performance can be degrade!
|descr= Draws an icon on the map.
As this command needs to be called every frame, it is preferable using the [[User Interface Event Handlers#onDraw|onDraw]] UI Event Handler.
{{Feature|informative|Some useful icons can be found in <sqf inline>configFile >> "CfgVehicleIcons"</sqf>.}}


|s1= map [[drawIcon]] [texture, color, position, width, height, angle, text, shadow, textSize, font, align]
|s1= map [[drawIcon]] [texture, color, position, width, height, angle, text, shadow, textSize, font, align<!--, drawSideArrows, offsetX, offsetY-->]


|p1= map: [[Control]]
|p1= map: [[Control]]


|p2= texture: [[String]] - Icon texture
|p2= texture: [[String]] - icon texture


|p3= color: [[Array]] - Text and icon color in format [[Color|Color(RGBA)]]
|p3= color: [[Array]] - text and icon color in format [[Color|Color(RGBA)]]


|p4= position: [[Position#Introduction|Position2D]], [[Position#Introduction|Position3D]] or [[Object]]
|p4= position: [[Object]], [[Array]] format [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]]


|p5= width: [[Number]] - Width of the icon (but not the text)
|p5= width: [[Number]] - width of the icon (but not the text)


|p6= height: [[Number]] - Height of the icon (but not the text)
|p6= height: [[Number]] - height of the icon (but not the text)


|p7= angle: [[Number]] - Rotation angle of the icon (but not the text)
|p7= angle: [[Number]] - rotation angle of the icon not the text (add to it [[ctrlMapDir]] to show correctly on rotating minimap)


|p8= text (Optional): [[String]]
|p8= text: [[String]] - (Optional, default "")


|p9= shadow (Optional): [[Number]] or [[Boolean]] - Can be:  
|p9= shadow: [[Number]] or [[Boolean]] - (Optional, default [[false]]) can be one of:
* 0 ([[false]]): no shadow
* 0 ([[false]]): no shadow
* 1: shadow (for text)
* 1: shadow (for text)
* 2 ([[true]]): outline (works for text and for icon only if icon angle is 0)
* 2 ([[true]]): outline (works for text and for icon only if icon angle is 0)


|p10= textSize (Optional): [[Number]] - Size of the text in UI units
|p10= textSize: [[Number]] - (Optional, default -1) size of the text in UI units
|p10since= arma3 0.72
|p10since= arma3 0.72


|p11= font: [[String]] - (Optional) text's font
|p11= font: [[String]] - (Optional, default "") text's font
|p11since= arma3 0.72
|p11since= arma3 0.72


|p12= align: [[String]] - Optional, default: "right") text alignment. Can be:
|p12= align: [[String]] - (Optional, default "right") text alignment. Can be:
* "left"  
* "left"
* "right"
* "right"
* "center"
* "center"
|p12since= arma3 0.72
|p12since= arma3 0.72
<!--
|p13= drawSideArrows: [[Boolean]] - (Optional, default [[false]]) unused
|p13since= arma3 2.04
|p14= offsetX: [[Number]] - (Optional, default 0) unused
|p14since= arma3 2.04
|p15= offsetY: [[Number]] - (Optional, default 0) unused
|p15since= arma3 2.04
-->


|r1= [[Nothing]]
|r1= [[Nothing]]


|x1= Red icon with text: <code>[[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlAddEventHandler]] ["Draw", {
|x1= Red icon with text:
_this [[select]] 0 [[drawIcon]] [
<sqf>
"iconStaticMG", {{cc|Custom images can also be used: [[getMissionPath]] "\myFolder\myIcon.paa"}}
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw", {
_this select 0 drawIcon [
"iconStaticMG", // custom images can also be used: getMissionPath "\myFolder\myIcon.paa"
[1,0,0,1],
[1,0,0,1],
[[getPos]] [[player]],
getPosASLVisual player,
24,
24,
24,
24,
[[getDir]] [[player]],
getDirVisual player,
"Player Vehicle",
"Player Vehicle",
1,
1,
Line 73: Line 90:
"right"
"right"
]
]
}];</code>
}];
</sqf>


|x2= Green text only: <code>[[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlAddEventHandler]] ["Draw", {
|x2= Green text only:
_this [[select]] 0 [[drawIcon]] [
<sqf>
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw", {
_this select 0 drawIcon [
"#(rgb,1,1,1)color(1,1,1,1)",
"#(rgb,1,1,1)color(1,1,1,1)",
[0,1,0,1],
[0,1,0,1],
[[player]],
player,
0,
0,
0,
0,
0,
0,
[[name]] [[player]]
name player
]
]
}];</code>
}];
</sqf>


|seealso= [[drawArrow]] [[drawEllipse]] [[drawLine]] [[drawRectangle]] [[drawPolygon]] [[drawTriangle]]
|seealso= [[drawArrow]] [[drawEllipse]] [[drawLine]] [[drawRectangle]] [[drawPolygon]] [[drawTriangle]] [[drawXPolygon]]
}}
}}


<dl class="command_description">
{{Note
 
|user= Benargee
<dt></dt>
|timestamp= 20160104054100
<dd class="notedate">Posted on March 22, 2014</dd>
|text= {{arma3}} 1.54<br>
<dt class="note">[[User:Waffle SS.|Waffle SS.]]</dt>
<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).
<dt><dt>
<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>
 
<dt><dt>
<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 does not seem to play nice with [[onEachFrame]]. It seems to draw on the main screen while maintaing position relative to the map position<br>
This command does not seem to play nice with [[onEachFrame]]. It seems to draw on the main screen while maintaing position relative to the map position<br>
Example:
Example:
<code>[[onEachFrame]] {
<sqf>
[[findDisplay]] 12 [[displayCtrl]] 51 [[drawIcon]] ['iconStaticMG',[1,0,0,1],[[getPos]] [[player]],24,24,[[getDir]] [[player]],'Player Vehicle',1,0.03,'TahomaB','right'];
onEachFrame {
};</code>
findDisplay 12 displayCtrl 51 drawIcon ['iconStaticMG', [1,0,0,1], getPosASL player, 24, 24, getDir player, 'Player Vehicle', 1, 0.03, 'TahomaB', 'right'];
</dd>
};
</sqf>
}}


</dl>
{{Note
|user= Leopard20
|timestamp= 20220509193407
|text= The icon size always stays the same, even after zooming in/out. To make the icon get bigger with map zoom, use this for width and height size:
<sqf>
private _scale = 6.4 * worldSize / 8192 * ctrlMapScale _map;
private _size = _sizeInMeters / _scale;
</sqf>
For example, the following icon has an exact size of 50 meters on the map, even after zooming in/out:
<sqf>
private _scale = 6.4 * worldSize / 8192 * ctrlMapScale _map;
private _size = 50 / _scale;
_map drawIcon ["iconStaticMG", [1,0,0,1], getPosASLVisual player, _size, _size, 0]
</sqf>
}}

Latest revision as of 22:35, 1 November 2024

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LELocal
Hover & click on the images for description

Description

Description:
Draws an icon on the map. As this command needs to be called every frame, it is preferable using the onDraw UI Event Handler.
ⓘ
Some useful icons can be found in configFile >> "CfgVehicleIcons".
Groups:
GUI Control - Map

Syntax

Syntax:
map drawIcon [texture, color, position, width, height, angle, text, shadow, textSize, font, align]
Parameters:
map: Control
texture: String - icon texture
color: Array - text and icon color in format Color(RGBA)
position: Object, Array format Position2D or Position3D
width: Number - width of the icon (but not the text)
height: Number - height of the icon (but not the text)
angle: Number - rotation angle of the icon not the text (add to it ctrlMapDir to show correctly on rotating minimap)
text: String - (Optional, default "")
shadow: Number or Boolean - (Optional, default false) can be one of:
  • 0 (false): no shadow
  • 1: shadow (for text)
  • 2 (true): outline (works for text and for icon only if icon angle is 0)
since Arma 3 logo black.png0.72
textSize: Number - (Optional, default -1) size of the text in UI units
since Arma 3 logo black.png0.72
font: String - (Optional, default "") text's font
since Arma 3 logo black.png0.72
align: String - (Optional, default "right") text alignment. Can be:
  • "left"
  • "right"
  • "center"
Return Value:
Nothing

Examples

Example 1:
Red icon with text:
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw", { _this select 0 drawIcon [ "iconStaticMG", // custom images can also be used: getMissionPath "\myFolder\myIcon.paa" [1,0,0,1], getPosASLVisual player, 24, 24, getDirVisual 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

See also:
drawArrow drawEllipse drawLine drawRectangle drawPolygon drawTriangle drawXPolygon

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
Benargee - c
Posted on Jan 04, 2016 - 05:41 (UTC)
Arma 3 1.54
This command does not 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], getPosASL player, 24, 24, getDir player, 'Player Vehicle', 1, 0.03, 'TahomaB', 'right']; };
Leopard20 - c
Posted on May 09, 2022 - 19:34 (UTC)
The icon size always stays the same, even after zooming in/out. To make the icon get bigger with map zoom, use this for width and height size:
private _scale = 6.4 * worldSize / 8192 * ctrlMapScale _map; private _size = _sizeInMeters / _scale;
For example, the following icon has an exact size of 50 meters on the map, even after zooming in/out:
private _scale = 6.4 * worldSize / 8192 * ctrlMapScale _map; private _size = 50 / _scale; _map drawIcon ["iconStaticMG", [1,0,0,1], getPosASLVisual player, _size, _size, 0]
Retrieved from "https://community.bistudio.com/wiki?title=drawIcon&oldid=370133"