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 example, 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 outline (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)