Color parameters
Several built-in functions for cell formats, such as Cellfill, and the Canvas functions take a color as a parameter. You can specify a color using a name(listed below) or a hex integer to specify an RGB (red, green and blue) value, and optionally alpha (transparency). You can also specify color parameters for User-defined functions, using the Color qualifier in the parameter declaration.
Color names
You can specify 140 colors color by name. For example, CellFill('Green'). These are the same names used in html for web pages [1].
These are the standard color names:
| Name | Color |
| AliceBlue | |
| AntiqueWhite | |
| Aqua | |
| Aquamarine | |
| Azure | |
| Beige | |
| Bisque | |
| Black | |
| BlanchedAlmond | |
| Blue | |
| BlueViolet | |
| Brown | |
| BurlyWood | |
| CadetBlue | |
| Chartreuse | |
| Chocolate | |
| Coral | |
| CornflowerBlue | |
| Cornsilk | |
| Crimson | |
| Cyan | |
| DarkBlue | |
| DarkCyan | |
| DarkGoldenrod | |
| DarkGray | |
| DarkGreen | |
| DarkKhaki | |
| DarkMagenta | |
| DarkOliveGreen | |
| DarkOrange | |
| DarkOrchid | |
| DarkRed | |
| DarkSalmon | |
| DarkSeaGreen | |
| DarkSlateBlue | |
| DarkSlateGray | |
| DarkTurquoise | |
| DarkViolet | |
| DeepPink | |
| DeepSkyBlue | |
| DimGray | |
| DodgerBlue | |
| Firebrick | |
| FloralWhite | |
| ForestGreen | |
| Fuchsia | |
| Gainsboro | |
| GhostWhite | |
| Gold | |
| Goldenrod | |
| Gray | |
| Green | |
| GreenYellow | |
| Honeydew | |
| HotPink | |
| IndianRed | |
| Indigo | |
| Ivory | |
| Khaki | |
| Lavender | |
| LavenderBlush | |
| LawnGreen | |
| LemonChiffon | |
| LightBlue | |
| LightCoral | |
| LightCyan | |
| LightGray | |
| LightGreen | |
| LightPink | |
| LightSalmon | |
| LightSeaGreen | |
| LightSkyBlue | |
| LightSlateGray | |
| LightSteelBlue | |
| LightYellow | |
| Lime | |
| LimeGreen | |
| Linen | |
| Magenta | |
| Maroon | |
| MediumAquamarine | |
| MediumBlue | |
| MediumOrchid | |
| MediumPurple | |
| MediumSeaGreen | |
| MediumSlateBlue | |
| MediumSpringGreen | |
| MediumTurquoise | |
| MediumVioletRed | |
| MidnightBlue | |
| MintCream | |
| MistyRose | |
| Moccasin | |
| NavajoWhite | |
| Navy | |
| OldLace | |
| Olive | |
| OliveDrab | |
| Orange | |
| OrangeRed | |
| Orchid | |
| PaleGoldenrod | |
| PaleGreen | |
| PaleTurquoise | |
| PaleVioletRed | |
| PapayaWhip | |
| PeachPuff | |
| PeaGreen | |
| Peru | |
| Pink | |
| Plum | |
| PowderBlue | |
| Purple | |
| Red | |
| RedPeach | |
| RosyBrown | |
| RoyalBlue | |
| SaddleBrown | |
| Salmon | |
| SandyBrown | |
| SeaGreen | |
| SeaShell | |
| Sienna | |
| Silver | |
| SkyBlue | |
| SlateBlue | |
| SlateGray | |
| SmoothBlue | |
| Snow | |
| SpringGreen | |
| SteelBlue | |
| Tan | |
| Teal | |
| Thistle | |
| Tomato | |
| Turquoise | |
| Violet | |
| Wheat | |
| White | |
| WhiteSmoke | |
| Yellow | |
| YellowGreen |
Color integers
A color integer encodes the RGB (red, green and blue) channels, and optionally the Alpha channel, numerically. The value is encoded as:
0xff000000 * alpha + 0x00ff0000 * red + 0x0000ff00 * green + 0x000000ff * blue
where «alpha», «red», «green» and «blue» are each between 0 and 255 inclusively. Without the alpha, an RGB number is
0x00ff0000 * red + 0x0000ff00 * green + 0x000000ff * blue
Color integers are often written in hex, such as 0x4682b4 for 'SteelBlue, where the red is 0x46, the green is 0x82, and the blue is 0xb4.
An «alpha» of 255 (0xff) is totally opaque, and an «alpha» of 1 (0x01) is almost completely transparent. When the alpha is 0x00, built-in function understand this to be an RGB number with full opacity.
Color parameters
You might define your own user-defined functions that accept a color parameter. For example, the following UDF would return the Red color channel for a color:
GetRed( ['YellowGreen', 'Olive', 0x12345678] ) → [ 0x009a, 0x0080, 0x0034 ]- (Note: To see the result in Hex, set the number format to Hexadecimal)
Manipulating the RGBA components of a color integer
This color library includes these functions:
- RGBA( r, g, b, a )
- Convert from r,g,b and optionally a components, each on a 0.0 to 1.0 scale, to a color integer.
- RGBA_components( c )
- Return the r,g,b and a components for a color (either name or integer), each on a scale of 0.0 to 1.0.
- ColorNameToColorInt( c )
- Return the color integer for a named color.
Built-in functions that have color parameters
- Canvas
- CanvasDrawLine
- CanvasDrawRectangle
- CanvasDrawEllipse
- CanvasDrawText
- CanvasDrawPolygon
- CellFill
- CellBar
- CellFont
History
Introduced in Analytica 5.0
Enable comment auto-refresher