drawRectangle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<dd class="note">([^}]*)<code>([^<]*)<\/code>" to "<dd class="note">$1<sqf>$2</sqf>")
m (Some wiki formatting)
Line 20: Line 20:
|descr= Draws a rectangle on the map.<br> [[Image:drawRectangle.jpg|250px]]
|descr= Draws a rectangle on the map.<br> [[Image:drawRectangle.jpg|250px]]


|s1= map [[drawRectangle]]  [c, a, b, angle, color, fill]
|s1= map [[drawRectangle]]  [centre, halfWidth, halfHeight, angle, color, fill]


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


|p2= c: [[Array]] or [[Object]] - Center of rectangle in format: [[Position#Introduction|Position2D]], [[Position#Introduction|Position3D]] or [[Object]]
|p2= centre: [[Object]] or [[Array]] in format [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]] - rectangle's centre


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


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


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


|p6= color: [[Array]] - Line color in format [[Color|Color RGBA]]
|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 {{ic|[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]}}
Line 38: Line 38:
|r1= [[Nothing]]
|r1= [[Nothing]]


|x1= <sqf>_ctrl drawRectangle [
|x1= <sqf>
_ctrl drawRectangle [
getPos player,
getPos player,
20,
20,
Line 45: Line 46:
[0,0,1,1],
[0,0,1,1],
""
""
];</sqf>
];
</sqf>


|x2= <sqf>_ctrl drawRectangle [
|x2= <sqf>
_ctrl drawRectangle [
player,
player,
10,
10,
Line 54: Line 57:
[1,1,1,1],
[1,1,1,1],
"#(rgb,8,8,3)color(1,0,0,1)"
"#(rgb,8,8,3)color(1,0,0,1)"
];</sqf>
];
</sqf>


|seealso= [[drawArrow]] [[drawEllipse]] [[drawIcon]] [[drawLine]] [[drawPolygon]] [[drawTriangle]]
|seealso= [[drawArrow]] [[drawEllipse]] [[drawIcon]] [[drawLine]] [[drawPolygon]] [[drawTriangle]]
}}
}}


<dl class="command_description">
{{Note
 
|user= Waffle SS.
<dt><dt>
|timestamp= 20140323002100
<dd class="notedate">Posted on March 22, 2014</dd>
|text= Map example:
<dt class="note">[[User:Waffle SS.|Waffle SS.]]</dt>
<sqf>
<dd class="note">Map example:
(findDisplay 12 displayCtrl 51) ctrlAddEventHandler ["Draw",{
<sqf>(findDisplay 12 displayCtrl 51) ctrlAddEventHandler ["Draw",{
(_this select 0) drawRectangle [
(_this select 0) drawRectangle [
getPos player,
getPos player,
Line 74: Line 77:
""
""
];
];
}];</sqf><BR>
}];
</sqf>
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>
}}

Revision as of 15:28, 26 July 2022

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 [centre, halfWidth, halfHeight, angle, color, fill]
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]
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:
drawArrow drawEllipse drawIcon drawLine 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
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.