drawEllipse: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
 
m (minor style fix)
 
(94 intermediate revisions by 15 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|DRAWELLIPSE]]
{{RV|type=command
[[Category:Scripting Commands ArmA|DRAWELLIPSE]]


|game1= arma1
|version1= 1.00


|game2= arma2
|version2= 1.00


<h2 style="color:#000066">''map'' ''''' drawEllipse ''''' ''[center, a, b, angle, color, fill]''</h2>
|game3= arma2oa
|version3= 1.50


|game4= tkoh
|version4= 1.00


'''Operand types:'''
|game5= arma3
|version5= 0.50


'''map''': [[Control]]
|gr1= GUI Control - Map


'''[center, a, b, angle, color, fill]''': [[Array]]
|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.


'''Type of returned value:'''
|s1= map [[drawEllipse]] [centre, a, b, angle, color, fill, alignWithMap]


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


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


Version 2.35 required.
|p3= a: [[Number]] - horizontal (x) radius


'''Description:'''
|p4= b: [[Number]] - vertical (y) radius


Draw arrow in map.
|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]]
}}
 
{{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 03:01, 9 October 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

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.