cmap(5) [v7 man page]
CMAP(5) File Formats Manual CMAP(5) NAME
cmap - format of .cmap files (color maps) DESCRIPTION
Color-map files define the mapping between eight-bit color numbers and red, green and blue intensities used for those numbers. They are read by Magic as part of system startup, and also by the :load and :save commands in color-map windows. Color-map file names usually have the form x.y.z.cmapn, where x is a class of technology files, y is a class of displays, z is a class of monitors, and n is a version number (currently 1). The version number will change in the future if the formap of color-map files ever changes. Normally, x and y correspond to the corresponding parts of a display styles file. For example, the color map file mos.7bit.std.cmap1 is used today for most nMOS and CMOS technology files using displays that support at least seven bits of color per pixel and standard-phosphor monitors. It corresponds to the display styles file mos.7bit.dstyle5. Color-map files are stored in ASCII form, with each line containing four decimal integers separated by white space. The first three inte- gers are red, green, and blue intensities, and the fourth field is a color number. For current displays the intensities must be integers between 0 and 255. The color numbers must increase from line to line, and the last line must have a color number of 255. The red, green, and blue intensities on the first line are used for all colors from 0 up to and including the color number on that line. For other lines, the intensities on that line are used for all colors starting one color above the color number on the previous line and continuing up and through the color number on the current line. For example, consider the color map below: 255 0 0 2 0 0 255 3 255 255 255 256 This color map indicates that colors 0, 1, and 2 are to be red, color 3 is to be blue, and all other colors are to be white. SEE ALSO
magic(1), dstyle(5) 4th Berkeley Distribution CMAP(5)
Check Out this Related Man Page
DSTYLE(5) File Formats Manual DSTYLE(5) NAME
dstyle - format of .dstyle files (display styles) DESCRIPTION
Display styles indicate how to render information on a screen. Each style describes one way of rendering information, for example as a solid area in red or as a dotted outline in purple. Different styles correspond to mask layers, highlights, labels, menus, window borders, and so on. See ``Magic Maintainer's Manual #3: Display Styles, Color Maps, and Glyphs'' for more information on how the styles are used. Dstyle files usually have names of the form x.y.dstylen, where x is a class of technologies, y is a class of displays, and n is a version number (currently 5). The version number may increase in the future if the format of dstyle files changes. For example, the display style file mos.7bit.dstyle5 provides all the rendering information for our nMOS and CMOS technologies for color displays with at least 7 bits of color. Dstyle files are stored in ASCII as a series of lines. Lines beginning with ``#'' are considered to be comments and are ignored. The rest of the lines of the file are divided up into two sections separated by blank lines. There should not be any blank lines within a section. DISPLAY_STYLES SECTION The first section begins with a line display_styles planes where planes is the number of bits of color information per pixel on the screen (between 1 and 8). Each line after that describes one display style and contains eight fields separated by white space: style writeMask color outline fill stipple shortName longName The meanings of the fields are: style The number of this style, in decimal. Styles 1 through 64 are used to display mask layers in the edit cell. The style number(s) to use for each mask layer is (are) specified in the technology file. Styles 65-128 are used for displaying mask layers in non-edit cells. If style x is used for a mask layer in the edit cell, style x+64 is used for the same mask layer in non-edit cells. Styles above 128 are used by the Magic code for various things like menus and highlights. See the file styles.h in Magic for how styles above 128 are used. When redisplaying, the styles are drawn in order starting at 1, so the order of styles may affect what appears on the screen. writeMask This is an octal number specifying which bit-planes are to be modified when this style is rendered. For example, 1 means only information in bit-plane 0 will be affected, and 377 means all eight bit-planes are affected. color An octal number specifying the new values to be written into the bit-planes that are modified. This is used along with writeMask to determine the new value of each pixel that's being modified: newPixel = (oldPixel & ~writeMask) | (color & writeMask) The red, green, and blue intensities displayed for each pixel are not deterimined directly by the value of the pixel; they come from a color map that maps the eight-bit pixel values into red, green, and blue intensities. Color maps are stored in separate files. outline If this field is zero, then no outline is drawn. If the field is non-zero, it specifies that outlines are to be drawn around the rectangular areas rendered in this style, and the octal value gives an eight-bit pattern telling how to draw the outline. For exam- ple, 377 means to draw a solid line, 252 means to draw a dotted line, 360 specifies long dashes, etc. This field only indicates which pixels will be modified: the writeMask and color fields indicate how the pixels are modified. fill This is a text string specifying how the areas drawn in this style should be filled. It must have one of the values solid, stipple, cross, outline, grid. Solid means that every pixel in the area is to modified according to writeMask and color. Stipple means that the area should be stippled: the stipple pattern given by stipple is used to determine which pixels in the area are to be modified. Cross means that an X is drawn in a solid line between the diagonally-opposite corners of the area being rendered. Outline means that the area should not be filled at all; only an outline is drawn (if specified by outline). Grid is a special style used to draw a grid in the line style given by outline. The styles cross and stipple may be supplemented with an outline by giving a non- zero outline field. The outline and grid styles don't make sense without an an outline, and solid doesn't make sense with an out- line (since all the pixels are modified anyway). stipple Used when fill is stipple to specify (in decimal) the stipple number to use. shortName This is a one-character name for this style. These names are used in the specification of glyphs and also in a few places in the Magic source code. Most styles have no short name; use a ``-'' in this field for them. longName A more human-readable name for the style. It's not used at all by Magic. STIPPLES SECTION
The second section of a dstyle file is separated from the first by a blank line. The first line of the second section must be stipples and each additional line specifies one stipple pattern with the syntax number pattern name Number is a decimal number used to name the stipple in the stipple fields of style lines. Number must be no less than 1 and must be no greater than a device-dependent upper limit. Most devices support at least 15 stipple patterns. Pattern consists of eight octal numbers, each from 0-377 and separated by white space. The numbers form an 8-by-8 array of bits indicating which pixels are to be modified when the stipple is used. The name field is just a human- readable description of the stipple; it isn't used by Magic. FILES
~cad/lib/magic/sys/mos.7bit.dstyle5 SEE ALSO
magic(1), cmap(5), glyphs(5) 4th Berkeley Distribution DSTYLE(5)