Provided by: magic_7.5.214-1_i386 bug

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)