drawIcon

1.001.001.501.000.50

Hover & click on the images for description

Description

Description:

Draws an icon on the map. This command needs to be called every frame, preferably using the onDraw UI Event Handler. Some useful icons can be found in configfile >> "CfgVehicleIcons".

Problems:

Since command has to be drawn on each frame, performance can be degrade!

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: Position2D, Position3D or Object

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 (but not the text)

text (Optional): String

shadow (Optional): Number or Boolean - Can be:

• 0 (false): no shadow
• 1: shadow (for text)
• 2 (true): outline (works for text and for icon only if icon angle is 0)

since 0.72

textSize (Optional): Number - Size of the text in UI units

since 0.72

font (Optional): String - Text's font

since <span class="gvi2 gvi-arma3 " style="font-size: 11.1px; height: 27.2px; width: 27.2px">[[:Category:Introduced with Arma 3 version 0.72

• "left"
• "right"
• "center"|0.72
• "LEFT"
• "RIGHT"
• "CENTER"]]

align (Optional, default: "right"): String - Text alignment. Can be:

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], 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

See also:

drawArrow drawEllipse drawLine drawRectangle drawPolygon drawTriangle

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

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).

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 January 4, 2016 - 05:41 (UTC)

Benargee

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],getPos player,24,24,getDir player,'Player Vehicle',1,0.03,'TahomaB','right']; };