# lv_line.h (/api/public/widgets/lv_line_h)
Functions [#functions]
lv_line_set_points [#lv_line_set_points]
Set an array of points. The line object will connect these points.
```c title=" " lineNumbers=1
void lv_line_set_points(lv_obj_t *obj, const lv_point_precise_t points[], uint32_t point_num)
```
Parameters
| Name | Type | Description |
| ----------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `obj` | | pointer to a line object |
| `points` | | an array of points. Only the address is saved, so the array needs to be alive while the line exists. **May** be `NULL`. Use NULL to remove the previously assigned points of the line |
| `point_num` | `uint32_t` | number of points in 'point\_a' |
lv_line_set_points_mutable [#lv_line_set_points_mutable]
Set a non-const array of points. Identical to `lv_line_set_points` except the array may be retrieved by `lv_line_get_points_mutable`.
```c title=" " lineNumbers=1
void lv_line_set_points_mutable(lv_obj_t *obj, lv_point_precise_t points[], uint32_t point_num)
```
Parameters
| Name | Type | Description |
| ----------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `obj` | | pointer to a line object |
| `points` | | a non-const array of points. Only the address is saved, so the array needs to be alive while the line exists. **May** be `NULL`. Use NULL to remove the previously assigned points of the line |
| `point_num` | `uint32_t` | number of points in 'point\_a' |
lv_line_set_y_invert [#lv_line_set_y_invert]
Enable (or disable) the y coordinate inversion. If enabled then y will be subtracted from the height of the object, therefore the y = 0 coordinate will be on the bottom.
```c title=" " lineNumbers=1
void lv_line_set_y_invert(lv_obj_t *obj, bool en)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------ | ----------------------------------------------------------- |
| `obj` | | pointer to a line object |
| `en` | `bool` | true: enable the y inversion, false:disable the y inversion |
lv_line_get_points [#lv_line_get_points]
Get the pointer to the array of points.
```c title=" " lineNumbers=1
const lv_point_precise_t * lv_line_get_points(lv_obj_t *obj)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------ | ------------------------ |
| `obj` | | pointer to a line object |
**Returns:** — const pointer to the array of points
lv_line_get_point_count [#lv_line_get_point_count]
Get the number of points in the array of points.
```c title=" " lineNumbers=1
uint32_t lv_line_get_point_count(lv_obj_t *obj)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------ | ------------------------ |
| `obj` | | pointer to a line object |
**Returns:** `uint32_t` — number of points in array of points
lv_line_get_points_mutable [#lv_line_get_points_mutable]
Get a pointer to the mutable array of points or NULL if it is not mutable
```c title=" " lineNumbers=1
lv_point_precise_t * lv_line_get_points_mutable(lv_obj_t *obj)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------ | ------------------------ |
| `obj` | | pointer to a line object |
**Returns:** — pointer to the array of points. NULL if not mutable.
lv_line_get_y_invert [#lv_line_get_y_invert]
Get the y inversion attribute
```c title=" " lineNumbers=1
bool lv_line_get_y_invert(const lv_obj_t *obj)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------------ | ------------------------ |
| `obj` | | pointer to a line object |
**Returns:** `bool` — true: y inversion is enabled, false: disabled
lv_line_create [#lv_line_create]
Create a line object
```c title=" " lineNumbers=1
lv_obj_t * lv_line_create(lv_obj_t *parent)
```
Parameters
| Name | Type | Description |
| -------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| `parent` | | pointer to a parent widget **May** be `NULL`.. When NULL, the widget is created as a screen on the default display. |
**Returns:** — pointer to the created line
lv_line_is_point_array_mutable [#lv_line_is_point_array_mutable]
Check the mutability of the stored point array pointer.
```c title=" " lineNumbers=1
bool lv_line_is_point_array_mutable(lv_obj_t *obj)
```
Parameters
| Name | Type | Description |
| ----- | ------------------------------------------------ | ------------------------ |
| `obj` | | pointer to a line object |
**Returns:** `bool` — true: the point array pointer is mutable, false: constant
Enums [#enums]
\_lv_property_line_id_t [#_lv_property_line_id_t]
| Name | Value |
| --------------------------- | -------------------------------------------------------------- |
| `LV_PROPERTY_LINE_Y_INVERT` | `(LV_PROPERTY_LINE_START + ((int) 0 )) \| (( 11 ) << 28 )` |
| `LV_PROPERTY_LINE_END` | |
Variables [#variables]
lv_line_class [#lv_line_class]
```c title=" " lineNumbers=1
const lv_obj_class_t lv_line_class
```
Dependencies [#dependencies]