merge and fixes
[emacs.git] / README.imagemagick
blob9096fe2b2f81fb89d957db1a870799e060479bb8
1 This is the imagemagick branch of Emacs. Imagemagick can now be used
2 to load many new image formats, and also do useful transforms like
3 scaling and rotation.
5 This file will attempt to contain draft NEWS, Changelog and manual
6 entries for the new functionality. 
8 You might need to regenerate the configure scripts:
9 aclocal
10 automake
11 autoheader
12 autoconf
13 ./configure --with-imagemagick
17 TODO
18 - complete documentation drafts below
19 - test with more systems, only tested on Fedora 12 so far, and the
20 libmagick that ships it.
21 - fix inconsistencys with spelling of imagemagick in the src
22 - report number of images in image bundle types somehow
23 - probably add pdf to inhibited types
24 - inhibit types is defconst should probably be defcustom
25 - decide what to do with some uncommitted imagemagick support
26   functions for image size etc.
27   
29 * NEWS entry
30 ** ImageMagick support
31 It is now possible to use the Imagemagick library to load many new
32 image formats in Emacs.
34 To enable, use the following configure option:
35 --with-imagemagick
37 The new function (imagemagick-types) returns a list of image file
38 extensions that your installation of imagemagick supports.
40 The function (imagemagick-register-types) will enable the imagemagick
41 support for the extensions in imagemagick-types minus the types listed
42 in imagemagick-types-inhibit.
44 imagemagick-types-inhibit has the value  '(C HTML HTM TXT) by default.
45 This means imagemagick will be used also to load jpeg files, if you
46 have both jpeg and imagemagick libraries linked. Add 'JPG to
47 imagemagick-types-inhibit if you do not want this.
49 Images loaded with imagemagick will support a couple of new display
50 specifications:
52 - scale
53 - rotation
54 - index
56 * Changelog entry
57 nothing yet
59 * Manual entry
60 nothing yet