Difference between revisions of "GradientColor"
Jump to navigation
Jump to search
| Line 1: | Line 1: | ||
| − | Returns | + | <div style="display:inline;width:350px;float:right;font-size:85%;text-align:center;background:#FFF;border:1px solid #C0C0C0;"> |
| + | [[File:GradientColorsExample.png|350px|alt=Example of Gradient Colors|Example of Gradient Colors]] | ||
| + | The default Momentum and Rate of Change indicators use GradientColors to signal extended values. | ||
| + | </div> | ||
| + | |||
| + | Returns a RGB color number, representing a shade of color from within a defined color range. | ||
| + | |||
| + | The gradient shade of color is determined by the value of the specified numerical expression in relation to the defined value range. | ||
| + | |||
For example, if the color range is defined as White to Black, and the value range is defined from 0 to 2, GradientColor will return an RGB color number representing White for the value of 0, Gray for the value of 1, and Black for the value of 2. White will be returned for all values < 0, and Black for all values > 2. | For example, if the color range is defined as White to Black, and the value range is defined from 0 to 2, GradientColor will return an RGB color number representing White for the value of 0, Gray for the value of 1, and Black for the value of 2. White will be returned for all values < 0, and Black for all values > 2. | ||
| − | + | == Usage == | |
| − | <syntaxhighlight>GradientColor(Value,Min,Max,StartColor,EndColor)</syntaxhighlight> | + | <syntaxhighlight>GradientColor(Value, Min, Max, StartColor, EndColor)</syntaxhighlight> |
| + | |||
| + | Where: | ||
| − | + | :'''Value''' – the specified numerical expression. | |
| − | + | :'''Min''' – the minimum value of the value range. If '''Value''' is equal to or lower than the minimum value, the '''StartColor''' is returned. | |
| − | + | :'''Max''' – the maximum value of the value range. If '''Value''' is equal to or greater than the maximum value, the '''EndColor''' is returned. | |
| − | + | :'''StartColor''' – the starting color of the gradient color range. | |
| − | + | :'''EndColor''' – the ending color of the gradient color range. | |
| − | + | == Example == | |
Plot an ADX indicator in Gradient Color, where Magenta gradually changes into White for the indicator values from 5 to 50: | Plot an ADX indicator in Gradient Color, where Magenta gradually changes into White for the indicator values from 5 to 50: | ||
| + | <syntaxhighlight>Variable: ADXValue(0); | ||
| + | |||
| + | ADXValue = ADX(14); | ||
| + | Plot1(ADXValue, "ADXValue"); | ||
| − | + | SetPlotColor(1, GradientColor (ADXValue, 5, 50, Magenta, White));</syntaxhighlight> | |
| − | |||
| − | |||
| − | SetPlotColor (1,GradientColor (ADXValue,5,50, Magenta,White));</syntaxhighlight> | ||
| − | |||
| − | |||
| − | |||
[[Category:Colors]] | [[Category:Colors]] | ||
Latest revision as of 12:31, 7 February 2012
The default Momentum and Rate of Change indicators use GradientColors to signal extended values.
Returns a RGB color number, representing a shade of color from within a defined color range.
The gradient shade of color is determined by the value of the specified numerical expression in relation to the defined value range.
For example, if the color range is defined as White to Black, and the value range is defined from 0 to 2, GradientColor will return an RGB color number representing White for the value of 0, Gray for the value of 1, and Black for the value of 2. White will be returned for all values < 0, and Black for all values > 2.
Usage
GradientColor(Value, Min, Max, StartColor, EndColor)
Where:
- Value – the specified numerical expression.
- Min – the minimum value of the value range. If Value is equal to or lower than the minimum value, the StartColor is returned.
- Max – the maximum value of the value range. If Value is equal to or greater than the maximum value, the EndColor is returned.
- StartColor – the starting color of the gradient color range.
- EndColor – the ending color of the gradient color range.
Example
Plot an ADX indicator in Gradient Color, where Magenta gradually changes into White for the indicator values from 5 to 50:
Variable: ADXValue(0);
ADXValue = ADX(14);
Plot1(ADXValue, "ADXValue");
SetPlotColor(1, GradientColor (ADXValue, 5, 50, Magenta, White));
