Difference between revisions of "drawRectangle"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
(13 intermediate revisions by 3 users not shown)
Line 7: Line 7:
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| Draw a Rectangle on the map. |= Description
+
| Draws a rectangle on the map. |DESCRIPTION=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| map '''drawRectangle''' [center, a, b, angle, color, fill] |= Syntax
+
| map '''drawRectangle''' [c, a, b, angle, color, fill] |SYNTAX=
  
|p1= map: [[Control]] |= Parameter 1
+
|p1= map: [[Control]] |PARAMETER1=
  
|p2= [center, a, b, angle, color, fill]: [[Array]] |= Parameter 2
+
|p2= [c, a, b, angle, color, fill]: [[Array]]
 +
|p3= c: [[Array]] or [[Object]] - center of rectangle in format: [[Position2D]], [[Position3D]] or [[Object]] |=
  
| [[Nothing]] |= Return value
+
|p4= a: [[Number]] - 1/2 width of rectangle (in meters)|=
 +
 
 +
|p5= b: [[Number]] - 1/2 height of rectangle (in meters) |=
 +
 
 +
|p6= angle: [[Number]] - angle of rotation |=
 +
 
 +
|p7= color: [[Array]] - line color in format: [r,g,b,a]|=
 +
 
 +
|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] |=
 +
 
 +
| [[Nothing]]
 +
 
 +
<br><br>[[Image:drawRectangle.jpg|250px]]|RETURNVALUE=  
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| [[drawArrow]], [[drawEllipse]], [[drawIcon]], [[drawLine]] |= See also
+
|x1= <code>_ctrl [[drawRectangle]] [
 +
[[getPos]] [[player]],
 +
20,
 +
20,
 +
[[getDir]] [[player]],
 +
[0,0,1,1],
 +
""
 +
];</code>|EXAMPLE1=
 +
 
 +
|x2= <code>_ctrl [[drawRectangle]] [
 +
[[player]],
 +
10,
 +
20,
 +
[[getDir]] [[player]],
 +
[1,1,1,1],
 +
"#(rgb,8,8,3)color(1,0,0,1)"
 +
];</code>|EXAMPLE1=
 +
 
 +
| [[drawArrow]], [[drawEllipse]], [[drawIcon]], [[drawLine]], [[drawPolygon]], [[drawTriangle]] |SEEALSO=
  
 
}}
 
}}
Line 26: Line 57:
 
<dl class="command_description">
 
<dl class="command_description">
 
<!-- Note Section BEGIN -->
 
<!-- Note Section BEGIN -->
 +
 +
<dd class="notedate">Posted on March 22, 2014
 +
<dt class="note">'''[[User:Waffle SS.|Waffle SS.]]'''
 +
<dd class="note">Map example: <code>([[findDisplay]] 12 [[displayCtrl]] 51) [[ctrlAddEventHandler]] ["Draw",{
 +
(_this [[select]] 0) [[drawRectangle]] [
 +
[[getPos]] [[player]],
 +
20,
 +
20,
 +
[[getDir]] [[player]],
 +
[0,0,1,1],
 +
""
 +
];
 +
}];</code><BR>
 +
Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.
  
 
<!-- Note Section END -->
 
<!-- Note Section END -->
Line 38: Line 83:
 
[[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}}}}]]
 

Revision as of 15:38, 7 April 2019

Introduced with Armed Assault version 1.001.00
Hover & click on the images for descriptions

Description

Description:
Draws a rectangle on the map.

Syntax

Syntax:
map drawRectangle [c, a, b, angle, color, fill]
Parameters:
map: Control
[c, a, b, angle, color, fill]: Array
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
color: Array - line color in format: [r,g,b,a]
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

drawRectangle.jpg

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

i
Only post proven facts here. Report bugs on the Feedback Tracker and discuss on the Arma Discord or on the Forums.

Notes

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.

Bottom Section