使用JMagick+ImageMagick处理图片

使用JMagick+ImageMagick处理图片
一、ImageMagick介绍
ImageMagick是用C语言开发图片处理程序。可以对图片进行改变大小、旋转、锐化、减色或增加特效等操作。对图片的操作，即可以通过命令行进行，也可以用C/C++、Perl、Java、PHP、Python或Ruby编程来完成。
ImageMagick 的官网是：http://www.imagemagick.org/script/index.php

由于我们是java项目，直接使用java通过JNI技术调用ImageMagick是不行的。因为ImageMagick开发时没有使用java JNI生成的头文件。
可以使用jmagick解决，jmagick是由c语言开发的，开发时使用了java JNI生成的头文件，所以java可以通过JNI技术调用jmagick。jmagick再调用ImageMagick。这们我们处理图片使用的是jmagick暴露的java接口。
也可以使用JNA来调用ImageMagick，JNA全称是Java Native Access,JNA是在JNI的基础上完善的，方便的我们开发的。JNA项目主页是https://github.com/twall/jna。使用JNA来调用ImageMagick就须要直接操作ImageMagick提供的C接口(API)。

二、windows环境的安装
在windows安装很简单，关于Q8与Q16区别，将在后面进行说明。
有动态版（dll），有静态版（static）,建议使用静态版。

关于Q8,Q16,Q32的说明：
Q8表示： 8-bits per pixel quantum
Q16表示：16-bits per pixel quantum
在Install-unix.txt文件中的解释说明，避免翻译的不好误导大家，请大家自己去看原文吧。大意是：大多数电脑显示使用8-bit per pixel quantums。使用16-bit per pixel quantums在处理图片时比8-bit慢15%至50%，并须要更多的内存。
处理一张1024x768像素的图片8-bit要使用3M内存，16-bit要使用8M内存，32-bit需要使用15M内存
8-bit可表示0-255种值，16-bit可表示0-65535种值，32-bit可表示0-4294967295种值。
默认值是8-bit.

如果安装Q8，请使用文件：
ImageMagick-6.3.9-0-Q8-windows-dll.exe
jmagick-win-6.3.9-Q8.zip

如果安装Q16，请使用文件：
ImageMagick-6.3.9-0-Q16-windows-dll.exe
jmagick-win-6.3.9-Q16.zip

1.首先给出这个地址：http://downloads.jmagick.org/6.3.9/，这个里面包含了ImageMagick的安装文件、jmagick.dll和jmagick.jar，最关键的是它们是版本一致的，不会出现一些奇怪的问题。最容易出现的问题是：

java.lang.UnsatisfiedLinkError: jmagick.dll: The specified procedure could not be found

java.lang.UnsatisfiedLinkError: jmagick.dll: Can't find dependent libraries....


我下载的文件：
ImageMagick-6.3.9-0-Q16-windows-dll.exe 32位windows下的动态连接库安装文件
jmagick-win-6.3.9-Q16.zip里面包含了jmagick.dll和jmagick.jar

2.安装过ImageMagick后，最好重启一下电脑，否者可能会出现找不到依赖库的错误。解压jmagick-win-6.3.9-Q16.zip，将其中的jmagick.dll复制到C:\WinNT\system32下面。在编写程序时，要将jmagick的jar包放到编译路径中，Eclipse会搞定这件事情。

这样就完成了，很简单。至于如何使用jmagick编写程序，可以参考：
http://downloads.jmagick.org/jmagick-doc/

三、 Linux环境的安装
由于没有图形化界面的支持，在Linux（OpenSuSE11 x64）上的配置相对Windows XP还是麻烦了一点。
前题:
服务器如果没有安装Jpeg v8b、libPng、FreeType 的要在安装imagemagick之前先装好，否则imagemagick没法读取jpeg和png图片，字体文件也读不了.
1、 查看libjpeg是否已安装 (rpm –qa|grep libjpeg)

卸载：
rpm -e --nodeps libjpeg-6.2.0-879.10
rpm -e --nodeps libjpeg-32bit-6.2.0-879.10
安装：
rpm -ivh libjpeg8-8.0.2-3.1.x86_64.rpm
rpm -ivh libjpeg8-devel-8.0.2-3.1.x86_64.rpm

2、 查看libpng是否已经安装 (rpm -qa|grep libpng检查是否已经安装)

卸载：
rpm -e --nodeps libpng12-0-32bit-1.2.31-5.12.1
rpm -e --nodeps libpng12-0-32bit-1.2.31-5.12.1
安装：
rpm -ivh libpng-1.2.5-190.1.x86_64.rpm
rpm -ivh libpng-devel-1.2.5-190.1.x86_64.rpm

问题：rpm -ivh libpng-devel-1.2.5-190.1.x86_64.rpm
error: Failed dependencies:
zlib-devel is needed by libpng-devel-1.2.5-190.1.x86_64 
解决办法：
请先执行如下第3步操作再安装libpng-devel-1.2.5-190.1.x86_64.rpm

3、 查看zlib是否已安装(rpm -qa|grep zlib)

注：在卸载zlib时一定不要将zlib-1.2.3-106.34给卸载了，否则系统将无法运行。
卸载：
rpm -e --nodeps zlib-32bit-1.2.3-106.34
安装：
rpm -U zlib-1.2.3-134.1.x86_64.rpm
rpm -ivh zlib-devel-1.2.3-134.1.x86_64.rpm
ImageMagick和Jmagick的安装步骤：
1、下载ImageMagick和JMagick的源文件（http://downloads.jmagick.org/6.4.0/）：ImageMagick-6.4.0.-0tar.gz 和 jmagick-6.4.0-src.tar.gz。

2、解压并安装ImageMagick：

# tar xzvf ImageMagick-6.4.0-0.tar.gz

# cd ImageMagick-6.4.0
 
# ./configure --prefix=/usr/local/ImageMagick-6.4.0 --enable-shared --with-quantum-depth=8 --enable-static --without-perl

# make

# make install

# make check
安装完成后，运行convert -version命令检测，应该会出现：

Version: ImageMagick 6.4.0 08/31/10 Q16 http://www.imagemagick.org
Copyright: Copyright (C) 1999-2008 ImageMagick Studio LLC
convert默认安装到了/usr/local/bin下面，上面的命令可能提示找不到convert命令。那么可以添加如下环境变量即可使用。

3. 修改配置文件:

# vi /etc/profile

在/etc/profile文件的最后增加如下配置：

export JAVA_HOME=/usr/java/java
PATH=$PATH:$JAVA_HOME/bin:$JAVA_HOME/jre/bin
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$CLASSPATH
export JAVA_HOME PATH CLASSPATH

export MAGICK_HOME="/usr/local/ImageMagick-6.4.0"
export PATH="$MAGICK_HOME/bin:$PATH"
LD_LIBRARY_PATH=$MAGICK_HOME/lib:/usr/local/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH

注意：修改完后执行 ldconfig 让设置立即生效，并logout，然后重新登录。

4. ImageMagick安装后究竟支持那些格式的文件，可以使用以下命令完成
convert –list configure得到如下图所示：

如果没有出现红色框标注的部分，则需要重复上面的2步骤，重新安装imageMagick.
5. 在安装JMagick之前先配置环境变量，尤其是JAVA_HOME，否则编译时会出现：JMagick configure: error: 'Unable to locate Java directories'的错误。
 
6. 安装JMagick。

# tar xzvf jmagick-6.4.0-src.tar.gz

解压到了文件夹6.4.0中，为了便于区分，重命名该文件夹：

# mv 6.4.0 jmagick-6.4.0

# cd jmagick-6.4.0

# ./configure --prefix=/usr/local/Jmagick-6.4.0 --with-java-home=/usr/java/java --with-magick-home=/usr/local/ImageMagick-6.4.0

# make all

# make install

将生成的libJMagick-6.4.0.so复制到jre中的lib/amd64（amd64可能在不同的硬件架构会有不同的名字，如i386）文件夹中，同时重命名为libJMagick.so。

# cd /usr/local/Jmagick-6.4.0/lib

# cp libJMagick-6.4.0.so $JAVA_HOME/jre/lib/amd64/libJMagick.so
 
将jmagick-6.4.0.jar复制到$JAVA_HOME/jre /lib/ext文件夹下，并重命名为jmagick.jar

# cp jmagick-6.4.0.jar $JAVA_HOME/jre/lib/ext/jmagick.jar

将jmagick-6.4.0.jar复制到tomcat/common/lib文件夹下，并重命名为jmagick.jar

# cp jmagick-6.4.0.jar /home/zxin10/was/tomcat/common/lib/jmagick.jar

至此就配置完毕了。

7. 测试安装是否正常
进入ImageMagick安装目录,cd /usr/local/ImageMagick-6.4.0/bin

convert logo: logo.gif 
convert logo: logo.png 
convert logo: logo.jpg 
convert logo: logo.jpeg

可以拷贝生成的文件到本地后查看，应该如下图所示，则说明所有安装均正常：
8. 给用户赋权限
# chown –R username:groupname /usr/local/ImageMagick-6.4.0


注意：如果在生成jpg时报如下错误：
magick.MagickException: Unable to retrievehandle at magick.MagickImage.getDimension(Native Method) 
则说明jasper-1.900.1.zip包安装不正确，无法正确处理jpeg2000格式jp2,jpc，需要按照步骤重新安装。


注意：如果在生成jpg时报如下错误：
magick.MagickException: Unable to retrievehandle at magick.MagickImage.getDimension(Native Method) 
则说明jasper-1.900.1.zip包安装不正确，无法正确处理jpeg2000格式jp2,jpc，需要按照步骤重新安装。

四、常见问题以及解决方法
System.out.println(System.getProperty("java.library.path")).
直接用System.out.println(System.getProperty("java.library.path")).
打印出当前环境的路径，然后再把jmagick.dll或jmagick.so 复制到其中的一个路径文件夹中问题解决。

magick.MagickException: No image to scale
版本不匹配,要像下面这们,都是同一个版本号
ImageMagick-6.4.0-0.tar.gz
jmagick-6.4.0-src.tar.gz

magick.MagickException: Unable to retrieve handle
要调用 magick.MagickImage.destroyImages() 来关闭

no decode delegate for this image format
使用:identify -list format
判断有支持几种图片格式，没有的则需要安装对应的格式库

单线程转换每张图片大概50ms，两个线程却需要500ms？
用convert --version  命令查看
看是否出现openMP字样，出现的话，是因为机器不支持openMP导致的。
需要重新编译./configure --disable-openmp  在进行安装

首先检查一下电脑里已经安装的ImageMagick版本：
convert -version

记在最后:
Ubuntu系统已安装有ImageMagick,只是版本不是我须要的版本,
convert文件在放在了/usr/bin,所以我使用/usr/local/ImageMagick-6.4.0/bin目录里的convert覆盖了/usr/bin目录里的convert
cd /usr/local/ImageMagick-6.4.0/bin
cp ./convert /usr/bin