Color How X handles color

Widget use of color n Widgets that use color have u XmNforeground u XmNbackground u XmNborderColor (since default border width is 0 this attribute is not often seen) u XmNhighlightColor (widget has focus) n These resources are found in Primitive or Manager and thus inherited by all children.

n Some widgets have additional color resources u ToggleButtons have XmSelectColor for toggle color, u PushButtons have XmNarmColor which changes background when armed, u ScrollBar has XmNthroughColor for the area behind the slider, u...

n Some resources are specialized and handled automatically u XmNtopShadowColor u XmNbottomShadowColor are used to give a 3d effect and are computed automatically from background to be a shade lighter or a shade darker than the background color. If the background color is dynamically changed these may not change automatically. Use XmChangeColor(widget,background) to recalculate and reset shadows

The Problem with Color n What you see is not what you get somewhere else. n Color varies from platform to platform since the value of a color is relative to a colormap data structure.

Colormaps n X assumes the RGB color model. Each pixel’s color is defined by a percent of each of the colors Red, Green, Blue. u All 3 at 100% is white u All 3 at 0% is black u 50% red, 50% green, 0% blue is yellow n It is not like “paint” which is subtractive.

n Each screen pixel has a storage size (8,16,24) bits. The value of this storage is an index into a table of colors called the colormap. n 8 bits is 256 values, so this would define a colormap with 256 entries indexed n Each entry in the colormap is capable of storing one of 256**3 (~16M) colors but a given colormap selects only 256 different colors.

Pixels in X n The data type Pixel is just an index into the colormap. Clients using colors are requesting and using colorcells in the colormap. n In general don’t deal directly with these values. They are best manipulated through library routines. n Clients can create and use different colormaps if needed

X Color Basics n X Color basics assumes u only a few colors are needed u there is space in the colormap (when the server starts it creates a default colormap which it assigns to the root window and is inherited by all applications. There will be some colorcells available for application windows)

X startup n at least two colors will be in the colormap, black and white (0 and 1) but they may not appear black and white if the percentages are changed. n Window managers generally install a few (12?) more colors. n Motif adds a few more (5?) for TopShadow, BottomShadow,.. n Remaining color cells are for applications.

n All active windows have their own small set of colorcells. n Defining colors: u Try not to pick rgb percentages. F #70DB93 (assumes 8 bit) u Names can be chosen from the file rgb.txt which is usually found somewhere in X directories. Usage of these names increases the probablility that the rgb percentages these names represent will be shared in the colormap. F aquamarine

n If resource files are used rc.XmLabel.background: aquamarine rc.XmLabel.background:#70DB93 n In application code use a XColor data structure defined as typedef struct { unsigned long pixel; unsigned short red,green,blue; char flags; char pad; } XColor;\ n Named Color examples slide

Colorcells continued n There are 2 kinds of color cells in a colormap. u shared (readonly) u private(read/write) n Application clients can request a private cell to assign a color. If none are available they can choose a shared cell that is “close” to the desired color.

n private cells may be very limited and used up quickly. n Use shared cells when possible.

Using Shared Colorcells n First create pointers to two XColor structures. XColor colorcell; n Initialize with the values you want colorcell.red = 65535; colorcell.green=... n get the colormap cmap = DefaultColormap(display, DefaultScreen(screen));

Using Shared Colorcells n Make a library call to get the closest pixel value if ( XAllocColor( display, cmap, &colorcell) == 0 ) {/* failure*/} n The XAllocColor supports the shared cell strategy. It returns a pixel value that you can use. n If you prefer named colors (and you should use these to promote sharing) use XAllocNamedColor()

Example Uses XAllocNamedColor()

Getting info. n Because a “closest” will be chosen for you, you can use Colormap cmap; Xcolor color; color.red =... XQueryColor(display,cmap,&color); or XParseColor(display,cmap,65535,&color) or XLookupColor(display,cmap,name,&color,& exact) for information about what will happen

Allocating private cells n To allocate private color cells use XAllocColorCells ( ) library routine to allocate the cells. This should be checked for failure. n Then XStoreColor( ) or XStoreNamedColor( ) can be used to fill these cells. n private color cells should be freed when no longer needed with XFreeColors( ). DO NOT CALL with shared cells.

Standard ColorMaps n To promote maximum sharing X provides several standard color maps. These maps contain cells with preloaded values. n The root window usually loads a standard colormap at startup n Application using a standard colormap face colormap change effects and must take what they get.

Colormaps are resources n XCreateColormap( ) n XCopyColormap( ) are both ways to create new colormaps. Colormaps created by applications must be installed in order to be used and are destroyed on exit. n XInstallColormap( ) n XUninstallColormap( ) n XFreeColormap( )

Colormaps are not really private n Installed colormaps are a resource of the screen and if its resource id is discovered by other applications (XListInstalledColormaps( )) it can be used - but not altered if you fill all the cells) n Once installed it must be associated with windows.

Events n Applications can arrange to receive ColormapNotify events. These events notify the application of changes to the colormap in your windows.

Summary Applications draw into windows and pixmaps using pixel values. These values are relative to color cells that are defined in colormaps. Applications cannot assume any meaning about colors on a platform. X calls are used to generate pixel values corresponding to desired colors. Colors are specified as a combination of red green and blue values. Each color map cell contains a single rgb triplet. Colormap cells are scarse, so choosing the closest color values to the default colormap installed in the root window is a preferred technique. However applications can create and install their own private color maps. Changing colormaps on some platforms can create undesirable effects outside of the application window.

Summary Production code must do a lot of determination about the platform on which it is running before using library routines: the number of colormap cells, the default color map, the number of color planes ( not discussed with these slides) Xlib provides a variety of service functions for color, the most important being the ability to translate named colors into rgb triples.

Future studies n Students interested in color should look next into visual techniques and their support in X u color planes u support in X for applications that need to interpolate between colors for shading effects. n Production quality color code examples should be investigated. HAVE A GREEN DAY!