IBM Visualization Data Explorer Programmer's Reference
[ Bottom of Page | Previous Page | Next
Page | Table of Contents | Partial Table of Contents | Index ]
Function
Gets the RGB values for a specified
color-name
string.
Syntax
#include <dx/dx.h>
Error DXColorNameToRGB(char *colorname, RGBColor *rgbvalue)
Functional Details
The RGB values of the color string colorname
are obtained from a color lookup table and returned in
*rgbvalue.
For example, the RGB values for the color "white" are
1.0, 1.0, 1.0.
The color lookup table could come from a number of places:
- The routine first checks the environment variable DXCOLORS.
If that is set, the routine uses the value of the variable
and tries to open it as a file.
- If that does not succeed, the routine then checks the environment
variables DXEXECROOT and DXROOT for a directory
path.
It will append /lib/colors.txt to this path and try to open
the file.
If that fails, it tries to open /usr/local/dx/lib/colors.txt.
- If none of these files can be opened, the routine uses an internal
static table. This table is a subset of colors in the file
/usr/local/dx/lib/colors.txt.
Return Value
Returns OK or returns ERROR
and sets an error code.
See Also
"Colors".
[ Top of Page | Previous Page | Next
Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration
Guide ]
[Data Explorer Home
Page]
[IBM Home Page | Order | Search | Contact IBM | Legal ]