drawRectangle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<!-- Note Section [A-Z]+ --> " to "")
m (formatting)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma1
|game1= arma1


|1.00
|version1= 1.00
 
|game2= arma2
 
|version2= 1.00
 
|game3= arma2oa
 
|version3= 1.51
 
|game4= tkoh
 
|version4= 1.00
 
|game5= arma3
 
|version5= 0.50


|gr1= GUI Control - Map
|gr1= GUI Control - Map


| Draws a rectangle on the map.
|descr= Draws a rectangle on the map.<br> [[Image:drawRectangle.jpg|250px]]


| map '''drawRectangle''' [c, a, b, angle, color, fill]
|s1= map '''drawRectangle''' [c, a, b, angle, color, fill]


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


|p2= [c, a, b, angle, color, fill]: [[Array]]
|p2= c: [[Array]] or [[Object]] - Center of rectangle in format: [[Position2D]], [[Position3D]] or [[Object]]
|p3= c: [[Array]] or [[Object]] - center of rectangle in format: [[Position2D]], [[Position3D]] or [[Object]]


|p4= a: [[Number]] - 1/2 width of rectangle (in meters)
|p3= a: [[Number]] - 1/2 width of rectangle in meters


|p5= b: [[Number]] - 1/2 height of rectangle (in meters)
|p4= b: [[Number]] - 1/2 height of rectangle in meters


|p6= angle: [[Number]] - angle of rotation
|p5= angle: [[Number]] - Angle of rotation in degrees


|p7= color: [[Array]] - line color in format: [r,g,b,a]
|p6= color: [[Array]] - Line color in format [[Color|Color RGBA]]


|p8= 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]
|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 {{ic|[1,1,1,1]}}


| [[Nothing]]
|r1= [[Nothing]]
 
<br><br>[[Image:drawRectangle.jpg|250px]]


|x1= <code>_ctrl [[drawRectangle]] [
|x1= <code>_ctrl [[drawRectangle]] [
Line 66: Line 79:
}];</code><BR>
}];</code><BR>
Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.
Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.
</dl>
</dl>
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Revision as of 16:10, 15 April 2021

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

Description

Description:
Draws a rectangle on the map.
drawRectangle.jpg
Groups:
GUI Control - Map

Syntax

Syntax:
map drawRectangle [c, a, b, angle, color, fill]
Parameters:
map: Control
c: Array or Object - Center of rectangle in format: Position2D, Position3D or Object
a: Number - 1/2 width of rectangle in meters
b: Number - 1/2 height of rectangle in meters
angle: Number - Angle of rotation in degrees
color: Array - Line color in format Color RGBA
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]
Return Value:
Nothing

Examples

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)" ];

Additional Information

See also:
drawArrowdrawEllipsedrawIcondrawLinedrawPolygondrawTriangle

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.
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.
Retrieved from "https://community.bistudio.com/wiki?title=drawRectangle&oldid=255467"