drawPolygon: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <h3 style="display:none">Notes</h3> <dl class="command_description"> <!-- Note Section BEGIN --> <!-- Note Section END --> </dl> " to "")
m (Some wiki formatting)
 
(36 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command


| arma3 |Game name=
|game1= arma3
|version1= 1.58


|1.58|Game Version=
|gr1= GUI Control - Map


|gr1= GUI Control - Map |GROUP1=
|descr= Draws given polygon on the given map control with given color. The polygon must consist of at least 3 points. Unlike with other {{hl|draw*}} commands and due to complexity, this command does not support filling of the polygon with color. Use [[drawTriangle]] command to construct and fill polygon shape as a workaround.


| Draws given polygon on the given map control with given color. The polygon must consist of at least 3 points. Unlike with other draw&lt;shape&gt; commands and due to complexity, this command does not support filling of the polygon with color. Use [[drawTriangle]] command to construct and fill polygon shape as a workaround. |DESCRIPTION=
|s1= map [[drawPolygon]] [polygon, color]


| map [[drawPolygon]] [polygon, color] |SYNTAX=
|p1= map: [[Control]]


|p1= map: [[Control]] |PARAMETER1=
|p2= polygon: [[Array]] of [[Position#Introduction|Position3D]]


|p2= polygon: [[Array]] of [[Position3D]] |PARAMETER2=
|p3= color: [[Color|Color (RGBA)]]


|p3= color: [[Color|Color (RGBA)]] - line color in format [r,g,b,a]|PARAMETER3=
|r1= [[Nothing]]


| [[Nothing]] |RETURNVALUE=
|x1= <sqf>
test_polygon = [];
for "_i" from 1 to 12 do
{
test_polygon pushBack (player getPos [10 + random 100, 360 / _i]);
};
 
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw",
{
params ["_control"];
_control drawPolygon [test_polygon, [0,0,1,1]];
}];
</sqf>


|x1= <code>test_polygon = [];
|x2= Draw a polygon by adjusting the {{hl|_radius}} and {{hl|_numVertices}}
[[for]] "_i" [[from]] 1 [[to]] 12 [[do]]
<sqf>
vertices = [];
private _numVertices = 2;
private _numVertices = _numVertices max 3;
private _radius = 100;
 
for "_i" from 1 to _numVertices do
{
{
test_polygon [[pushBack]] ([[player]] [[getPos]] [10 + [[random]] 100, 360/_i]);
vertices pushBack (player getRelPos [_radius, 360 / _numVertices * _i]);
};
};


[[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlAddEventHandler]] ["Draw",  
findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw",
{
{
[[params]] ["_control"];
params ["_control"];
_control [[drawPolygon]] [test_polygon, [0,0,1,1]];
_control drawPolygon [vertices, [0,0,1,1]];
}];</code> |EXAMPLE1=
}];
</sqf>


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

Latest revision as of 15:37, 27 July 2022

Hover & click on the images for description

Description

Description:
Draws given polygon on the given map control with given color. The polygon must consist of at least 3 points. Unlike with other draw* commands and due to complexity, this command does not support filling of the polygon with color. Use drawTriangle command to construct and fill polygon shape as a workaround.
Groups:
GUI Control - Map

Syntax

Syntax:
map drawPolygon [polygon, color]
Parameters:
map: Control
polygon: Array of Position3D
color: Color (RGBA)
Return Value:
Nothing

Examples

Example 1:
test_polygon = []; for "_i" from 1 to 12 do { test_polygon pushBack (player getPos [10 + random 100, 360 / _i]); }; findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw", { params ["_control"]; _control drawPolygon [test_polygon, [0,0,1,1]]; }];
Example 2:
Draw a polygon by adjusting the _radius and _numVertices
vertices = []; private _numVertices = 2; private _numVertices = _numVertices max 3; private _radius = 100; for "_i" from 1 to _numVertices do { vertices pushBack (player getRelPos [_radius, 360 / _numVertices * _i]); }; findDisplay 12 displayCtrl 51 ctrlAddEventHandler ["Draw", { params ["_control"]; _control drawPolygon [vertices, [0,0,1,1]]; }];

Additional Information

See also:
drawEllipse drawIcon drawLine drawRectangle drawArrow drawTriangle inPolygon

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