line functions

Language version: 2 · Reference version: 2.7 · Date: 2026-10-25 · Compiler build: df7b3b14 · Namespace: line · Entries: 25

`line` (library)

Definition Functions for creating and mutating line drawings between two chart points. Notes

A line.<name>(ln, ...) function can also be called on the line as ln.<name>(...), for example ln.set_x2(bar_index). The one exception is the four-argument form of line.set_xloc, which is a function only (see that entry).

Example

//@lipi=2
indicator("line Library Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[20], close[20], bar_index, close, color=color.blue, width=2)
    line.set_style(l, line.style_dashed)
}

`line.all` (function)

Definition Returns the array of all existing line objects (same as line.all). Syntax

line.all() → series array<line>

Returns series array<line> An array of line IDs, oldest to newest. Example

//@lipi=2
indicator("line.all Example", overlay=true)
plot(array.length(line.all), title="Count")

`line.copy` (function)

Definition Creates a copy of a line. Syntax

line.copy(series line id) → series line

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.

Returns series line The new line ID. Example

//@lipi=2
indicator("line.copy Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    c = line.copy(l)
}

`line.delete` (function)

Definition Deletes a line. Any linefill that uses this line is also deleted. Syntax

line.delete(series line id) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Line object to delete.

Returns void void Example

//@lipi=2
indicator("line.delete Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[5], high[5], bar_index, high)
    line.delete(l)
}

`line.get_price` (function)

Definition Returns the price of a line at x (interpolated between the two endpoints). Syntax

line.get_price(series line id, series int x) → series float

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`x`	`series int`	yes	X-coordinate (bar index or time, depending on xloc).

Returns series float Price at x. Example

//@lipi=2
indicator("line.get_price Example", overlay=true)
static line l = line(na)
if barstate.islast {
    l := line.new(bar_index[10], high[10], bar_index, high, color=color.red)
}
plot(na(l) ? na : line.get_price(l, bar_index))

`line.get_x1` (function)

Definition Returns the first point’s x-coordinate. Syntax

line.get_x1(series line id) → series int

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.

Returns series int X-coordinate of the first point. Example

//@lipi=2
indicator("line.get_x1 Example", overlay=true)
static line l = line(na)
if barstate.islast {
    l := line.new(bar_index[10], high[10], bar_index, high, color=color.red)
}
plot(na(l) ? na : line.get_x1(l))

`line.get_x2` (function)

Definition Returns the second point’s x-coordinate. Syntax

line.get_x2(series line id) → series int

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.

Returns series int X-coordinate of the second point. Example

//@lipi=2
indicator("line.get_x2 Example", overlay=true)
static line l = line(na)
if barstate.islast {
    l := line.new(bar_index[10], high[10], bar_index, high, color=color.red)
}
plot(na(l) ? na : line.get_x2(l))

`line.get_y1` (function)

Definition Returns the first point’s y-coordinate. Syntax

line.get_y1(series line id) → series float

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.

Returns series float Y-coordinate of the first point. Example

//@lipi=2
indicator("line.get_y1 Example", overlay=true)
static line l = line(na)
if barstate.islast {
    l := line.new(bar_index[10], high[10], bar_index, high, color=color.red)
}
plot(na(l) ? na : line.get_y1(l))

`line.get_y2` (function)

Definition Returns the second point’s y-coordinate. Syntax

line.get_y2(series line id) → series float

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.

Returns series float Y-coordinate of the second point. Example

//@lipi=2
indicator("line.get_y2 Example", overlay=true)
static line l = line(na)
if barstate.islast {
    l := line.new(bar_index[10], high[10], bar_index, high, color=color.red)
}
plot(na(l) ? na : line.get_y2(l))

`line.new` (function, overload 1)

Definition Creates a line between two points. Coordinates can be passed as x1/y1/x2/y2 or as chartPoint first_point/second_point. Syntax

line.new(series int x1, series float y1, series int x2, series float y2, series string xloc, series string extend, series color color, series string style, series int width, const bool forceOverlay) → series line

Parameters

Name	Type	Required	Description	Values	Default
`x1`	`series int`	yes	X-coordinate of the first point (bar index or time, depending on xloc).
`y1`	`series float`	yes	Y-coordinate (price) of the first point.
`x2`	`series int`	yes	X-coordinate of the second point.
`y2`	`series float`	yes	Y-coordinate (price) of the second point.
`xloc`	`series string`	no	xloc.bar_index or xloc.bar_time. Default is bar_index.	`xloc.bar_index`, `xloc.bar_time`	`xloc.bar_index`
`extend`	`series string`	no	extend.none, left, right, or both. Default is none.	`extend.both`, `extend.left`, `extend.none`, `extend.right`	`extend.none`
`color`	`series color`	no	Line color. Optional.		`na`
`style`	`series string`	no	line.style_* constant. Optional.	`line.style_arrow_both`, `line.style_arrow_left`, `line.style_arrow_right`, `line.style_dashed`, `line.style_dotted`, `line.style_solid`	`line.style_solid`
`width`	`series int`	no	Line width in pixels. Optional.		`1`
`forceOverlay`	`const bool`	no	If true, the line is drawn on the main chart pane even when the script runs in its own pane. Optional. The default is false. Spelled `forceOverlay` here, unlike the `force_overlay` of the other drawing and plot functions: `force_overlay=` is rejected on `line.new`.		`false`

Returns series line The ID of the created line. Example

//@lipi=2
indicator("line.new Example", overlay=true)
if barstate.islast {
    line.new(bar_index[10], high[10], bar_index, high, color=color.red, width=2, style=line.style_solid, extend=extend.none)
}

`line.new` (function, overload 2)

Definition Creates a line between two points. Coordinates can be passed as x1/y1/x2/y2 or as chartPoint first_point/second_point. Syntax

line.new(series chartPoint first_point, series chartPoint second_point, series string xloc, series string extend, series color color, series string style, series int width, const bool forceOverlay) → series line

Parameters

Name	Type	Required	Description	Values	Default
`first_point`	`series chartPoint`	yes	Chart point for the first endpoint (alternative to x1/y1). Required argument.
`second_point`	`series chartPoint`	yes	Chart point for the second endpoint (alternative to x2/y2). Required argument.
`xloc`	`series string`	no	xloc.bar_index or xloc.bar_time. Default is bar_index.	`xloc.bar_index`, `xloc.bar_time`	`xloc.bar_index`
`extend`	`series string`	no	extend.none, left, right, or both. Default is none.	`extend.both`, `extend.left`, `extend.none`, `extend.right`	`extend.none`
`color`	`series color`	no	Line color. Optional.		`na`
`style`	`series string`	no	line.style_* constant. Optional.	`line.style_arrow_both`, `line.style_arrow_left`, `line.style_arrow_right`, `line.style_dashed`, `line.style_dotted`, `line.style_solid`	`line.style_solid`
`width`	`series int`	no	Line width in pixels. Optional.		`1`
`forceOverlay`	`const bool`	no	If true, the line is drawn on the main chart pane even when the script runs in its own pane. Optional. The default is false. Spelled `forceOverlay` here, unlike the `force_overlay` of the other drawing and plot functions: `force_overlay=` is rejected on `line.new`.		`false`

Returns series line The ID of the created line. Example

//@lipi=2
indicator("line.new Example", overlay=true)
if barstate.islast {
    line.new(bar_index[10], high[10], bar_index, high, color=color.red, width=2, style=line.style_solid, extend=extend.none)
}

`line.set_color` (function)

Definition Sets a line’s color. Syntax

line.set_color(series line id, series color color) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`color`	`series color`	yes	Color value.

Returns void void Example

//@lipi=2
indicator("line.set_color Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_color(l, color.blue)
}

`line.set_extend` (function)

Definition Sets whether a line extends past its endpoints. Syntax

line.set_extend(series line id, series string extend) → void

Parameters

Name	Type	Required	Description	Values
`id`	`series line`	yes	Drawing object to modify or query.
`extend`	`series string`	yes	extend.none, left, right, or both.	`extend.both`, `extend.left`, `extend.none`, `extend.right`

Returns void void Example

//@lipi=2
indicator("line.set_extend Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_extend(l, extend.right)
}

`line.set_point1` (function)

Definition Sets a line’s first endpoint from a chartPoint. X is taken from the point’s index or time depending on the line’s xloc. Syntax

line.set_point1(series line id, series chartPoint point) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Line object to modify.
`point`	`series chartPoint`	yes	A chartPoint for the first endpoint.

Returns void void Example

//@lipi=2
indicator("line.set_point1 Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_point1(l, chartPoint.from_index(bar_index[20], high[20]))
}

`line.set_point2` (function)

Definition Sets a line’s second endpoint from a chartPoint. X is taken from the point’s index or time depending on the line’s xloc. Syntax

line.set_point2(series line id, series chartPoint point) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Line object to modify.
`point`	`series chartPoint`	yes	A chartPoint for the second endpoint.

Returns void void Example

//@lipi=2
indicator("line.set_point2 Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_point2(l, chartPoint.from_index(bar_index, close))
}

`line.set_style` (function)

Definition Sets a line’s style (line.style_*). Syntax

line.set_style(series line id, series string style) → void

Parameters

Name	Type	Required	Description	Values
`id`	`series line`	yes	Drawing object to modify or query.
`style`	`series string`	yes	Style constant for this drawing type.	`line.style_arrow_both`, `line.style_arrow_left`, `line.style_arrow_right`, `line.style_dashed`, `line.style_dotted`, `line.style_solid`

Returns void void Example

//@lipi=2
indicator("line.set_style Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_style(l, line.style_dashed)
}

`line.set_width` (function)

Definition Sets a line’s width in pixels. Syntax

line.set_width(series line id, series int width) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`width`	`series int`	yes	Width in pixels.

Returns void void Example

//@lipi=2
indicator("line.set_width Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_width(l, 2)
}

`line.set_x1` (function)

Definition Sets a line’s first x-coordinate. Syntax

line.set_x1(series line id, series int x1) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`x1`	`series int`	yes	X-coordinate of the first line point.

Returns void void Example

//@lipi=2
indicator("line.set_x1 Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_x1(l, bar_index[10])
}

`line.set_x2` (function)

Definition Sets a line’s second x-coordinate. Syntax

line.set_x2(series line id, series int x2) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`x2`	`series int`	yes	X-coordinate of the second line point.

Returns void void Example

//@lipi=2
indicator("line.set_x2 Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_x2(l, bar_index)
}

`line.set_xloc` (function, overload 1)

Definition Sets whether a line’s x-coordinates are bar indexes or times. Syntax

line.set_xloc(series line id, series string xloc) → void

Parameters

Name	Type	Required	Description	Values
`id`	`series line`	yes	Drawing object to modify or query.
`xloc`	`series string`	yes	xloc.bar_index or xloc.bar_time.	`xloc.bar_index`, `xloc.bar_time`

Returns void void Example

//@lipi=2
indicator("line.set_xloc Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_xloc(l, xloc.bar_index)
}

`line.set_xloc` (function, overload 2)

Definition Sets whether a line’s x-coordinates are bar indexes or times. Syntax

line.set_xloc(series line id, series string xloc, series int x1, series int x2) → void

Parameters

Name	Type	Required	Description	Values
`id`	`series line`	yes	Drawing object to modify or query.
`xloc`	`series string`	yes	xloc.bar_index or xloc.bar_time.	`xloc.bar_index`, `xloc.bar_time`
`x1`	`series int`	yes	X-coordinate of the first line point.
`x2`	`series int`	yes	X-coordinate of the second line point.

Returns void void Notes

Function form only: ln.set_xloc(xloc.bar_time, x1, x2) is rejected with “Too many arguments passed into the line.set_xloc() function call. Passed 4 arguments but expected 2.” The two-argument form also works as ln.set_xloc(xloc.bar_index).

Example

//@lipi=2
indicator("line.set_xloc Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_xloc(l, xloc.bar_index)
}

`line.set_xy1` (function)

Definition Sets a line’s first endpoint (x1, y1). Syntax

line.set_xy1(series line id, series int x1, series float y1) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`x1`	`series int`	yes	X-coordinate of the first line point.
`y1`	`series float`	yes	Y-coordinate of the first line point.

Returns void void Example

//@lipi=2
indicator("line.set_xy1 Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_xy1(l, bar_index[10], high[10])
}

`line.set_xy2` (function)

Definition Sets a line’s second endpoint (x2, y2). Syntax

line.set_xy2(series line id, series int x2, series float y2) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`x2`	`series int`	yes	X-coordinate of the second line point.
`y2`	`series float`	yes	Y-coordinate of the second line point.

Returns void void Example

//@lipi=2
indicator("line.set_xy2 Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_xy2(l, bar_index, high)
}

`line.set_y1` (function)

Definition Sets a line’s first y-coordinate. Syntax

line.set_y1(series line id, series float y1) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`y1`	`series float`	yes	Y-coordinate of the first line point.

Returns void void Example

//@lipi=2
indicator("line.set_y1 Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_y1(l, high[10])
}

`line.set_y2` (function)

Definition Sets a line’s second y-coordinate. Syntax

line.set_y2(series line id, series float y2) → void

Parameters

Name	Type	Required	Description
`id`	`series line`	yes	Drawing object to modify or query.
`y2`	`series float`	yes	Y-coordinate of the second line point.

Returns void void Example

//@lipi=2
indicator("line.set_y2 Example", overlay=true)
if barstate.islast {
    l = line.new(bar_index[10], high[10], bar_index, high, color=color.red)
    line.set_y2(l, high)
}

Manual

Use Lipi with AI

Reference

`line` (library)

`line.all` (function)

`line.copy` (function)

`line.delete` (function)

`line.get_price` (function)

`line.get_x1` (function)

`line.get_x2` (function)

`line.get_y1` (function)

`line.get_y2` (function)

`line.new` (function, overload 1)

`line.new` (function, overload 2)

`line.set_color` (function)

`line.set_extend` (function)

`line.set_point1` (function)

`line.set_point2` (function)

`line.set_style` (function)

`line.set_width` (function)

`line.set_x1` (function)

`line.set_x2` (function)

`line.set_xloc` (function, overload 1)

`line.set_xloc` (function, overload 2)

`line.set_xy1` (function)

`line.set_xy2` (function)

`line.set_y1` (function)

`line.set_y2` (function)

​line (library)

​line.all (function)

​line.copy (function)

​line.delete (function)

​line.get_price (function)

​line.get_x1 (function)

​line.get_x2 (function)

​line.get_y1 (function)

​line.get_y2 (function)

​line.new (function, overload 1)

​line.new (function, overload 2)

​line.set_color (function)

​line.set_extend (function)

​line.set_point1 (function)

​line.set_point2 (function)

​line.set_style (function)

​line.set_width (function)

​line.set_x1 (function)

​line.set_x2 (function)

​line.set_xloc (function, overload 1)

​line.set_xloc (function, overload 2)

​line.set_xy1 (function)

​line.set_xy2 (function)

​line.set_y1 (function)

​line.set_y2 (function)

`line` (library)

`line.all` (function)

`line.copy` (function)

`line.delete` (function)

`line.get_price` (function)

`line.get_x1` (function)

`line.get_x2` (function)

`line.get_y1` (function)

`line.get_y2` (function)

`line.new` (function, overload 1)

`line.new` (function, overload 2)

`line.set_color` (function)

`line.set_extend` (function)

`line.set_point1` (function)

`line.set_point2` (function)

`line.set_style` (function)

`line.set_width` (function)

`line.set_x1` (function)

`line.set_x2` (function)

`line.set_xloc` (function, overload 1)

`line.set_xloc` (function, overload 2)

`line.set_xy1` (function)

`line.set_xy2` (function)

`line.set_y1` (function)

`line.set_y2` (function)