Mercurial > hg > xemacs-beta

comparison man/lispref/faces.texi @ 2127:4657b5a54253

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[xemacs-hg @ 2004-06-14 10:24:44 by stephent] Improve glyph docs <87659uxwsv.fsf@tleepslib.sk.tsukuba.ac.jp>
author stephent
date Mon, 14 Jun 2004 10:24:45 +0000
parents c6facab13185
children 8baa2f03d853
comparison
equal deleted inserted replaced
2126:1777d8a3b486 2127:4657b5a54253
162 @item display-table 162 @item display-table
163 The display table of the face. 163 The display table of the face.
164 164
165 @item background-pixmap 165 @item background-pixmap
166 The pixmap displayed in the background of the face. Only used by faces 166 The pixmap displayed in the background of the face. Only used by faces
167 on X devices. 167 on GUI devices, currently X11, GTK, and Microsoft Windows.
168 168
169 @item underline 169 @item underline
170 Underline all text covered by this face. 170 Underline all text covered by this face.
171 171
172 @item highlight 172 @item highlight
371 @code{x-bitmap-file-path} will be searched) or a glyph object as 371 @code{x-bitmap-file-path} will be searched) or a glyph object as
372 returned by @code{make-glyph} (@pxref{Glyphs}). The argument may also 372 returned by @code{make-glyph} (@pxref{Glyphs}). The argument may also
373 be a list of the form @code{(@var{width} @var{height} @var{data})} where 373 be a list of the form @code{(@var{width} @var{height} @var{data})} where
374 @var{width} and @var{height} are the size in pixels, and @var{data} is a 374 @var{width} and @var{height} are the size in pixels, and @var{data} is a
375 string, containing the raw bits of the bitmap. 375 string, containing the raw bits of the bitmap.
376
377 Similarly to how the glyph's image specifier works @xref{Creating
378 Glyphs}, you don't create your own image specifier, but rather add
379 specifications to the existing one. Note that the image instance that is
380 generated in order to actually display the background pixmap is of type
381 @code{mono-pixmap}, meaning that it's a two-color image and the
382 foreground and background of the image get filled in with the
383 corresponding colors from the face. (#### Is this still true?)
376 @end deffn 384 @end deffn
377 385
378 @deffn Command set-face-background-pixmap-file face file 386 @deffn Command set-face-background-pixmap-file face file
379 This function sets the background pixmap of face @var{face} to the image 387 This function sets the background pixmap of face @var{face} to the image
380 contained in @var{file}. This is just a simplified version of 388 contained in @var{file}. This is just a simplified version of
397 specifier of face @var{face}. 405 specifier of face @var{face}.
398 @xref{Colors}. 406 @xref{Colors}.
399 @end defun 407 @end defun
400 408
401 @defun face-background-pixmap face &optional locale tag-set exact-p 409 @defun face-background-pixmap face &optional locale tag-set exact-p
402 This function return the background-pixmap glyph object of face 410 This function returns the background-pixmap image specifier of face
403 @var{face}. 411 @var{face}.
404 @end defun 412 @end defun
405 413
406 @defun face-font face &optional locale tag-set exact-p 414 @defun face-font face &optional locale tag-set exact-p
407 This function returns the font specifier of face @var{face}. (Note: 415 This function returns the font specifier of face @var{face}. (Note: