---
name: "BIN_fnc_handDrawEllipse"
type: function
status: ok
groups: ["Diary"]
arma3_since: "1.94"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIN_fnc_handDrawEllipse
revid: 309651
updated: 2022-05-05T12:07:59Z
---

# BIN_fnc_handDrawEllipse

*Function · Diary · Arma 3 v1.94*

## Description

Show hand-drawn ellipse in the map

> [!NOTE]
> This content is exclusive to the Arma 3 Contact Expansion.

## Syntax

*syntax inferred from the function header*

```sqf
[param0, param1, param2, param3, param4, param5, param6, param7, param8, param9, param10, param11, param12, param13, param14] call BIN_fnc_handDrawEllipse
```

**Parameters:**

- `param0` — 0: STRING - Unique ID of the ellipse. When such ellipse already exists, it will override it.
- `param1` — 1: ARRAY - center position
- `param2` — 2: NUMBER - semi-major axis
- `param3` — 3: NUMBER - semi-minor axis
- `param4` — 4: NUMBER - angle
- `param5` — 5: ARRAY - color in [r,g,b,a] format
- `param6` — 6: STRING - fill texture
     BOOL - true for default pen-blue color, false for the same, but faded

  Optional:
- `param7` — 7: NUMBER - radius coef
- `param8` — 8: NUMBER - length coef
- `param9` — 9: NUMBER or ARRAY: thickness
- `param10` — 10: ARRAY - radius curve
- `param11` — 11: BOOL - true if clockwise
- `param12` — 12: NUMBER - starting angle
- `param13` — 13: ARRAY - random thickness offset in format [min,mid,max]
- `param14` — 14: NUMBER - number od drawing steps

**Returns:** NOTHING

## Examples

### Example 1

```sqf
//--- Show an ellipse on player's position
["test1",position player,300,400,15] call BIN_fnc_handDrawEllipse;
```

### Example 2

```sqf
//--- Show the same ellipse, but faded
["test1",position player,300,400,15,nil,false] call BIN_fnc_handDrawEllipse;
```

## Function header

The comment at the top of the function's file in the game; this page's params, syntax, returns, examples, description come from it.

```sqf
/*
Description:
    Show hand-drawn ellipse in the map

Parameter(s):
    0: STRING - Unique ID of the ellipse. When such ellipse already exists, it will override it.
    1: ARRAY - center position
    2: NUMBER - semi-major axis
    3: NUMBER - semi-minor axis
    4: NUMBER - angle
    5: ARRAY - color in [r,g,b,a] format
    6: STRING - fill texture
       BOOL - true for default pen-blue color, false for the same, but faded

    Optional:
    7: NUMBER - radius coef
    8: NUMBER - length coef
    9: NUMBER or ARRAY: thickness
    10: ARRAY - radius curve
    11: BOOL - true if clockwise
    12: NUMBER - starting angle
    13: ARRAY - random thickness offset in format [min,mid,max]
    14: NUMBER - number od drawing steps

Returns:
    NOTHING

Examples:
    //--- Show an ellipse on player's position
    ["test1",position player,300,400,15] call BIN_fnc_handDrawEllipse;

    //--- Show the same ellipse, but faded
    ["test1",position player,300,400,15,nil,false] call BIN_fnc_handDrawEllipse;
*/
```

<sub>Source: [BI Community Wiki — BIN fnc handDrawEllipse](https://community.bistudio.com/wiki/BIN_fnc_handDrawEllipse) (revision 309651).</sub>