comparison man/lispref/glyphs.texi @ 2:ac2d302a0011 r19-15b2

Import from CVS: tag r19-15b2
author cvs
date Mon, 13 Aug 2007 08:46:35 +0200
parents 376386a54a3c
children 54f7aa390f4f
comparison
equal deleted inserted replaced
1:c0c6a60d29db 2:ac2d302a0011
72 mouse-pointer), or @code{icon} (used for a frame's icon), and defaults 72 mouse-pointer), or @code{icon} (used for a frame's icon), and defaults
73 to @code{buffer}. @xref{Glyph Types}. 73 to @code{buffer}. @xref{Glyph Types}.
74 @end defun 74 @end defun
75 75
76 @defun make-glyph-internal &optional type 76 @defun make-glyph-internal &optional type
77 This function creates a new, uninitialzed glyph of type @var{type}. 77 This function creates a new, uninitialized glyph of type @var{type}.
78 @end defun 78 @end defun
79 79
80 @defun make-pointer-glyph &optional spec-list 80 @defun make-pointer-glyph &optional spec-list
81 This function is equivalent to calling @code{make-glyph} with a 81 This function is equivalent to calling @code{make-glyph} with a
82 @var{type} of @code{pointer}. 82 @var{type} of @code{pointer}.
183 183
184 If @var{locale} is supplied, then instead of returning the actual value, 184 If @var{locale} is supplied, then instead of returning the actual value,
185 the specification(s) for the given locale or locale type will be 185 the specification(s) for the given locale or locale type will be
186 returned. This will only work if the actual value of @var{property} is 186 returned. This will only work if the actual value of @var{property} is
187 a specifier (this will always be the case for built-in properties, but 187 a specifier (this will always be the case for built-in properties, but
188 not or not may apply to user-defined properties). If the actual value 188 may or may not apply to user-defined properties). If the actual value
189 of @var{property} is not a specifier, this value will simply be returned 189 of @var{property} is not a specifier, this value will simply be returned
190 regardless of @var{locale}. 190 regardless of @var{locale}.
191 191
192 The return value will be a list of instantiators (e.g. vectors 192 The return value will be a list of instantiators (e.g. vectors
193 specifying pixmap data), or a list of specifications, each of which is a 193 specifying pixmap data), or a list of specifications, each of which is a
241 one). 241 one).
242 242
243 @var{domain} defaults to the selected window if omitted. 243 @var{domain} defaults to the selected window if omitted.
244 244
245 @var{domain} can be a frame or device, instead of a window. The value 245 @var{domain} can be a frame or device, instead of a window. The value
246 returned for a such a domain is used in special circumstances when a 246 returned for such a domain is used in special circumstances when a
247 more specific domain does not apply; for example, a frame value might be 247 more specific domain does not apply; for example, a frame value might be
248 used for coloring a toolbar, which is conceptually attached to a frame 248 used for coloring a toolbar, which is conceptually attached to a frame
249 rather than a particular window. The value is also useful in 249 rather than a particular window. The value is also useful in
250 determining what the value would be for a particular window within the 250 determining what the value would be for a particular window within the
251 frame or device, if it is not overridden by a more specific 251 frame or device, if it is not overridden by a more specific
494 X support, you will normally have GIF support, unless you explicitly 494 X support, you will normally have GIF support, unless you explicitly
495 disable it at configure time.) 495 disable it at configure time.)
496 @item jpeg 496 @item jpeg
497 (A JPEG-format image; only if JPEG support was compiled into this 497 (A JPEG-format image; only if JPEG support was compiled into this
498 XEmacs. Can be instanced as @code{color-pixmap}. If you have the JPEG 498 XEmacs. Can be instanced as @code{color-pixmap}. If you have the JPEG
499 libraries present on your system, XEmacs will automatically detect this 499 libraries present on your system when XEmacs is built, XEmacs will
500 and use them, unless you explicitly disable it at configure time.) 500 automatically detect this and use them, unless you explicitly disable it
501 at configure time.)
501 @item png 502 @item png
502 (A PNG/GIF24 image; only if PNG support was compiled into this XEmacs. 503 (A PNG/GIF24 image; only if PNG support was compiled into this XEmacs.
503 Can be instanced as @code{color-pixmap}.) 504 Can be instanced as @code{color-pixmap}.)
504 @item tiff 505 @item tiff
505 (A TIFF-format image; only if TIFF support was compiled into this XEmacs. 506 (A TIFF-format image; only if TIFF support was compiled into this XEmacs.
594 @code{console-type-image-conversion-list} for the console type of 595 @code{console-type-image-conversion-list} for the console type of
595 the domain (usually a window; sometimes a frame or device) over which 596 the domain (usually a window; sometimes a frame or device) over which
596 the image is being instantiated. 597 the image is being instantiated.
597 598
598 If the instantiator specifies data from a file, the data will be read in 599 If the instantiator specifies data from a file, the data will be read in
599 at the time that the instantiator is added to the image (which may be 600 at the time that the instantiator is added to the image specifier (which
600 well before when the image is actually displayed), and the instantiator 601 may be well before the image is actually displayed), and the
601 will be converted into one of the inline-data forms, with the filename 602 instantiator will be converted into one of the inline-data forms, with
602 retained using a @code{:file} keyword. This implies that the file must 603 the filename retained using a @code{:file} keyword. This implies that
603 exist when the instantiator is added to the image, but does not need to 604 the file must exist when the instantiator is added to the image, but
604 exist at any other time (e.g. it may safely be a temporary file). 605 does not need to exist at any other time (e.g. it may safely be a
606 temporary file).
605 607
606 @defun valid-image-instantiator-format-p format 608 @defun valid-image-instantiator-format-p format
607 This function returns non-@code{nil} if @var{format} is a valid image 609 This function returns non-@code{nil} if @var{format} is a valid image
608 instantiator format. Note that the return value for many formats listed 610 instantiator format. Note that the return value for many formats listed
609 above depends on whether XEmacs was compiled with support for that format. 611 above depends on whether XEmacs was compiled with support for that format.
1005 the current mouse pointer for a frame. 1007 the current mouse pointer for a frame.
1006 1008
1007 @defun set-frame-pointer frame image-instance 1009 @defun set-frame-pointer frame image-instance
1008 This function sets the mouse pointer of @var{frame} to the given pointer 1010 This function sets the mouse pointer of @var{frame} to the given pointer
1009 image instance. You should not call this function directly. 1011 image instance. You should not call this function directly.
1010 (If you do, the pointer will change the next time the mouse moves.) 1012 (If you do, the pointer will change again the next time the mouse moves.)
1011 @end defun 1013 @end defun
1012 1014
1013 @node Redisplay Glyphs 1015 @node Redisplay Glyphs
1014 @section Redisplay Glyphs 1016 @section Redisplay Glyphs
1015 1017