Linuxソースからの高度なインストール

ダウンロードと展開 • 設定 • ビルド • インストール • Linux固有のビルド手順 • Mac OS X固有のビルド手順 • MinGW固有のビルド手順 • 予期しない問題への対処

Linuxシステムでの高度なインストールに関心がない場合は、コンパイル済みのバイナリリリースをインストールすることもできます。または、ソースからインストールしたいが、複雑な手順を避けたい場合は、簡単なソースからのインストール手順を参照してください。ただし、LinuxシステムでImageMagickの設定とインストールをカスタマイズする場合は、ここから始めましょう。

ダウンロードと展開

ImageMagickは、Linux、Solaris、FreeBSD、Mac OS Xなど、さまざまなLinuxおよびLinux系のオペレーティングシステムでビルドできます。コンパイラが必要ですが、幸いなことに、ほとんどの最新のLinuxシステムにはコンパイラが搭載されています。ImageMagick.tar.gzをimagemagick.orgまたはミラーサイトからダウンロードし、配布ファイルのメッセージダイジェストと照合して検証してください。

以下のコマンドで配布ファイルを展開します。

tar xvzf ImageMagick.tar.gz

ImageMagickのLinuxソース配布ファイルを展開したので、次に設定を行います。

設定

configureスクリプトは、システム環境を調べ、ImageMagickをコンパイルしてインストールするために必要なものを決定します。これには、コンパイラの検索、コンパイラヘッダーファイル（例：stdlib.h）の場所の特定、ImageMagickが使用できるデリゲートライブラリ（例：JPEG、PNG、TIFFなど）の有無の確認などが含まれます。 configureのデフォルトオプションを受け入れ、ソースディレクトリ内でビルドする場合は、次のコマンドを入力するだけです。

$ cd ImageMagick-7.1.1-38
$ ./configure

configureスクリプトの出力を監視し、必要なものがすべて見つかっていることを確認してください。特にスクリプト出力の最後の行に注目してください。たとえば、私たちのシステムからの最近のレポートは次のとおりです。

ImageMagick is configured as follows. Please verify that this configuration
matches your expectations.

Host system type: x86_64-unknown-linux-gnu
Build system type: x86_64-unknown-linux-gnu

                  Option                     Value
-------------------------------------------------------------------------------
Shared libraries  --enable-shared=yes		yes
Static libraries  --enable-static=yes		yes
Module support    --with-modules=yes		yes
GNU ld            --with-gnu-ld=yes		yes
Quantum depth     --with-quantum-depth=16	16
High Dynamic Range Imagery
                  --enable-hdri=no		no

Delegate Configuration:
BZLIB             --with-bzlib=yes		yes
Autotrace         --with-autotrace=yes	yes
DJVU              --with-djvu=yes		no
DPS               --with-dps=yes		no
FlashPIX          --with-fpx=yes		no
FontConfig        --with-fontconfig=yes	yes
FreeType          --with-freetype=yes		yes
GhostPCL          None			pcl6 (unknown)
GhostXPS          None			gxps (unknown)
Ghostscript       None			gs (8.63)
result_ghostscript_font_dir='none'
Ghostscript fonts --with-gs-font-dir=default
Ghostscript lib   --with-gslib=yes		no (failed tests)
Graphviz          --with-gvc=yes		yes
JBIG              --with-jbig=		no
JPEG v1           --with-jpeg=yes		yes
JPEG-2000         --with-jp2=yes		yes
LCMS              --with-lcms=yes		yes
LQR               --with-lqr=yes		no
Magick++          --with-magick-plus-plus=yes	yes
OpenEXR           --with-openexr=yes		yes
PERL              --with-perl=yes		/usr/bin/perl
PNG               --with-png=yes		yes
RSVG              --with-rsvg=yes		yes
TIFF              --with-tiff=yes		yes
result_windows_font_dir='none'
Windows fonts     --with-windows-font-dir=
WMF               --with-wmf=yes		yes
X11               --with-x=			yes
XML               --with-xml=yes		yes
ZLIB              --with-zlib=yes		yes

X11 Configuration:
      X_CFLAGS        =
      X_PRE_LIBS      = -lSM -lICE
      X_LIBS          =
      X_EXTRA_LIBS    =

Options used to compile and link:
  PREFIX          = /usr/local
  EXEC-PREFIX     = /usr/local
  VERSION         = 6.4.8
  CC              = gcc -std=gnu99
  CFLAGS          = -fopenmp -g -O2 -Wall -W -pthread
  MAGICK_CFLAGS   = -fopenmp -g -O2 -Wall -W -pthread
  CPPFLAGS        = -I/usr/local/include/ImageMagick
  PCFLAGS         = -fopenmp
  DEFS            = -DHAVE_CONFIG_H
  LDFLAGS         = -lfreetype
  MAGICK_LDFLAGS  = -L/usr/local/lib -lfreetype
  LIBS            = -lMagickCore-Q16 -llcms -ltiff -lfreetype -ljpeg -lfontconfig -lXext
                    -lSM -lICE -lX11 -lXt -lbz2 -lz -lm -lgomp -lpthread -lltdl
  CXX             = g++
  CXXFLAGS        = -g -O2 -Wall -W -pthread

configureコマンドラインで変数の初期値を設定することにより、コンパイラの選択、コンパイルフラグ、またはライブラリに影響を与えることができます。これらには、特に以下のものが含まれます。

CC

使用するCコンパイラの名前（例：cc -Xa）。

CXX

使用するC++コンパイラの名前（例：CC）。

CFLAGS

Cコードをコンパイルするためのコンパイラフラグ（例：-g -O2）。

CXXFLAGS

C++コードをコンパイルするためのコンパイラフラグ（例：-g -O2）。

CPPFLAGS

ヘッダーファイルを検索するためのインクルードパス（例：-I/usr/local）。

LDFLAGS

ライブラリを検索するためのライブラリパス（例：-L/usr/local）。ライブラリ実行パスをサポートするシステムでは、実行時に共有ライブラリを見つけるために追加の引数が必要になる場合があります。たとえば、Solarisリンカには-R/path形式の引数が必要です。一部のLinuxシステムは-rpath /usr/local/libで動作しますが、gccがリンカに-rpathを渡さない他のLinuxシステムでは、-Wl,-rpath,/usr/local/lib形式の引数が必要です。

LIBS

リンクに必要な追加のライブラリ（例：-l/usr/local/lib）。

コマンドラインからconfigure変数を設定する例を次に示します。

configure CC=c99 CFLAGS=-O2 LDFLAGS='-L/usr/local/lib -R/usr/local/lib' LIBS=-lposix

ディレクトリパスを必要とする変数（例：CPPFLAGSまたはLDFLAGS）は、相対パスではなく絶対パスを指定する必要があります。

Configureは通常、Xのインクルードファイルとライブラリファイルを自動的に見つけることができますが、見つからない場合は、--x-includes=pathオプションと--x-libraries=pathオプションを使用して場所を指定できます。

configureスクリプトは、ImageMagick固有のオプションを多数提供します。オプションを無効にする場合、--disable-somethingは--enable-something=noを指定することと同じであり、--without-somethingは--with-something=noを指定することと同じです。 configureオプションは次のとおりです（configure --helpを実行してすべてのオプションを確認してください）。

ImageMagickのオプションは、有効または無効にする機能、またはビルドに含めるパッケージを表します。機能が有効になっている場合（--enable-somethingを介して）、ImageMagickに既に存在するコードが有効になります。パッケージが有効になっている場合（--with-somethingを介して）、configureスクリプトはそれを検索し、適切にインストールされていて使用できる状態（ヘッダーとビルドライブラリがコンパイラによって検出される）であれば、ビルドに含まれます。 configureスクリプトは、すべての機能が無効になっており、すべてのパッケージが有効になっている状態で提供されます。一般に、パッケージを無効にする唯一の理由は、パッケージが存在するがビルドに適していない場合です（古いバージョンであるか、適切なコンパイルフラグでコンパイルされていない場合など）。

設定できるオプションの機能は次のとおりです。

設定できるオプションのパッケージは次のとおりです。

Quantum Depth     Valid Range (Decimal)   Valid Range (Hex)
    8             0-255                   00-FF
   16             0-65535                 0000-FFFF
   32             0-4294967295            00000000-FFFFFFFF

Quantum Depth   Virtual Memory
     8               3MB
    16               8MB
    32              15MB

configure は ImageMagick のインストールを容易にするように設計されていますが、ImageMagick のコンパイル時に後で発生する可能性のある問題を発見することがよくあります。 configure スクリプトは、指定されたコンパイルフラグ（CFLAGS）、プリプロセッサフラグ（CPPFLAGS）、およびリンカーフラグ（LDFLAGS）を使用してコンパイラ（CC）を実行することにより、ヘッダーとライブラリをテストします。エラーはすべてファイル config.log に記録されます。 configure がヘッダーまたはライブラリを検出できない場合は、このログファイルを確認して理由を特定してください。ただし、configure は何かを試して失敗するかどうかを確認することで機能するため、*config.log のエラーは正常* であることに注意してください。config.log のエラーは、テストがシステムで合格しているはずだった場合にのみ問題になります。

configure の失敗の一般的な原因は次のとおりです。1）デリゲートヘッダーがヘッダーインクルードパスにない（CPPFLAGS -I オプション）。 2）デリゲートライブラリがリンカー検索/実行パスにない（LDFLAGS -L/-R オプション）。 3）デリゲートライブラリに関数が欠落している（古いバージョン？）。 4）コンパイル環境に問題がある。

すべての合理的な是正措置を試みたが、問題が configure スクリプトの欠陥が原因であると思われる場合は、ImageMagick 欠陥サポートフォーラムにバグレポートを送信してください。すべてのバグレポートには、オペレーティングシステムの種類（uname -a によって報告される）とコンパイラ/コンパイラバージョンが含まれている必要があります。問題を見つけるために、configure スクリプトの出力のコピーや config.log ファイルの関連部分が必要になる場合があります。config.log の一部を投稿する場合は、configure 出力のスクリプトと、期待される内容（およびその理由）の説明も送信してください。そうすることで、観察している障害を特定して解決できます。

ImageMagick の設定が完了し、ビルドの準備ができました

ビルド

ImageMagick が設定されると、これらの標準ビルドターゲットは生成された make ファイルから利用できます

make

ImageMagick をビルドします。

sudo make install

ImageMagick をインストールします。

make check

インストールされた ImageMagick を使用してテストを実行します（最初に sudo make install を実行する必要があります）。 Ghostscript と Freetype は必須です。そうでない場合、テキストをレンダリングする特定のユニットテストと EPS、PS、および PDF 形式は失敗する可能性があります。これらのユニットテストでは、オープンセキュリティポリシーに合格する必要があります。

make clean

make によって作成されたビルドディレクトリ内のすべてを削除します。

make distclean

configure と make によって作成されたビルドディレクトリ内のすべてを削除します。これは、最初からやり直したい場合に役立ちます。

make uninstall

現在の設定を使用して sudo make install によってインストールされる（またはインストールされる）すべてのファイルをシステムから削除します。 Perl は uninstall ターゲットをサポートしなくなったため、このターゲットは PerlMagick にとって不完全であることに注意してください。

ほとんどの場合、次のコマンドで ImageMagick をコンパイルするだけです

make 

ビルドしたら、以下で説明するように、オプションで ImageMagick をシステムにインストールできます。

インストール

ImageMagick の設定とビルドが完了したら、次のように入力します

make install 

インストールします。

デフォルトでは、ImageMagick はバイナリを /../usr/local/bin に、ライブラリを /../usr/local/lib に、ヘッダーファイルを /../usr/local/include に、ドキュメントを /../usr/local/share にインストールします。configure にオプション --prefix=PATH を指定することで、/../usr/local 以外の代替インストールプレフィックスを指定できます。これは、デフォルトパスにインストールする権限がない場合、または代わりにシステムディレクトリにインストールする場合に役立ちます。

ImageMagick ディストリビューションのインストールが成功したことを確認するには、インストールディレクトリが実行可能ファイルの検索パスに含まれていることを確認し、次のように入力します

magick logo: logo.gif
identify logo.gif

ImageMagick のロゴが X11 ディスプレイに表示されます。

ImageMagick ビルド設定を確認するには、次のように入力します

magick identify -list configure

サポートされている画像形式を一覧表示するには、次のように入力します

magick identify -list format 

より包括的なテストを行うには、次のように入力して ImageMagick テストスイートを実行します

make check

Ghostscript は必須です。そうでない場合、EPS、PS、および PDF テストは失敗します。開発者の環境と自分の環境との違いにより、結果が正常であっても、いくつかのテストが失敗する可能性があることに注意してください。開発者の環境と自分の環境との違いには、コンパイラ、CPU タイプ、および使用されているライブラリバージョンが含まれる場合があります。 ImageMagick 開発者は、すべての依存ライブラリの現在のリリースを使用しています。

Linux 固有のビルド手順

ImageMagick.src.rpm を imagemagick.org またはその ミラー からダウンロードし、メッセージダイジェスト に対して配布を検証します。

次のコマンドで ImageMagick をビルドします

rpmbuild --rebuild ImageMagick.src.rpm

ビルド後、RPMS フォルダーを見つけて、ImageMagick バイナリ RPM ディストリビューションをインストールします

$ rpm -ivh ImageMagick-7.1.1-?.*.rpm

Mac OS X 固有のビルド手順

これらの手順を管理者として、またはsudoコマンドで実行します

MacPorts をインストールします。 MacPorts をダウンロードしてインストールし、次のコマンドを入力します

sudo port -v install freetype +bytecode
sudo port -v install librsvg
sudo port -v install graphviz +gs +wmf +jbig +jpeg2 +lcms 

これにより、ImageMagick が利用する JPEG や FreeType などの多くのデリゲートライブラリがインストールされます。

Apple から最新の Xcode をインストールします。

portコマンドを使用して、必要なデリゲートライブラリをインストールします。たとえば、

sudo port install jpeg 

それでは ImageMagick をビルドしましょう

ダウンロード ImageMagick ソース配布物を メッセージダイジェスト に対して検証します。

解凍して、トップレベルの ImageMagick ディレクトリに移動します

$ tar xvzf ImageMagick-7.1.1-38.tar.gz
$ cd ImageMagick-7.1.1-38

ImageMagick を設定します

./configure --prefix=/opt --with-quantum-depth=16 \
  --disable-dependency-tracking --with-x=yes \
  --x-includes=/usr/X11R6/include --x-libraries=/usr/X11R6/lib/ \
  --without-perl" 

ImageMagick をビルドします

make 

ImageMagick をインストールします

sudo make install 

インストールを確認するには、次のように入力します

/opt/local/bin/identify -list font 

ImageMagickが認識しているすべてのフォントを一覧表示するには。

ImageMagick GUIをテストするには、新しいシェルで次のように入力します。

display -display :0 

MinGW固有のビルド手順

デリゲートライブラリは自身でダウンロードしてインストールすることもできますが、多くのライブラリはGnuWin32ディストリビューションですでに利用可能です。JPEG、PNG、TIFFなど、必要なデリゲートライブラリをダウンロードしてインストールします。パッケージをインストールする際には、開発ヘッダーを指定してください。次に、次のように入力します。

$ tar jxvf ImageMagick-7.1.1-?.tar.bz2

$ cd ImageMagick-7.1.1-38

$ export CPPFLAGS="-Ic:/Progra~1/GnuWin32/include"

$ export LDFLAGS="-Lc:/Progra~1/GnuWin32/lib"

$ ./configure --without-perl

$ make

$ sudo make install

予期しない問題への対処

ImageMagickのダウンロード、設定、ビルド、インストールは意図したとおりに問題なく完了する可能性が高いですが、特定のシステムや環境では、1つ以上のステップが失敗する可能性があります。ここでは、発生する可能性のあるいくつかの問題と、ImageMagickの動作するリリースを確保するための修正措置について説明します。

ビルドの問題

ビルドで依存関係が不足しているというエラーが発生した場合（例：.deps/source.PLO）、configureコマンドラインに--disable-dependency-trackingを追加します。

一部のシステムでは、未解決のシンボルが原因でビルド時にリンクが失敗する可能性があります。configureコマンドラインにLDFLAGSを追加してみてください。

configure LDFLAGS='-L/usr/local/lib -R/usr/local/lib' 

動的リンカーのランタイムバインディング

一部のシステムでは、ImageMagickが共有ライブラリlibMagick.soを見つけられない場合があります。ライブラリパスを指定してldconfigを実行してみてください。

/sbin/ldconfig /usr/local/lib 

SolarisおよびLinuxシステムには、ImageMagickが依存しているライブラリを追跡するのに便利なlddコマンドがあります。

ldd `which convert` 

デリゲートライブラリ

場合によっては、以下の警告が表示されることがあります。

no decode delegate for this image format
no encode delegate for this image format 

この例外は、ImageMagickのビルド時に外部デリゲートライブラリまたはそのヘッダーが利用できなかったことを示しています。画像形式のサポートを追加するには、必要なデリゲートライブラリとそのヘッダーファイルをダウンロードしてインストールし、ImageMagickを再設定、再ビルド、再インストールします。例として、JPEG画像形式のサポートを追加してみましょう。最初に、JPEG RPMをインストールします。

yum install libjpeg libjpeg-devel 

次に、ImageMagickを再設定、再ビルド、再インストールします。ImageMagick内でJPEGが正しくサポートされていることを確認するには、次のコマンドを使用します。

magick identify -list format 

JPEGタグに関連付けられたrw-モードが表示されるはずです。このモードは、画像を読み書きでき、画像ファイルごとに1つの画像のみをサポートできることを意味します。

PerlMagick

PerlMagickがlibperl.aが見つかりませんのようなメッセージでリンクに失敗した場合は、--enable-sharedまたは--enable-shared --with-modulesオプションを指定してconfigureを再実行します。