​plot​ annotation

The annotation plot accepts one mandatory argument — the value of a series type — and displays it on the chart as a line. A very basic call looks like this:

However, because there are automatic type conversions in Pine, instead of a series type value, any numerical value can be transmitted. For example:

In this case, the value 125.2 will be automatically converted to a series type value which will be the same number on every bar. The plot will be represented as a horizontal line.

The annotation plot has a multitude of optional arguments, in particular those which set the graph’s display style: style, color, title, linewidth, transparency, and others.

The parameter color can have a different effect depending on the transmitted value. If it is set equal to a color type’s constant, for example red, then the whole chart will be plotted with a red color:

However, the argument color can receive an expression of a series type of colored values as values. This series of colors will be used to color the chart when rendered. For example:

Interest also represents the argument offset of the function plot. It specifies the shift used when the chart is plotted (negative values shift the chart to the left, while positive values — to the right)¹. For example:

As can be seen in the screenshot, the red series has been shifted to the left (since the argument’s value offset is negative), while the green series has been shifted to the right (its value offset is positive).