Github/emacs
2
0
Fork 1
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-17 01:34:21 +00:00
Code Issues Projects Releases Packages Wiki Activity

(Glyphs): Add make-glyph-code, glyph-char, glyph-face.

Browse source 
Rewrite glyph code description to refer to these functions.
Remove details of encoding face number and char into integer code.
This commit is contained in:
Kim F. Storm 2007-02-14 11:31:28 +00:00
parent 9a184b0029
commit 663320a4ff
1 changed files with 26 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

46
lispref/display.texi
View file

@ -5266,26 +5266,32 @@ are defined in the library @file{disp-table}.
@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
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 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}.
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.
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
@ -5307,10 +5313,10 @@ displays, all glyph codes are simple.
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 @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.