Commit f0c954fa authored by Glenn Morris's avatar Glenn Morris
Browse files

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.
parent c1bf363a
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> 2013-02-13 Glenn Morris <rgm@gnu.org>
* ack.texi (Acknowledgments): Don't mention yow any more. * ack.texi (Acknowledgments): Don't mention yow any more.
......
...@@ -1937,8 +1937,7 @@ or taller than the frame, the usual point motion keys (@kbd{C-f}, ...@@ -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} displayed. If the image can be animated, the command @kbd{RET}
(@code{image-toggle-animation}) starts or stops the animation. (@code{image-toggle-animation}) starts or stops the animation.
Animation plays once, unless the option @code{image-animate-loop} is Animation plays once, unless the option @code{image-animate-loop} is
non-@code{nil}. Currently, Emacs only supports animation in GIF non-@code{nil}.
files.
@cindex ImageMagick support @cindex ImageMagick support
@vindex imagemagick-enabled-types @vindex imagemagick-enabled-types
......
2013-02-21 Glenn Morris <rgm@gnu.org>
* display.texi (Multi-Frame Images): Minor rephrasing.
2013-02-20 Glenn Morris <rgm@gnu.org> 2013-02-20 Glenn Morris <rgm@gnu.org>
* display.texi (GIF Images, TIFF Images): Delete these nodes. * display.texi (GIF Images, TIFF Images): Delete these nodes.
......
...@@ -4925,10 +4925,10 @@ integer (counting from 0) that specifies which frame is being displayed. ...@@ -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 This function returns non-@code{nil} if @var{image} contains more than
one frame. The actual return value is a cons @code{(@var{nimages} 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})}, where @var{nimages} is the number of frames and
@var{delay} is the delay in seconds between them, if the image itself @var{delay} is the delay in seconds between them, or @code{nil}
specifies a delay. Images that are intended to be animated usually if the image does not specify a delay. Images that are intended to be
specify a frame delay, whereas ones that are intended to be treated as animated usually specify a frame delay, whereas ones that are intended
multiple pages do not. to be treated as multiple pages do not.
@end defun @end defun
@defun image-current-frame image @defun image-current-frame image
......
...@@ -145,8 +145,6 @@ directory, respectively. ...@@ -145,8 +145,6 @@ directory, respectively.
`f' (`image-next-frame') and `b' (`image-previous-frame') visit the `f' (`image-next-frame') and `b' (`image-previous-frame') visit the
next or previous frame. `F' (`image-goto-frame') shows a specific frame. 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. *** The command `image-mode-fit-frame' deletes other windows.
When toggling, it restores the frame's previous window configuration. 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). ...@@ -291,6 +289,21 @@ rather than inheriting from it (as do face specs set via Customize).
*** New face characteristic (supports :underline (:style wave)) *** New face characteristic (supports :underline (:style wave))
specifies whether or not the terminal can display a wavy line. 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. ** time-to-seconds is not obsolete any more.
** New function special-form-p. ** New function special-form-p.
** Docstrings can be made dynamic by adding a `dynamic-docstring-function' ** Docstrings can be made dynamic by adding a `dynamic-docstring-function'
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment