root/gs2-extensions/imagemagick/trunk/README @ 31144

Revision 31144, 6.6 KB (checked in by ak19, 3 years ago)

Fixing typos

Line 
131 Oct 2016
2ak19
3
4If making an imagemagick binary tarball, here are the steps to go through and the things to check
5
6
7TO CREATE THE IMAGEMAGICK TARBALL FOR DARWIN EL CAPITAN
8
91. svn co http://svn.greenstone.org/gs2-extensions/imagemagick/trunk
10
112. Then:
12   cd src
13   ./CASCADE-MAKE.sh
14
153. See section THINGS TO CHECK below and perform the tests there to check the compiled up imagemagick works.
16
174. Create an imagemagick folder containing only setup.bash, setup.bat and the darwin folder.
18
19The darwin folder should only contain the following 4 folders, so remove the rest:
20- script
21- etc
22- lib
23- bin: cut down to just the following
24  Magick++-config
25  Magick-config
26  MagickCore-config
27  MagickWand-config
28  Wand-config
29  identify
30  convert
31
32Note: As per the El Capitan release-kit (kits/rk3/ant-scripts/compile.xml), only the darwin folder within the tarball (and not the setup scripts) will get copied over as the "imagemagick" folder into gs2build/bin/darwin. (So the "darwin" folder will be named "imagemagick" in the final binary.)
33
345. Create a tarball of the imagemagick folder created in step 4 above (containing the darwin subfolder and the 2 setup scripts) and name the tarball imagemagick-darwin-10.11.tar.gz
35
36   tar -cvzf imagemagick-darwin-10.11.tar.gz imagemagick
37
386. Commit the tarball into the trunk folder checked out in step 1 above.
39
40
41THINGS TO CHECK
42
43To test imagemagick works:
44
451. ./identify -list format
46
47It should print out the list of image conversion formats supported. Check the read/write status of the listed file formats: we want r,w  (read and write abilities) for GIF, JPG, PNG, TIFF.
48
492. Next run
50   ./convert logo: logo.png
51
52This will (should) generate a file called logo.png in the same location.
53Check that it is indeed PNG by running:
54
55   file logo.png
56
57The file info printed should say whether it's PNG. If things went wrong, the actual file produced might be listed as GIF still. In that case, the conversion was unsuccessful, which means something could be wrong with the delegate/imgmagick library for that image file format. Check for any errors when configuring and compiling up that delegate library.
58
59
60
61RESOURCES ON COMPILING UP AN IMAGEMAGICK BINARY STATICALLY
62
63- http://www.imagemagick.org/script/download.php
64
65- http://stackoverflow.com/questions/25634129/compile-static-version-of-imagemagick-convert-util
66
67- http://imagemagick.sourceforge.net/docs/GuideToBuildingIMForMacOSX.pdf
68
69- http://www.imagemagick.org/discourse-server/viewtopic.php?t=13145
70
71Words to look out for:
72delegates
73
74./convert
75different listing of formats supported?
76
77
78depends on:
79- version of imgmagick (src code)
80- whether it uses xwindows libraries or not
81-> macs used to come with xwindows libraries, and imgmagick used to make use of that. But now Macs aren't guaranteed to come with xwindows libs, so for El Capitan binaries, compile up ImageMagick tarball on Gilda El Capitan (which produces bins not dependent on xwindows libs), rather than generating the tarball on the ElCap laptop where xwin libs are available and dynamically linked to (but these libs are then found missing on other El Capitan machines like Gilda, and the convert command will fail).
82
83
84FILE LISTING:
85
86gilda:GS3bin_28Oct2016 anupama$ cd gs2build/bin/darwin/imagemagick/
87
88gilda:imagemagick anupama$ ls
89bin       etc      lib  script
90
91gilda:imagemagick anupama$ ls script/
92aspectpad.sh
93
94gilda:imagemagick anupama$ ls -la lib/
95total 38672
96drwxr-xr-x  41 anupama  wheel     1394 28 Oct 15:37 .
97drwxr-xr-x   6 anupama  wheel      204 28 Oct 15:37 ..
98drwxr-xr-x   3 anupama  wheel      102 28 Oct 15:37 ImageMagick-6.9.5
99-rw-r--r--   1 anupama  wheel      642 24 Aug 13:54 charset.alias
100drwxr-xr-x   6 anupama  wheel      204 28 Oct 15:37 gettext
101-rw-r--r--   1 anupama  wheel  1108152 24 Aug 14:03 libMagick++-6.Q16.a
102-rw-r--r--   1 anupama  wheel     1691 24 Aug 14:03 libMagick++-6.Q16.la
103-rw-r--r--   1 anupama  wheel  7242008 24 Aug 14:03 libMagickCore-6.Q16.a
104-rw-r--r--   1 anupama  wheel     1491 24 Aug 14:03 libMagickCore-6.Q16.la
105-rw-r--r--   1 anupama  wheel  2624976 24 Aug 14:03 libMagickWand-6.Q16.a
106-rw-r--r--   1 anupama  wheel     1594 24 Aug 14:03 libMagickWand-6.Q16.la
107-rw-r--r--   1 anupama  wheel    53392 24 Aug 13:52 libasprintf.a
108-rw-r--r--   1 anupama  wheel      943 24 Aug 13:52 libasprintf.la
109-rw-r--r--   1 anupama  wheel   104624 24 Aug 13:54 libbz2.a
110-rw-r--r--   1 anupama  wheel     9400 24 Aug 13:48 libcharset.a
111-rw-r--r--   1 anupama  wheel      938 24 Aug 13:48 libcharset.la
112-rw-r--r--   1 anupama  wheel     1228 24 Aug 13:53 libgettextlib.la
113-rw-r--r--   1 anupama  wheel  1352208 24 Aug 13:53 libgettextpo.a
114-rw-r--r--   1 anupama  wheel     1215 24 Aug 13:53 libgettextpo.la
115-rw-r--r--   1 anupama  wheel     1325 24 Aug 13:53 libgettextsrc.la
116-rw-r--r--   1 anupama  wheel  1292104 24 Aug 13:48 libiconv.a
117-rw-r--r--   1 anupama  wheel      932 24 Aug 13:48 libiconv.la
118-rw-r--r--   1 anupama  wheel   211720 24 Aug 13:53 libintl.a
119-rw-r--r--   1 anupama  wheel     1109 24 Aug 13:53 libintl.la
120-rw-r--r--   1 anupama  wheel   595296 24 Aug 13:57 libjasper.a
121-rw-r--r--   1 anupama  wheel      988 24 Aug 13:57 libjasper.la
122-rw-r--r--   1 anupama  wheel   421824 24 Aug 13:55 libjpeg.a
123-rw-r--r--   1 anupama  wheel     1016 24 Aug 13:55 libjpeg.la
124-rw-r--r--   1 anupama  wheel   281688 24 Aug 13:57 libpng.a
125-rw-r--r--   1 anupama  wheel     1022 24 Aug 13:57 libpng.la
126-rw-r--r--   1 anupama  wheel   281688 24 Aug 13:57 libpng14.a
127-rw-r--r--   1 anupama  wheel     1022 24 Aug 13:57 libpng14.la
128-rw-r--r--   1 anupama  wheel  1376688 24 Aug 13:56 libtiff.a
129-rw-r--r--   1 anupama  wheel     1114 24 Aug 13:56 libtiff.la
130-rw-r--r--   1 anupama  wheel   125408 24 Aug 13:56 libtiffxx.a
131-rw-r--r--   1 anupama  wheel     1211 24 Aug 13:56 libtiffxx.la
132-rw-r--r--   1 anupama  wheel  2495888 24 Aug 13:55 libxml2.a
133-rw-r--r--   1 anupama  wheel     1124 24 Aug 13:55 libxml2.la
134-rw-r--r--   1 anupama  wheel   108264 24 Aug 13:54 libz.a
135drwxr-xr-x  18 anupama  wheel      612 28 Oct 15:37 pkgconfig
136-rw-r--r--   1 anupama  wheel      357 24 Aug 13:55 xml2Conf.sh
137
138gilda:imagemagick anupama$ ls etc/
139ImageMagick-6
140
141gilda:imagemagick anupama$ ls -la bin/
142total 38240
143drwxr-xr-x  9 anupama  wheel      306 28 Oct 15:37 .
144drwxr-xr-x  6 anupama  wheel      204 28 Oct 15:37 ..
145-rwxrwxr-x  1 anupama  wheel     1328 24 Aug 14:03 Magick++-config
146-rwxrwxr-x  1 anupama  wheel     1294 24 Aug 14:03 Magick-config
147-rwxrwxr-x  1 anupama  wheel     1302 24 Aug 14:03 MagickCore-config
148-rwxrwxr-x  1 anupama  wheel     1542 24 Aug 14:03 MagickWand-config
149-rwxrwxr-x  1 anupama  wheel     1289 24 Aug 14:03 Wand-config
150-rwxrwxr-x  1 anupama  wheel  9903736 24 Aug 14:03 convert
151-rwxrwxr-x  1 anupama  wheel  9653688 24 Aug 14:03 identify
152
Note: See TracBrowser for help on using the browser.