GLYPHS(5)							File Formats Manual							 GLYPHS(5)

NAME

       glyphs - format of .glyphs files

DESCRIPTION

       Glyph  files  (``.glyph'' extension) are used to store commonly-used bit patterns (glyphs) for Magic.  Right now, the bit patterns are used
       for two purposes in Magic.  First, they specify patterns for programmable cursors:  each cursor shape (e.g. the arrow used for  the  wiring
       tool)  is read in as a glyph from a glyph file.	Second, glyphs are used by the window manager to represent the icons displayed at the ends
       of scroll bars.	Glyph file names normally have the extension .glyph.

       Glyph files are stored in ASCII format.	Lines beginning with ``#'' are considered to be comments and are ignored.  Blank  lines  are  also
       ignored.  The first non-comment line in a glyph file must have the syntax size nGlyphs width height The nGlyphs field must be a number giv-
       ing the total number of glyphs stored in the file.  The width and height fields give the dimensions of each glyph in pixels.  All glyphs in
       the same file must have the same size.

       The size line is followed by a description for each of the glyphs.  Each glyph consists of height lines each containing 2xwidth characters.
       Each pair of characters corresponds to a bit position in the glyph, with the leftmost pair on the topmost line corresponding to the  upper-
       left pixel in the glyph.

       The  first  character  of  each pair specifies the color to appear in that pixel.  The color is represented as as a single character, which
       must be the short name of a display style in the current display style file.  Some commonly-used characters are K for black, W  for  white,
       and  .  for  the  background  color  (when . is used in a cursor, it means that that pixel position is transparent:  the underlying picture
       appears through the cursor).  See ``Magic Maintainer's Manual #3: Display Styles, Color Maps, and Glyphs'' for more information.

       The second character of each pair is normally blank, except for one pixel per glyph which may contain a ``*'' in the second character.  The
       ``*''  is  used for programmable cursors to indicate the hot-spot:  the pixel corresponding to the ``*'' is the one that the cursor is con-
       sidered to point to.

       For an example of a glyph file, see ~cad/lib/magic/sys/color.glyphs.

SEE ALSO

       magic(1), dstyle(5)

4th Berkeley Distribution														 GLYPHS(5)