comparison lispref/display.texi @ 75875:bdb0a4edf3b9

(Glyphs): Add make-glyph-code, glyph-char, glyph-face. Rewrite glyph code description to refer to these functions. Remove details of encoding face number and char into integer code.

75874:b9243e7cca8d

@node Glyphs
@subsection Glyphs

@cindex glyph
  A @dfn{glyph} is a generalization of a character; it stands for an
image that takes up a single character position on the screen.  Glyphs
are represented in Lisp as integers, just as characters are.  Normally
glyphs come from vectors in the display table (@pxref{Display Tables}).

  A glyph code can be @dfn{simple} or it can be defined by the
@dfn{glyph table}.  A simple glyph code is just a way of specifying a
character and a face to output it in.  When a glyph code is simple,
the code, mod 524288, is the character to output, and the code divided
by 524288 specifies the face number (@pxref{Face Functions}) to use
while outputting it.  (524288 is
@ifnottex
2**19.)
@end ifnottex
@tex
$2^{19}$.)
@end tex
@xref{Faces}.

  On character terminals, you can set up a @dfn{glyph table} to define
the meaning of glyph codes.

@defvar glyph-table
The value of this variable is the current glyph table.  It should be
@code{nil} or a vector whose @var{g}th element defines glyph code
@var{g}.

@table @asis
@item @var{string}
Send the characters in @var{string} to the terminal to output
this glyph code.

@item @var{integer}
Define this glyph code as an alias for glyph code @var{integer}.  You
can use such an alias to define a small-numbered glyph code which
specifies a face.

@item @code{nil}
This glyph code is simple.
@end table

75875:bdb0a4edf3b9

@node Glyphs
@subsection Glyphs

@cindex glyph
  A @dfn{glyph} is a generalization of a character; it stands for an
image that takes up a single character position on the screen.  Normally
glyphs come from vectors in the display table (@pxref{Display Tables}).

  A glyph is represented in Lisp as a @dfn{glyph code}.  A glyph code
can be @dfn{simple} or it can be defined by the @dfn{glyph table}.  A
simple glyph code is just a way of specifying a character and a face
to output it in.  @xref{Faces}.

  The following functions are used to manipulate simple glyph codes:

@defun make-glyph-code char &optional face
This function returns a simple glyph code representing char @var{char}
with face @var{face}.
@end defun

@defun glyph-char glyph
This function returns the character of simple glyph code @var{glyph}.
@end defun

@defun glyph-face glyph
This function returns face of simple glyph code @var{glyph}, or
@code{nil} if @var{glyph} has the default face (face-id 0).
@end defun

  On character terminals, you can set up a @dfn{glyph table} to define
the meaning of glyph codes (represented as small integers).

@defvar glyph-table
The value of this variable is the current glyph table.  It should be
@code{nil} or a vector whose @var{g}th element defines glyph code
@var{g}.

@table @asis
@item @var{string}
Send the characters in @var{string} to the terminal to output
this glyph code.

@item @var{code}
Define this glyph code as an alias for glyph code @var{code} created
by @code{make-glyph-code}.  You can use such an alias to define a
small-numbered glyph code which specifies a character with a face.

@item @code{nil}
This glyph code is simple.
@end table