source: gs2-extensions/imagemagick/trunk/README@ 32016

Last change on this file since 32016 was 32016, checked in by ak19, 7 years ago
  1. Shifting the imagemagick windows binary to within trunk where the unix binaries are. 2. Updating the README to indicate that the windows imagemagick binary was a mere zip up of the bin\windows\imagemagick folder on trac.
File size: 8.0 KB
Line 
131 Oct 2016, last updated 1 Feb 2017
2ak19
3
4If making an imagemagick binary tarball, here are the steps to go through and the things to check
5
6WINDOWS IMAGEMAGICK BINARY
7This was merely a zip up of the bin\windows\imagemagick folder checked out from http://trac.greenstone.org/browser/main/trunk/binaries/windows/bin/imagemagick
8I then removed the .svn subfolder, zipped it up and put it here. The purpose is for people working with GS2 source distributions to grab a quick copy, as the compilation process doesn't compile up imagemagick.
9For GS2's unix systems, if "imagemagick" is passed in as parameter to the makegs2.sh script, it will now download the appropriate imagemagick binary tarball for the unix flavour from http://trac.greenstone.org/browser/gs2-extensions/imagemagick after compilation has succeeded.
10
11
12TO CREATE THE IMAGEMAGICK TARBALL FOR DARWIN EL CAPITAN
13
140. Need to be on an El Capitan that should not have xwindows (like Dr Bainbridge's El Capitan laptop), so that we don't produce imagemagick binaries dependent on these libs, see trac changeset 31012.
15
16For general information: An important change involved setting the mmacosx-version-min=10.8, in order to get the generated imagemagick binary to work on more Mac El Capitan machines, as explained in the commit message for http://trac.greenstone.org/changeset/31145:
17"Redoing El Capitan imgmagick binary for release after testing on an uncooperative El Cap Mac machine. The key change involved recompiling with mmacosx-version-min=10.8 (Mountain Lion) to make the binary more backwards compatible."
18
191. svn co http://svn.greenstone.org/gs2-extensions/imagemagick/trunk
20
212. Then:
22 cd src
23 ./CASCADE-MAKE.sh
24
253. See section THINGS TO CHECK below and perform the tests there to check the compiled up imagemagick works.
26
274. Create an imagemagick folder containing only setup.bash, setup.bat and the darwin folder.
28
29The darwin folder should only contain the following 4 folders, so remove the rest:
30- script
31- etc
32- lib
33- bin: cut down to just the following
34 Magick++-config
35 Magick-config
36 MagickCore-config
37 MagickWand-config
38 Wand-config
39 identify
40 convert
41
42Note: 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.)
43
445. 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
45
46 tar -cvzf imagemagick-darwin-10.11.tar.gz imagemagick
47
486. Commit the tarball into the trunk folder checked out in step 1 above.
49
50
51THINGS TO CHECK
52
53To test imagemagick works:
54
551. ./identify -list format
56
57It 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.
58
592. Next run
60 ./convert logo: logo.png
61
62This will (should) generate a file called logo.png in the same location.
63Check that it is indeed PNG by running:
64
65 file logo.png
66
67The 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.
68
69
70
71RESOURCES ON COMPILING UP AN IMAGEMAGICK BINARY STATICALLY
72
73- http://www.imagemagick.org/script/download.php
74
75- http://stackoverflow.com/questions/25634129/compile-static-version-of-imagemagick-convert-util
76
77- http://imagemagick.sourceforge.net/docs/GuideToBuildingIMForMacOSX.pdf
78
79- http://www.imagemagick.org/discourse-server/viewtopic.php?t=13145
80
81Words to look out for:
82delegates
83
84./convert
85different listing of formats supported?
86
87
88depends on:
89- version of imgmagick (src code)
90- whether it uses xwindows libraries or not
91-> 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).
92
93
94FILE LISTING:
95
96gilda:GS3bin_28Oct2016 anupama$ cd gs2build/bin/darwin/imagemagick/
97
98gilda:imagemagick anupama$ ls
99bin etc lib script
100
101gilda:imagemagick anupama$ ls script/
102aspectpad.sh
103
104gilda:imagemagick anupama$ ls -la lib/
105total 38672
106drwxr-xr-x 41 anupama wheel 1394 28 Oct 15:37 .
107drwxr-xr-x 6 anupama wheel 204 28 Oct 15:37 ..
108drwxr-xr-x 3 anupama wheel 102 28 Oct 15:37 ImageMagick-6.9.5
109-rw-r--r-- 1 anupama wheel 642 24 Aug 13:54 charset.alias
110drwxr-xr-x 6 anupama wheel 204 28 Oct 15:37 gettext
111-rw-r--r-- 1 anupama wheel 1108152 24 Aug 14:03 libMagick++-6.Q16.a
112-rw-r--r-- 1 anupama wheel 1691 24 Aug 14:03 libMagick++-6.Q16.la
113-rw-r--r-- 1 anupama wheel 7242008 24 Aug 14:03 libMagickCore-6.Q16.a
114-rw-r--r-- 1 anupama wheel 1491 24 Aug 14:03 libMagickCore-6.Q16.la
115-rw-r--r-- 1 anupama wheel 2624976 24 Aug 14:03 libMagickWand-6.Q16.a
116-rw-r--r-- 1 anupama wheel 1594 24 Aug 14:03 libMagickWand-6.Q16.la
117-rw-r--r-- 1 anupama wheel 53392 24 Aug 13:52 libasprintf.a
118-rw-r--r-- 1 anupama wheel 943 24 Aug 13:52 libasprintf.la
119-rw-r--r-- 1 anupama wheel 104624 24 Aug 13:54 libbz2.a
120-rw-r--r-- 1 anupama wheel 9400 24 Aug 13:48 libcharset.a
121-rw-r--r-- 1 anupama wheel 938 24 Aug 13:48 libcharset.la
122-rw-r--r-- 1 anupama wheel 1228 24 Aug 13:53 libgettextlib.la
123-rw-r--r-- 1 anupama wheel 1352208 24 Aug 13:53 libgettextpo.a
124-rw-r--r-- 1 anupama wheel 1215 24 Aug 13:53 libgettextpo.la
125-rw-r--r-- 1 anupama wheel 1325 24 Aug 13:53 libgettextsrc.la
126-rw-r--r-- 1 anupama wheel 1292104 24 Aug 13:48 libiconv.a
127-rw-r--r-- 1 anupama wheel 932 24 Aug 13:48 libiconv.la
128-rw-r--r-- 1 anupama wheel 211720 24 Aug 13:53 libintl.a
129-rw-r--r-- 1 anupama wheel 1109 24 Aug 13:53 libintl.la
130-rw-r--r-- 1 anupama wheel 595296 24 Aug 13:57 libjasper.a
131-rw-r--r-- 1 anupama wheel 988 24 Aug 13:57 libjasper.la
132-rw-r--r-- 1 anupama wheel 421824 24 Aug 13:55 libjpeg.a
133-rw-r--r-- 1 anupama wheel 1016 24 Aug 13:55 libjpeg.la
134-rw-r--r-- 1 anupama wheel 281688 24 Aug 13:57 libpng.a
135-rw-r--r-- 1 anupama wheel 1022 24 Aug 13:57 libpng.la
136-rw-r--r-- 1 anupama wheel 281688 24 Aug 13:57 libpng14.a
137-rw-r--r-- 1 anupama wheel 1022 24 Aug 13:57 libpng14.la
138-rw-r--r-- 1 anupama wheel 1376688 24 Aug 13:56 libtiff.a
139-rw-r--r-- 1 anupama wheel 1114 24 Aug 13:56 libtiff.la
140-rw-r--r-- 1 anupama wheel 125408 24 Aug 13:56 libtiffxx.a
141-rw-r--r-- 1 anupama wheel 1211 24 Aug 13:56 libtiffxx.la
142-rw-r--r-- 1 anupama wheel 2495888 24 Aug 13:55 libxml2.a
143-rw-r--r-- 1 anupama wheel 1124 24 Aug 13:55 libxml2.la
144-rw-r--r-- 1 anupama wheel 108264 24 Aug 13:54 libz.a
145drwxr-xr-x 18 anupama wheel 612 28 Oct 15:37 pkgconfig
146-rw-r--r-- 1 anupama wheel 357 24 Aug 13:55 xml2Conf.sh
147
148gilda:imagemagick anupama$ ls etc/
149ImageMagick-6
150
151gilda:imagemagick anupama$ ls -la bin/
152total 38240
153drwxr-xr-x 9 anupama wheel 306 28 Oct 15:37 .
154drwxr-xr-x 6 anupama wheel 204 28 Oct 15:37 ..
155-rwxrwxr-x 1 anupama wheel 1328 24 Aug 14:03 Magick++-config
156-rwxrwxr-x 1 anupama wheel 1294 24 Aug 14:03 Magick-config
157-rwxrwxr-x 1 anupama wheel 1302 24 Aug 14:03 MagickCore-config
158-rwxrwxr-x 1 anupama wheel 1542 24 Aug 14:03 MagickWand-config
159-rwxrwxr-x 1 anupama wheel 1289 24 Aug 14:03 Wand-config
160-rwxrwxr-x 1 anupama wheel 9903736 24 Aug 14:03 convert
161-rwxrwxr-x 1 anupama wheel 9653688 24 Aug 14:03 identify
162
Note: See TracBrowser for help on using the repository browser.