/***********************************************************************************************
Title:      Bar Countdown Indicator for eSignal
By:         Divergence Software, Inc.
Web:        http://www.sr-analyst.com

================================================================================================
Project Description:   

A bar countdown timer with threshold alerts that operates on any
bar interval.

Dislaimer: For educational purposes only! Obviously, no guarantees 
whatsoever and use at your own risk.

*********************************************************************
Project Description:   

This indicator will display a bar countdown timer on your chart that will show the amount of time 
remaining in a bar (for interval charts from monthly down to 1 minute) or will show the number of ticks 
remaining in a bar (for tick charts such as "t", "p", and "v").

When an interval chart is used, you can select the countdown display to be in HH:MM:SS format or in 
total remaining seconds. When tick charts are used the display will always show the number of ticks 
remaining.

You can set a threshold alert to trigger when a certain amount of time (or a certain number of ticks) 
remains in the current bar. The alerts can be audible, pop-up, or email or any combination.

Note that the indicator updates each time the underlying symbol is updated. In fast-moving securities 
this will give the appearance that the timer is updating on a second-by-second basis. When applying 
the timer to slow-moving securities, keep in mind that the timer updates will not be as frequent.


Indicator Parameters:

eSignal TZ Offset (Hours):  This is only required if your eSignal data timezone is different
                            from your local timezone. In eSignal Preferences you can select
                            the data timezone (Local, Greenwich, and Exchange). If Greenwich
                            or Exchange is selected then you must enter the delta, in hours,
                            to reach your local timezone from the selected data timezone. So
                            if your local timezone is GMT +6 and the data timezone in eSignal
                            happens to be GMT +8, then you would need to enter -2 
                            (i.e., minus 2) in this field since 2 hours needs to be subtracted
                            from the data timezone to reach your local timezone.

Time Countdown Format:      Select the display format for the countdown timer. You can 
                            select between "hh:mm:ss" and "Seconds". If "hh:mm:ss" is 
                            selected, the remaining time in a bar will be displayed in
                            hours:minutes:seconds format. If "Seconds" is selected, the
                            remaining bar time will be displayed in total seconds. Note
                            that if a tick interval is selected the display format will
                            always default to the number of ticks left in the bar.

Horizontal Alignment:       The bar countdown will always display at the bottom (or top)
                            of the chart, to the right of the most current price bar. Use 
                            the "Horizontal Alignment" option to shift the display further 
                            to the left or right, as necessary. Use a negative number to 
                            shift left, a positive number to shift right.

Vertical Alignment:         Select "Top" to align the countdown display with the top of
                            the chart. Select "Bottom" to align the countdown display 
                            with the Bottom of the chart. Select "On Bar" to align the 
                            countdown display with the current price bar. The default is 
                            Bottom.

FG Color:                   The color to use to display the countdown text. Default 
                            is black.

BG Color:                   The color to use for the background of the countdown display.
                            The default is light-red.

Text FontSize:              The size of the font to use in the countdown display. The
                            default is 14. You can select any value between 8 and 55.

Frame around Timer:         True or False. When True a frame will be drawn around the 
                            countdown display. When False, no frame will be drawn.              

Alert Threshold:            This is the number of seconds (or ticks, in the case of a 
                            tick chart) prior to the close of a bar that should trigger
                            an alert. So, for example, if you were viewing a 60-min chart
                            and you set the "Alert Threshold" to 5, then an alert would 
                            be triggered when only 5 minutes were remaining in the 60-min
                            bar. If you were viewing a 500T chart, and you set the 
                            "Alert Threshold" value to 10, then an alert would be triggered
                            when only 10 ticks remain in the current 500T bar. The default
                            value is 0 which means no threshold (and no alert).

Alert Use Sound?:           True or False. Set this option to True to generate a sound alert 
                            when the Alert Threshold is reached. Default value is False.

Alert Use Popup?:           True or False. Set this option to true to generate a popup alert 
                            when the Alert Threshold is reached. Default value is False.

Alert Use Email?:           True or False. Set this option to True to generate an email alert 
                            when the Alert Threshold is reached. Default value is False.

Alert WAV File:             Use this option to set the WAV file that will play when a 
                            Sound alert is triggered.


Disclaimer: For educational purposes only! Obviously, no guarantees 
whatsoever and use at your own risk.

**********************************************************************/