Фигуры

Существуют ситуации, когда необходимо отметить или выделить конкретные бары на графике, и когда обычный график с использованием plot может быть не оптимальным. Хотя это можно сделать, используя plot со style=plot.style_circles или style=plot.style_cross, обычно проще использовать функции аннотации plothape, plotchar и plotarrow.

study('plotshape example 1', overlay=true)
data = close >= open
plotshape(data, style=shape.xcross)

Plotshape

Функция plotshape может отображать различные формы. В приведенном ниже скрипте над всеми зелеными полосами будет отображаться символ «X»:

Первый параметр data, используется как последовательность логических значений. Крестики нарисованы на каждом истинном (true) значении. На ложных (false) и na значениях ничего не рисуется. В качестве первого аргумента графической фигуры можно использовать ряд логических значений или чисел. Значение 0 или na считается ложным, любое другое значение — истинным.

Изменяя значение параметра style, можно изменять форму.

Доступные стили:

Имя формы	Форма	Форма с текстом
shape.xcross
shape.cross
shape.circle
shape.triangleup
shape.triangledown
shape.flag
shape.arrowup
shape.arrowdown
shape.square
shape.diamond
shape.labelup
shape.labeldown

По умолчанию фигуры  plotshape рисуются над барами. Чтобы использовать другую позицию, используйте параметр location. Следующий скрипт рисует зеленый треугольник shape.triangleup над зелеными полосами и красный треугольник shape.triangledown под красными полосами:

//@version=4
study('plotshape example 2', overlay=true)
data = close >= open
plotshape(data, style=shape.triangleup,
                 location=location.abovebar, color=color.green)
plotshape(not data, style=shape.triangledown,
                 location=location.belowbar, color=color.red)

Возможные значения параметра location:

• location.abovebar — над баром.
• location.belowbar — под баром.
• location.top— над пространством y скрипта.
• location.bottom— нижняя часть пространства y скрипта.
• location.absolute— любая позиция в пространстве y.

location.absolute может использоваться, когда необходимо более точно разместить фигуры в пространстве y скрипта. Затем первый параметр функции используется как координата y.

Пример графика 2 иллюстрирует, как можно определить цвет фигуры с помощью параметра color и выражений, которые будут вычислять цвет фигуры в зависимости от условий во время выполнения.

Например:

study('plotshape example 3', overlay=true)
data = close >= open
plotshape(true, style=shape.flag, color=data ? color.green : color.red)

В данном примере первым параметром функции plotshape является  true, что означает, что фигура отображается на каждом баре. Цвет рассчитывается по выражению color=data ? color.green : color.red.

Другие особенности функции plotshape:

• Установка имени отображаемой серии данных с помощью параметра title.
• Сдвинуть серию фигур влево / вправо с помощью параметра offset.
• Установить прозрачность фигур с помощью параметра transp.
• Используйте параметр  text для отображения короткого текста над / под фигурой. Вы можете использовать \n для разделения текстовых строк.