Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 ig-
       nored.  The first non-comment line in a glyph file must have the	syntax
       size nGlyphs width height The nGlyphs field must	be a number giving 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 consid-
       ered 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glyphs&sektion=5&manpath=FreeBSD+Ports+14.3.quarterly>

home | help