Mercurial > hg > xemacs-beta
comparison man/lispref/faces.texi @ 408:501cfd01ee6d r21-2-34
Import from CVS: tag r21-2-34
| author | cvs |
|---|---|
| date | Mon, 13 Aug 2007 11:18:11 +0200 |
| parents | 74fd4e045ea6 |
| children | 697ef44129c6 |
comparison
equal
deleted
inserted
replaced
| 407:ed6218a7d4d3 | 408:501cfd01ee6d |
|---|---|
| 474 @defun font-specifier-p object | 474 @defun font-specifier-p object |
| 475 This predicate returns @code{t} if @var{object} is a font specifier, and | 475 This predicate returns @code{t} if @var{object} is a font specifier, and |
| 476 @code{nil} otherwise. | 476 @code{nil} otherwise. |
| 477 @end defun | 477 @end defun |
| 478 | 478 |
| 479 @defun make-font-specifier spec-list | |
| 480 | |
| 481 Return a new @code{font} specifier object with the given specification | |
| 482 list. @var{spec-list} can be a list of specifications (each of which is | |
| 483 a cons of a locale and a list of instantiators), a single instantiator, | |
| 484 or a list of instantiators. @xref{Specifiers}, for more information | |
| 485 about specifiers. | |
| 486 | |
| 487 Valid instantiators for font specifiers are: | |
| 488 | |
| 489 @itemize @bullet | |
| 490 | |
| 491 @item | |
| 492 A string naming a font (e.g. under X this might be | |
| 493 "-*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-*" for a 14-point | |
| 494 upright medium-weight Courier font). | |
| 495 @item | |
| 496 A font instance (use that instance directly if the device matches, | |
| 497 or use the string that generated it). | |
| 498 @item | |
| 499 A vector of no elements (only on TTY's; this means to set no font | |
| 500 at all, thus using the "natural" font of the terminal's text). | |
| 501 @item | |
| 502 A vector of one element (a face to inherit from). | |
| 503 @end itemize | |
| 504 @end defun | |
| 505 | |
| 479 @node Font Instances | 506 @node Font Instances |
| 480 @subsection Font Instances | 507 @subsection Font Instances |
| 481 | 508 |
| 482 @defun font-instance-p object | 509 @defun font-instance-p object |
| 483 This predicate returns @code{t} if @var{object} is a font instance, and | 510 This predicate returns @code{t} if @var{object} is a font instance, and |
| 632 | 659 |
| 633 @defun color-specifier-p object | 660 @defun color-specifier-p object |
| 634 This function returns non-@code{nil} if @var{object} is a color specifier. | 661 This function returns non-@code{nil} if @var{object} is a color specifier. |
| 635 @end defun | 662 @end defun |
| 636 | 663 |
| 664 @defun make-color-specifier spec-list | |
| 665 | |
| 666 Return a new @code{color} specifier object with the given specification | |
| 667 list. @var{spec-list} can be a list of specifications (each of which is | |
| 668 a cons of a locale and a list of instantiators), a single instantiator, | |
| 669 or a list of instantiators. @xref{Specifiers}, for a detailed | |
| 670 description of how specifiers work. | |
| 671 | |
| 672 Valid instantiators for color specifiers are: | |
| 673 | |
| 674 @itemize @bullet | |
| 675 @item | |
| 676 A string naming a color (e.g. under X this might be "lightseagreen2" or | |
| 677 "#F534B2"). | |
| 678 | |
| 679 @item | |
| 680 A color instance (use that instance directly if the device matches, | |
| 681 or use the string that generated it). | |
| 682 | |
| 683 @item | |
| 684 A vector of no elements (only on TTY's; this means to set no color at | |
| 685 all, thus using the "natural" color of the terminal's text). | |
| 686 | |
| 687 @item | |
| 688 A vector of one or two elements: a face to inherit from, and optionally | |
| 689 a symbol naming which property of that face to inherit, either | |
| 690 @code{foreground} or @code{background} (if omitted, defaults to the same | |
| 691 property that this color specifier is used for; if this specifier is not | |
| 692 part of a face, the instantiator would not be valid). | |
| 693 @end itemize | |
| 694 @end defun | |
| 695 | |
| 696 @defun make-face-boolean-specifier spec-list | |
| 697 | |
| 698 Return a new @code{face-boolean} specifier object with the given spec | |
| 699 list. @var{spec-list} can be a list of specifications (each of which is | |
| 700 a cons of a locale and a list of instantiators), a single instantiator, | |
| 701 or a list of instantiators. @xref{Specifiers}, for a detailed | |
| 702 description of how specifiers work. | |
| 703 | |
| 704 Valid instantiators for face-boolean specifiers are | |
| 705 | |
| 706 @itemize @bullet | |
| 707 @item | |
| 708 t or nil. | |
| 709 @item | |
| 710 A vector of two or three elements: a face to inherit from, optionally a | |
| 711 symbol naming the property of that face to inherit from (if omitted, | |
| 712 defaults to the same property that this face-boolean specifier is used | |
| 713 for; if this specifier is not part of a face, the instantiator would not | |
| 714 be valid), and optionally a value which, if non-nil, means to invert the | |
| 715 sense of the inherited property. | |
| 716 @end itemize | |
| 717 | |
| 718 @end defun | |
| 719 | |
| 720 | |
| 637 @node Color Instances | 721 @node Color Instances |
| 638 @subsection Color Instances | 722 @subsection Color Instances |
| 639 @cindex color instances | 723 @cindex color instances |
| 640 | 724 |
| 641 A @dfn{color-instance object} is an object describing the way a color | 725 A @dfn{color-instance object} is an object describing the way a color |