Editors' picksPINE LIBRARY

[e2] Drawing Library :: Horizontal Ray

By e2e4
Updated
█ OVERVIEW
Library "e2hray"
A drawing library that contains the hray() function, which draws a horizontal ray/s with an initial point determined by a specified condition. It plots a ray until it reached the price. The function let you control the visibility of historical levels and setup the alerts.

█ HORIZONTAL RAY FUNCTION
hray(condition, level, color, extend, hist_lines, alert_message, alert_delay, style, hist_style, width, hist_width)
  Parameters:
    condition: Boolean condition that defines the initial point of a ray
    level: Ray price level.
    color: Ray color.
    extend: (optional) Default value true, current ray levels extend to the right, if false - up to the current bar.
    hist_lines: (optional) Default value true, shows historical ray levels that were revisited, default is dashed lines. To avoid alert problems set to 'false' before creating alerts.
    alert_message: (optional) Default value string(na), if declared, enables alerts that fire when price revisits a line, using the text specified
    alert_delay: (optional) Default value int(0), number of bars to validate the level. Alerts won't trigger if the ray is broken during the 'delay'.
    style: (optional) Default value 'line.style_solid'. Ray line style.
    hist_style: (optional) Default value 'line.style_dashed'. Historical ray line style.
    width: (optional) Default value int(1), ray width in pixels.
    hist_width: (optional) Default value int(1), historical ray width in pixels.
  Returns: void

█ EXAMPLES
 • Example 1. Single horizontal ray from the dynamic input.

snapshot

 • Example 2. Multiple horizontal rays on the moving averages cross.

snapshot

 • Example 3. Horizontal ray at the all time highs with an alert.


snapshot
Release Notes
v2
- xloc context switched from 'bar_index' to 'time'.
- alert_delay should be declared in minutes instead of bars.
- deep history reference bug fixed.
displaydrawinghrayLINEMarket Geometrytechindicatortools
e2e4
Pisces swimming through the river
All their life against the stream
Searching for a hook to catch on
And see their sun beam
Then suffocate in painful tortures
On cutting tables of callous men
Under a knife of handsome butchers
Emeralds are ripped away

Pine library

In true TradingView spirit, the author has published this Pine code as an open-source library so that other Pine programmers from our community can reuse it. Cheers to the author! You may use this library privately or in other open-source publications, but reuse of this code in a publication is governed by House rules.

Disclaimer