drawRectangle: Difference between revisions

Latest revision as of 22:36, 1 November 2024

Hover & click on the images for description

Syntax:: map drawRectangle [centre, halfWidth, halfHeight, angle, color, fill, alignWithMap]
Parameters:: map: Control
: centre: Object or Array in format Position2D or Position3D - rectangle's centre
: halfWidth: Number - 1/2 width of rectangle in meters
: halfHeight: Number - 1/2 height of rectangle in meters
: angle: Number - angle of rotation in degrees
: color: Array format Color (RGBA) - line color
: fill: String - fill texture file or Procedural Textures. Note that the file texture will not rotate with rectangle, use drawIcon for that. If fill texture is not empty, set line color to white [1,1,1,1]
since 2.18: alignWithMap: Boolean - (Optional, default true) - when false the shape will not follow map rotation.
Return Value:: Nothing

Example 1:: _ctrl drawRectangle [ getPos player, 20, 20, getDir player, [0,0,1,1], "" ];
Example 2:: _ctrl drawRectangle [ player, 10, 20, getDir player, [1,1,1,1], "#(rgb,8,8,3)color(1,0,0,1)" ];

See also:: drawArrow drawEllipse drawIcon drawLine drawPolygon drawTriangle drawXPolygon

: 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

Waffle SS. - c: Posted on Mar 23, 2014 - 00:21 (UTC)
: Map example:
(findDisplay 12 displayCtrl 51) ctrlAddEventHandler ["Draw",{ (_this select 0) drawRectangle [ getPos player, 20, 20, getDir player, [0,0,1,1], "" ]; }];
Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.

@@ Line 20: / Line 20: @@
 |descr= Draws a rectangle on the map.<br> [[File:drawRectangle.jpg|250px]]
-|s1= map [[drawRectangle]] [centre, halfWidth, halfHeight, angle, color, fill]
+|s1= map [[drawRectangle]] [centre, halfWidth, halfHeight, angle, color, fill, alignWithMap]
 |p1= map: [[Control]]
@@ Line 30: / Line 30: @@
 |p4= halfHeight: [[Number]] - 1/2 height of rectangle in meters
-|p5= angle: [[Number]] - angle of rotation in degrees (add to it [[ctrlMapDir]] to show correctly on rotating minimap)
+|p5= angle: [[Number]] - angle of rotation in degrees
 |p6= color: [[Array]] format [[Color|Color (RGBA)]] - line color
 |p7= fill: [[String]] - fill texture file or [[Procedural Textures]]. Note that the file texture will not rotate with rectangle, use [[drawIcon]] for that. If fill texture is not empty, set line color to white <sqf inline>[1,1,1,1]</sqf>
+|p8= alignWithMap: [[Boolean]] - (Optional, default [[true]]) - when [[false]] the shape will not follow map rotation.
+|p8since= Arma3 2.18
 |r1= [[Nothing]]
@@ Line 60: / Line 63: @@
 </sqf>
-|seealso= [[drawArrow]] [[drawEllipse]] [[drawIcon]] [[drawLine]] [[drawPolygon]] [[drawTriangle]]
+|seealso= [[drawArrow]] [[drawEllipse]] [[drawIcon]] [[drawLine]] [[drawPolygon]] [[drawTriangle]] [[drawXPolygon]]
 }}