Plotting and drawing

Call plot with the same title on every bar to build one line. Options marked fixed are read on the first call and must be a literal, an input or a constant. For a see-through colour, wrap it in color.fade: color.fade(color.blue, 70) is blue at 70% transparency. A script may draw at most 128 plots and candles together. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

A missing value leaves a gap in the line on that bar.

On the newest bar the value is drawn again on every update until the bar closes.

Both plots must be drawn with plot somewhere in the script. A bar where band is not called is left unshaded. A script may draw at most 128 bands. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

Where either plot has a gap, there is nothing to shade.

The newest 10,000 marks are kept; older ones are dropped quietly. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

time is a bar time in milliseconds, like time. price is in the symbol's quote currency.

A missing price or time is ignored: the mark goes above or below this bar as if it was left out.

Each call draws a new line. The newest 2,000 lines, boxes, polylines and vertical lines together are kept; older ones are dropped quietly. To draw one line that moves, call it only on the last bar (if bar.last). It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

Times are bar times in milliseconds, such as time or time[10]. Prices are in the symbol's quote currency.

A missing time or price stops the script with NS210, so check it with ismissing first.

Each call draws a new box. The newest 2,000 lines, boxes, polylines and vertical lines together are kept; older ones are dropped quietly. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

Times are bar times in milliseconds. Prices are in the symbol's quote currency.

A missing time or price stops the script with NS210, so check it with ismissing first.

Point i is (times[i], prices[i]), so both arrays must be the same length. The newest 2,000 lines, boxes, polylines and vertical lines together are kept. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

Times are bar times in milliseconds. Prices are in the symbol's quote currency.

A point with a missing time or price is skipped by the chart.

Only the bars where it is called are tinted. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

It takes a colour, never a number, so it never sees missing.

It works for scripts drawn over the price on a candle chart. Bars where it is not called keep their usual colours. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

It takes colours, never numbers, so it never sees missing.

A script may draw at most 128 plots and candles together. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

Prices in the symbol's quote currency.

A bar with a missing price draws no candle.

Only the newest bar's table is shown, so a table drawn on every bar always shows the latest values. A table holds at most 30 rows and 10 cells per row; text longer than 100 characters in a cell is cut short. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

A missing number in a cell shows as missing.

Use it when one cell needs to stand out. Plain text, numbers and bools also work as cells. To show a number, put it in text first: "$(close)".

It takes text and colours, never numbers, so it never sees missing.

A level is written in setup, outside on bar, because it never changes from bar to bar. It suits oscillators: zero lines, overbought and oversold. A script may have at most 128 levels.

The value must be a real number: a missing value stops the script with NS210.

Unlike band, the edges do not have to be plots of their own. shade draws two hidden plots (no legend, invisible) and fills between them, so those two names count toward the 128 plots and candles a script may draw, and they must not match a title you use for plot or candle. Call it with the same title on every bar to build one shaded area. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

A missing top or bottom leaves that bar unshaded.

On the newest bar the shading is drawn again on every update until the bar closes.

Each call draws a new line, like line. The newest 2,000 lines, boxes, polylines and vertical lines together are kept; older ones are dropped quietly. For one line, call it on one bar only, for example inside if bar.last. For a fixed line across the whole pane that never moves, level is simpler. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

The price is in the symbol's quote currency. The line starts at the bar's opening time.

A missing price draws nothing.

Unlike line, which runs between two prices, a vertical line always spans the whole pane, however the price scale moves. Each call draws a new line; the newest 2,000 lines, boxes, polylines and vertical lines together are kept, older ones are dropped quietly. For one line that marks an event, call it on the bar where the event happens. It is an effect: it may run anywhere inside on bar, also inside an if, a loop or a function called from on bar, but not in setup or inside a higher block (NS230). A bar that runs again first loses everything it drew.

time is a bar time in milliseconds, like time.

A missing time draws the line on this bar.