More doc updates for multi-frame images

* doc/emacs/files.texi (File Conveniences): Not just GIFs can be animated.

* doc/lispref/display.texi (Multi-Frame Images): Minor rephrasing.

* etc/NEWS: Related edits.
This commit is contained in:
Glenn Morris 2013-02-20 22:03:02 -08:00
parent c1bf363a73
commit f0c954fa28
5 changed files with 28 additions and 8 deletions

View file

@ -1,3 +1,7 @@
2013-02-21 Glenn Morris <rgm@gnu.org>
* files.texi (File Conveniences): Not just GIFs can be animated.
2013-02-13 Glenn Morris <rgm@gnu.org>
* ack.texi (Acknowledgments): Don't mention yow any more.

View file

@ -1937,8 +1937,7 @@ or taller than the frame, the usual point motion keys (@kbd{C-f},
displayed. If the image can be animated, the command @kbd{RET}
(@code{image-toggle-animation}) starts or stops the animation.
Animation plays once, unless the option @code{image-animate-loop} is
non-@code{nil}. Currently, Emacs only supports animation in GIF
files.
non-@code{nil}.
@cindex ImageMagick support
@vindex imagemagick-enabled-types

View file

@ -1,3 +1,7 @@
2013-02-21 Glenn Morris <rgm@gnu.org>
* display.texi (Multi-Frame Images): Minor rephrasing.
2013-02-20 Glenn Morris <rgm@gnu.org>
* display.texi (GIF Images, TIFF Images): Delete these nodes.

View file

@ -4925,10 +4925,10 @@ integer (counting from 0) that specifies which frame is being displayed.
This function returns non-@code{nil} if @var{image} contains more than
one frame. The actual return value is a cons @code{(@var{nimages}
. @var{delay})}, where @var{nimages} is the number of frames and
@var{delay} is the delay in seconds between them, if the image itself
specifies a delay. Images that are intended to be animated usually
specify a frame delay, whereas ones that are intended to be treated as
multiple pages do not.
@var{delay} is the delay in seconds between them, or @code{nil}
if the image does not specify a delay. Images that are intended to be
animated usually specify a frame delay, whereas ones that are intended
to be treated as multiple pages do not.
@end defun
@defun image-current-frame image

View file

@ -145,8 +145,6 @@ directory, respectively.
`f' (`image-next-frame') and `b' (`image-previous-frame') visit the
next or previous frame. `F' (`image-goto-frame') shows a specific frame.
*** `image-animated-p' is now `image-multi-frame-p'.
---
*** The command `image-mode-fit-frame' deletes other windows.
When toggling, it restores the frame's previous window configuration.
@ -291,6 +289,21 @@ rather than inheriting from it (as do face specs set via Customize).
*** New face characteristic (supports :underline (:style wave))
specifies whether or not the terminal can display a wavy line.
** Image API
+++
*** `image-animated-p' is now `image-multi-frame-p'.
It returns non-nil for any image that contains multiple frames,
whether or not it specifies a frame delay.
+++
*** When animating images that do not specify a frame delay,
Emacs uses `image-default-frame-delay'.
+++
*** New functions `image-current-frame' and `image-show-frame' for getting
and setting the current frame of a multi-frame image.
** time-to-seconds is not obsolete any more.
** New function special-form-p.
** Docstrings can be made dynamic by adding a `dynamic-docstring-function'