drawEllipse: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(syntax, description, example, moving broken note to talk)
m (minor style fix)
 
(77 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. Just like with marker or trigger area, negative a and b will result in hexagon. |= 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]]
|gr1= GUI Control - Map


|p3= center: [[Array]] - center of ellipse in format [[Position2D]], [[Position3D]] or [[Object]] |= Parameter 3
|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.
|p4= a: [[Number]] - horizontal(x) radius |= Parameter 4
|p5= b: [[Number]] - vertical(y) radius |= Parameter 5
|p6= angle: [[Number]] - angle of rotation in degrees |= Parameter 6
|p7= color: [[Array]] - line color in format [r,g,b,a]|= Parameter 7
|p8= fill: [[String]] - fill texture. If texture is not empty, line color is ignored |= Parameter 8


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


|p1= map: [[Control]]


|x1=<code>[[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlAddEventHandler]] ["Draw",  
|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
 
|r1= [[Nothing]]
 
|x1= <sqf>
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw",  
{
{
_this [[select]] 0 [[drawEllipse]] [
_this select 0 drawEllipse [
[[player]], 10, 10, 0, [1, 0, 0, 1], ""
player, 10, 10, 0, [1, 0, 0, 1], ""
];
];
_this [[select]] 0 [[drawEllipse]] [
_this select 0 drawEllipse [
[[player]], -10, -10, 0, [1, 1, 1, 1], "#(rgb,8,8,3)color(1,0.6,0,1)"
player, -10, -10, 0, [1, 1, 1, 1], "#(rgb,8,8,3)color(1,0.6,0,1)"
];
];
_this [[select]] 0 [[drawEllipse]] [
_this select 0 drawEllipse [
[[player]], -10, -10, 90, [0, 0, 1, 1], ""
player, -10, -10, 90, [0, 0, 1, 1], ""
];
];
}];</code>
}];
</sqf>


| [[drawArrow]], [[drawIcon]], [[drawLine]], [[drawRectangle]] |= See also
|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.
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|DRAWELLIPSE]]
[[Category:Scripting Commands ArmA|DRAWELLIPSE]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Editor_Control|{{uc:{{PAGENAME}}}}]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on July 7, 2015 - 21:28 (UTC)</dd>
<dt class="note">[[User:Waffle SS.|Waffle SS.]]</dt>
<dd class="note">
Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

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.