{"name":"drawEllipse","title":"drawEllipse","type":"command","url":"https://community.bistudio.com/wiki/drawEllipse","revid":377551,"updated":"2026-01-02T06:54:48Z","groups":["GUI Control - Map"],"status":"ok","games":{"arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma1 1.00","arma3_since":"0.50","description":"Draws an ellipse on the map. Just like with marker or trigger area, negative *a* and *b* will result in hexagon.","syntaxes":[{"syntax":"map drawEllipse [centre, a, b, angle, color, fill, alignWithMap]","params":[{"name":"map","type":"Control","type_expr":"Control"},{"name":"centre","type":"Object or Position2D, Position3D","description":"ellipse's centre","type_expr":"Object | Position2D | Position3D"},{"name":"a","type":"Number","description":"horizontal (x) radius","type_expr":"Number"},{"name":"b","type":"Number","description":"vertical (y) radius","type_expr":"Number"},{"name":"angle","type":"Number","description":"angle of rotation in degrees","type_expr":"Number"},{"name":"color","type":"Color (RGBA)","description":"line color","type_expr":"Color"},{"name":"fill","type":"String","description":"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]","type_expr":"String"},{"name":"alignWithMap","type":"Boolean","optional":true,"default":"true","description":"when false the shape will not follow map rotation.","type_expr":"Boolean","since":"arma3 2.18","text":"alignWithMap: Boolean - (Optional, default true) - when false the shape will not follow map rotation."}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"map"},"right":{"text":"[centre, a, b, angle, color, fill, alignWithMap]"}}],"examples":[{"text":"```sqf\nfindDisplay 12 displayCtrl 51 ctrlAddEventHandler [\"Draw\",\n{\n    _this select 0 drawEllipse [\n        player, 10, 10, 0, [1, 0, 0, 1], \"\"\n    ];\n    _this select 0 drawEllipse [\n        player, -10, -10, 0, [1, 1, 1, 1], \"#(rgb,8,8,3)color(1,0.6,0,1)\"\n    ];\n    _this select 0 drawEllipse [\n        player, -10, -10, 90, [0, 0, 1, 1], \"\"\n    ];\n}];\n```","code":["findDisplay 12 displayCtrl 51 ctrlAddEventHandler [\"Draw\", \n{\n\t_this select 0 drawEllipse [\n\t\tplayer, 10, 10, 0, [1, 0, 0, 1], \"\"\n\t];\n\t_this select 0 drawEllipse [\n\t\tplayer, -10, -10, 0, [1, 1, 1, 1], \"#(rgb,8,8,3)color(1,0.6,0,1)\"\n\t];\n\t_this select 0 drawEllipse [\n\t\tplayer, -10, -10, 90, [0, 0, 1, 1], \"\"\n\t];\n}];"]}],"see_also":["drawArrow","drawIcon","drawLine","drawRectangle","drawPolygon","drawTriangle","drawXPolygon"],"notes":[{"user":"Waffle SS.","date":"2015-07-07T21:28:00Z","text":"Be careful when using this command. Unlike map markers, the draw commands can decrease your framerate."}]}