comparison lispref/display.texi @ 57201:2950fcfcfa44

Correct various typos. (Display): Rename node "Pointer Shapes" to "Pointer Shape". (There is already a node called "Pointer Shapes" in frames.texi.) (Images): Remove non-existent node "Image Slices" from menu.

57200:c81df189b32d

* Faces::               A face defines a graphics style for text characters:
                          font, colors, etc.
* Fringes::             Controlling window fringes.
* Fringe Bitmaps::     Customizing fringe bitmaps.
* Scroll Bars::         Controlling vertical scroll bars.
* Pointer Shapes::      Controlling the mouse pointer shape.
* Display Property::    Enabling special display features.
* Images::              Displaying images in Emacs buffers.
* Buttons::             Adding clickable buttons to Emacs buffers.
* Blinking::            How Emacs shows the matching open parenthesis.
* Inverse Video::       Specifying how the screen looks.

@code{set-window-buffer} examines these variables.  If you change them
in a buffer that is already visible in a window, you can make the
window take note of the new values by calling @code{set-window-buffer}
specifying the same buffer that is already displayed.

@node Pointer Shapes
@section Pointer Shapes

Normally, the mouse pointer has the @code{text} shape over text and
the @code{arrow} shape over window areas which do not correspond to
any buffer text.

  OP   ::= + | -
@end group
@end example

  The form @var{NUM} specifies a fractional width or height of the
default frame font size.  The form @code(@var{NUM})} specifies an
absolute number of pixels.  If a symbol @var{SYMBOL} is specified, its
buffer-local variable binding is used.

  The @code{in}, @code{mm}, and @code{cm} units specifies the number
of pixels per inch, milli-meter, and centi-meter, resp.  The

  If no specific base offset is set for alignment, it is always relative
to the left edge of the text area.  For example, @samp{:align-to 0} in a
header-line aligns with the first text column in the text area.

  The value of the form @code(@var{NUM} . @var{EXPR})} is the value of
@var{NUM} multiplied by the value of the expression @var{EXPR}.  For
example, @samp{(2 . in)} specifies a width of 2 inches, while
@samp{(0.5 . IMAGE)} specifies half the width (or height) of the
specified image.

* GIF Images::          Special features for GIF format.
* Postscript Images::   Special features for Postscript format.
* Other Image Types::   Various other formats are supported.
* Defining Images::     Convenient ways to define an image for later use.
* Showing Images::      Convenient ways to display an image once it is defined.
* Image Slices::        Displaying image slices.
* Image Cache::         Internal mechanisms of image display.
@end menu

@node Image Descriptors
@subsection Image Descriptors

@code{(circle . ((@var{x0} . @var{y0}) . @var{r}))}
which specifies the center and the radius of the circle; @var{r} may
be a float or integer.

A polygon is a cons
@code(poly . [@var{x0} @var{y0} @var{x1} @var{y1} ...])}
where each pair in the vector describes one corner in the polygon.

When the mouse pointer is above a hot-spot area of an image, the
@var{plist} of that hot-spot is consulted; if it contains a @code{help-echo}
property it defines a tool-tip for the hot-spot, and if it contains

57201:2950fcfcfa44

* Faces::               A face defines a graphics style for text characters:
                          font, colors, etc.
* Fringes::             Controlling window fringes.
* Fringe Bitmaps::     Customizing fringe bitmaps.
* Scroll Bars::         Controlling vertical scroll bars.
* Pointer Shape::      Controlling the mouse pointer shape.
* Display Property::    Enabling special display features.
* Images::              Displaying images in Emacs buffers.
* Buttons::             Adding clickable buttons to Emacs buffers.
* Blinking::            How Emacs shows the matching open parenthesis.
* Inverse Video::       Specifying how the screen looks.

@code{set-window-buffer} examines these variables.  If you change them
in a buffer that is already visible in a window, you can make the
window take note of the new values by calling @code{set-window-buffer}
specifying the same buffer that is already displayed.

@node Pointer Shape
@section Pointer Shape

Normally, the mouse pointer has the @code{text} shape over text and
the @code{arrow} shape over window areas which do not correspond to
any buffer text.

  OP   ::= + | -
@end group
@end example

  The form @var{NUM} specifies a fractional width or height of the
default frame font size.  The form @code{(@var{NUM})} specifies an
absolute number of pixels.  If a symbol @var{SYMBOL} is specified, its
buffer-local variable binding is used.

  The @code{in}, @code{mm}, and @code{cm} units specifies the number
of pixels per inch, milli-meter, and centi-meter, resp.  The

  If no specific base offset is set for alignment, it is always relative
to the left edge of the text area.  For example, @samp{:align-to 0} in a
header-line aligns with the first text column in the text area.

  The value of the form @code{(@var{NUM} . @var{EXPR})} is the value of
@var{NUM} multiplied by the value of the expression @var{EXPR}.  For
example, @samp{(2 . in)} specifies a width of 2 inches, while
@samp{(0.5 . IMAGE)} specifies half the width (or height) of the
specified image.

* GIF Images::          Special features for GIF format.
* Postscript Images::   Special features for Postscript format.
* Other Image Types::   Various other formats are supported.
* Defining Images::     Convenient ways to define an image for later use.
* Showing Images::      Convenient ways to display an image once it is defined.
* Image Cache::         Internal mechanisms of image display.
@end menu

@node Image Descriptors
@subsection Image Descriptors

@code{(circle . ((@var{x0} . @var{y0}) . @var{r}))}
which specifies the center and the radius of the circle; @var{r} may
be a float or integer.

A polygon is a cons
@code{(poly . [@var{x0} @var{y0} @var{x1} @var{y1} ...])}
where each pair in the vector describes one corner in the polygon.

When the mouse pointer is above a hot-spot area of an image, the
@var{plist} of that hot-spot is consulted; if it contains a @code{help-echo}
property it defines a tool-tip for the hot-spot, and if it contains