drawEllipse: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
No edit summary
 
(86 intermediate revisions by 11 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, alignWithMap]


|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]
 
|p8= alignWithMap: [[Boolean]] - (Optional, default [[true]]) - when [[false]] the shape will not follow map rotation.
|p8since= Arma3 2.18


<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]] [[drawXPolygon]]
}}


[[Category:Scripting Commands|DRAWELLIPSE]]
{{Note
[[Category:Scripting Commands ArmA|DRAWELLIPSE]]
|user= Waffle SS.
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
|timestamp= 20150707212800
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
|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

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
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.
Retrieved from "https://community.bistudio.com/wiki?title=drawEllipse&oldid=370128"