drawEllipse: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (VBS2 scripting category removal)
mNo edit summary
 
(76 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.00


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Draw an ellipse on the map. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| map '''drawEllipse''' [center, a, b, angle, color, fill] |= Syntax
|game4= tkoh
|version4= 1.00


|p1= map: [[Control]] |= Parameter 1
|game5= arma3
|version5= 0.50


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


| [[Nothing]] |= Return 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.


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


|x1=<code>(findDisplay 137 displayCtrl 51) drawEllipse [getpos player, 50, 50, 0, [1,1,0,1], ""]</code>
|p1= map: [[Control]]


| [[drawArrow]], [[drawIcon]], [[drawLine]], [[drawRectangle]] |= See also
|p2= centre: [[Object]] or [[Array]] format [[Position#Introduction|Position2D]], [[Position#Introduction|Position3D]] - ellipse's centre


}}
|p3= a: [[Number]] - horizontal (x) radius
 
|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]


<h3 style="display:none">Notes</h3>
|r1= [[Nothing]]
<dl class="command_description">
<!-- Note Section BEGIN -->
Fill can be empty string or path to texture with which to fill the ellipse.


Function must be called every time the map control is re-drawn, therefore it should be initiated by drawMap[] event of an editor object to be visible.
|x1= <sqf>
<!-- Note Section END -->
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw",
</dl>
{
_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>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[drawArrow]] [[drawIcon]] [[drawLine]] [[drawRectangle]] [[drawPolygon]] [[drawTriangle]]
}}


[[Category:Scripting Commands|DRAWELLIPSE]]
{{Note
[[Category:Scripting Commands ArmA|DRAWELLIPSE]]
|user= Waffle SS.
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
|timestamp= 20150707212800
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
|text= Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.
[[Category:Command_Group:_Editor_Control|{{uc:{{PAGENAME}}}}]]
}}

Latest revision as of 04:44, 28 September 2023

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]
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]
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.