Color parameters
New to Analytica 5.0
Several built-in functions for cell formats, such as [[Cellfill], and Canvas functions have color parameters. You can specify a color using a name or an integer number to specify RGB (red, green and blue), and optionally alpha (transparency). You can also create User-defined functions that expect colors, using the with the Color qualifier in the function's 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)
Built-in functions that have color parameters
- Canvas
- CanvasDrawLine
- CanvasDrawRectangle
- CanvasDrawEllipse
- CanvasDrawText
- CanvasDrawPolygon
- CellFill
- CellBar
Enable comment auto-refresher