drawEllipse: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(92 intermediate revisions by 14 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|DRAWELLIPSE]]
{{RV|type=command
[[Category:Scripting Commands ArmA|DRAWELLIPSE]]


|game1= arma1
|version1= 1.00


<h2 style="color:#000066">'''''map'' drawEllipse ''[center, a, b, angle, color, fill]'''''</h2>
|game2= arma2
|version2= 1.00


|game3= arma2oa
|version3= 1.50


'''Operand types:'''
|game4= tkoh
|version4= 1.00


'''map''': [[Control]]
|game5= arma3
|version5= 0.50


'''[center, a, b, angle, color, fill]''': [[Array]]
|gr1= GUI Control - Map


'''Type of returned value:'''
|descr= [[File:drawEllipse.jpg|250px|right]] Draws an ellipse on the map. Just like with marker or trigger area, negative ''a'' and ''b'' will result in hexagon.


[[Nothing]]
|s1= map [[drawEllipse]] [centre, a, b, angle, color, fill, alignWithMap]


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


Version 2.35 required.
|p2= centre: [[Object]] or [[Array]] format [[Position#Introduction|Position2D]], [[Position#Introduction|Position3D]] - ellipse's centre


'''Description:'''
|p3= a: [[Number]] - horizontal (x) radius


Draw an ellipse on the map.
|p4= b: [[Number]] - vertical (y) radius
 
|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 [1,1,1,1]
 
|p8= alignWithMap: [[Boolean]] - (Optional, default [[true]]) - when [[false]] the shape will not follow map rotation.
|p8since= Arma3 2.18
 
|r1= [[Nothing]]
 
|x1= <sqf>
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw",
{
_this select 0 drawEllipse [
player, 10, 10, 0, [1, 0, 0, 1], ""
];
_this select 0 drawEllipse [
player, -10, -10, 0, [1, 1, 1, 1], "#(rgb,8,8,3)color(1,0.6,0,1)"
];
_this select 0 drawEllipse [
player, -10, -10, 90, [0, 0, 1, 1], ""
];
}];
</sqf>
 
|seealso= [[drawArrow]] [[drawIcon]] [[drawLine]] [[drawRectangle]] [[drawPolygon]] [[drawTriangle]] [[drawXPolygon]]
}}
 
{{Note
|user= Waffle SS.
|timestamp= 20150707212800
|text= Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.
}}

Latest revision as of 22:25, 1 November 2024

Hover & click on the images for description

Description

Description:
drawEllipse.jpg
Draws an ellipse on the map. Just like with marker or trigger area, negative a and b will result in hexagon.
Groups:
GUI Control - Map

Syntax

Syntax:
map drawEllipse [centre, a, b, angle, color, fill, alignWithMap]
Parameters:
map: Control
centre: Object or Array format Position2D, Position3D - ellipse's centre
a: Number - horizontal (x) radius
b: Number - vertical (y) radius
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 Arma 3 logo black.png2.18
alignWithMap: Boolean - (Optional, default true) - when false the shape will not follow map rotation.
Return Value:
Nothing

Examples

Example 1:
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw", { _this select 0 drawEllipse [ player, 10, 10, 0, [1, 0, 0, 1], "" ]; _this select 0 drawEllipse [ player, -10, -10, 0, [1, 1, 1, 1], "#(rgb,8,8,3)color(1,0.6,0,1)" ]; _this select 0 drawEllipse [ player, -10, -10, 90, [0, 0, 1, 1], "" ]; }];

Additional Information

See also:
drawArrow drawIcon drawLine drawRectangle drawPolygon drawTriangle drawXPolygon

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 Jul 07, 2015 - 21:28 (UTC)
Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.