From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: storm@cua.dk (Kim F. Storm) Newsgroups: gmane.emacs.devel Subject: animage.el -- animated image support in Emacs Date: Fri, 21 Apr 2006 23:15:50 +0200 Message-ID: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1145654288 13951 80.91.229.2 (21 Apr 2006 21:18:08 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 21 Apr 2006 21:18:08 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Apr 21 23:18:04 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FX30o-0002Vh-EJ for ged-emacs-devel@m.gmane.org; Fri, 21 Apr 2006 23:17:58 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FX30n-0004tW-FG for ged-emacs-devel@m.gmane.org; Fri, 21 Apr 2006 17:17:57 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FX30a-0004tA-Qw for emacs-devel@gnu.org; Fri, 21 Apr 2006 17:17:44 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FX30Z-0004sF-G0 for emacs-devel@gnu.org; Fri, 21 Apr 2006 17:17:44 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FX30Z-0004s8-CN for emacs-devel@gnu.org; Fri, 21 Apr 2006 17:17:43 -0400 Original-Received: from [195.41.46.235] (helo=pfepa.post.tele.dk) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FX32C-0005GJ-PE for emacs-devel@gnu.org; Fri, 21 Apr 2006 17:19:25 -0400 Original-Received: from kfs-l.imdomain.dk.cua.dk (0x503e2644.bynxx3.adsl-dhcp.tele.dk [80.62.38.68]) by pfepa.post.tele.dk (Postfix) with SMTP id B743BFAC039 for ; Fri, 21 Apr 2006 23:17:41 +0200 (CEST) Original-To: emacs-devel@gnu.org User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:53213 Archived-At: Below you will find animage.el which enables Emacs to show animated GIF files using the following code: (require 'animage) (setq anim (create-animated-image "/your/animated/image.gif" 'gif nil)) (insert-image anim) You can start and stop animation with (image-animate-start anim) (image-animate-stop anim) As a pre-requisite for the animated image support, I have already installed a few trivial changes to Emacs core. In image.el, I have split out most of the code in `create-image' into a new function `image-type' which other functions like `create-animated-image' can use. In image.c, I have fixed an ugly bug in four_corners_best, and added a new function image-extension-data which returns a raw representation of the extension data of a given (sub)image [when available]. For a GIF image, the extension-data contains information about animation timing, which is interpreted by the code below. The code is just 100+ lines, so it could be added directly to image.el, but I have placed it in a separate file named animage.el: ;;; animage.el --- animated image API ;; Copyright (C) 2006 Free Software Foundation, Inc. ;; Maintainer: FSF ;; Keywords: multimedia ;; This file is part of GNU Emacs. ;; GNU Emacs is free software; you can redistribute it and/or modify ;; it under the terms of the GNU General Public License as published by ;; the Free Software Foundation; either version 2, or (at your option) ;; any later version. ;; GNU Emacs is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License ;; along with GNU Emacs; see the file COPYING. If not, write to the ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, ;; Boston, MA 02110-1301, USA. ;;; Commentary: ;;; Code: (require 'image) (defcustom image-animate-max-time 30 "Time in seconds to animate images." :type 'integer :version "22.1" :group 'image) (defconst image-animated-types '(gif) "List of supported animated image types.") ;;;###autoload (defun create-animated-image (file-or-data &optional type data-p &rest props) "Create an animated image. FILE-OR-DATA is an image file name or image data. Optional TYPE is a symbol describing the image type. If TYPE is omitted or nil, try to determine the image type from its first few bytes of image data. If that doesn't work, and FILE-OR-DATA is a file name, use its file extension as image type. Optional DATA-P non-nil means FILE-OR-DATA is a string containing image data. Optional PROPS are additional image attributes to assign to the image, like, e.g. `:mask MASK'. Value is the image created, or nil if images of type TYPE are not supported. Images should not be larger than specified by `max-image-size'." (setq type (image-type file-or-data type data-p)) (when (image-type-available-p type) (let* ((animate (memq type image-animated-types)) (image (append (list 'image :type type (if data-p :data :file) file-or-data) (if animate '(:index 0 :mask heuristic)) props))) (if animate (image-animate-start image)) image))) (defun image-animate-timer (image) "Return the animation timer for image IMAGE." ;; See cancel-function-timers (let ((tail timer-list) timer) (while tail (setq timer (car tail) tail (cdr tail)) (if (and (eq (aref timer 5) #'image-animate-timeout) (consp (aref timer 6)) (eq (car (aref timer 6)) image)) (setq tail nil) (setq timer nil))) timer)) (defun image-animate-start (image &optional max-time) "Start animation of image IMAGE. Optional second arg MAX-TIME is number of seconds to animate image, or t to animate infinitely." (let ((anim (image-animated-p image)) timer tmo) (when anim (if (setq timer (image-animate-timer image)) (setcar (nthcdr 3 (aref timer 6)) max-time) (setq tmo (* (cdr anim) 0.01)) (setq max-time (or max-time image-animate-max-time)) (run-with-timer tmo nil #'image-animate-timeout image 1 (car anim) (if (numberp max-time) (- max-time tmo) max-time)))))) (defun image-animate-stop (image) "Stop animation of image." (let ((timer (image-animate-timer image))) (when timer (cancel-timer timer)))) (defun image-animate-timeout (image ino count time-left) (if (>= ino count) (setq ino 0)) (plist-put (cdr image) :index ino) (force-window-update) (let ((anim (image-animated-p image)) tmo) (when anim (setq tmo (* (cdr anim) 0.01)) (unless (and (= ino 0) (numberp time-left) (< time-left tmo)) (run-with-timer tmo nil #'image-animate-timeout image (1+ ino) count (if (numberp time-left) (- time-left tmo) time-left)))))) (defun image-animated-p (image) "Return non-nil if image is animated. Actually, return value is a cons (IMAGES . DELAY) where IMAGES is the number of sub-images in the animated image, and DELAY is the delay in 100ths of a second until the next sub-image shall be displayed." (cond ((eq (plist-get (cdr image) :type) 'gif) (let* ((extdata (image-extension-data image)) (images (plist-get extdata 'count)) (anim (plist-get extdata #xF9))) (and (integerp images) (> images 1) (stringp anim) (>= (length anim) 4) (cons images (+ (aref anim 1) (* (aref anim 2) 256)))))))) (provide 'animage) ;;; animage.el ends here -- Kim F. Storm http://www.cua.dk