ImageMagickの例 --
APIとスクリプティング
- 目次
-
ImageMagickの例の序文と目次
-
APIとその他のIM使用方法
- WindowsとDOS
- PHP
- シェルコマンドを使用するPHP
- PHP Imagick (PHP ImageMagick API)
- PerlMagick (Perl Magickスクリプト)
-
セキュリティの問題
-
より良いImageMagickシェル/PHPスクリプトのためのヒント
-
なぜ複数の「magick」コマンドを使用するのですか?
-
IMを高速化する(一般的に)
-
ソースからのImageMagickのコンパイル
APIとその他のIM使用方法
実際の画像処理用のAPI(アプリケーションプログラミングインターフェース)は、実際にはCLIコマンド(「magick
」(これはそれ自体が一種のシェルAPIを表します))を使用するよりも高速ではありません。 IMのすべての画像処理には、同じ「コア」ライブラリが使用されます。 したがって、画像の歪みなどの複雑なタスクを実行する場合、シェル「magick
」よりもAPIを使用しても、処理の全体的な「速度」にはほとんど違いがありません。 *では、なぜコマンドラインではなくAPIを使用するのでしょうか?*シェルは、常に多くの異なるコマンド(IMの「magick
」コマンドだけでなく、シェルにはいくつかの「組み込み」があります)を「フォーク」します。 これらのコマンドは、実行されるたびにロードおよび初期化される必要があります。 また、すべてのIMコマンドは、構成ファイルを再初期化し、コマンドライン引数を解析し、作業中の画像を再読み込みし、多くの場合、結果をディスクに保存する必要があります。 これらすべてに時間がかかるため、処理速度が低下します。 つまり、これらの追加の手順には時間と処理能力がかかるため、頻繁に実行する場合、APIは理にかなっています。 また、APIを使用すると、コマンドラインではできない他の操作を実行できます。- APIがすでに実行されている場合、セットアップ時間はほとんど、またはまったくかかりません。
- メモリに、任意の順序で処理できる多数の画像リストの配列を格納します。 たとえば、数百枚の画像を読み込み、読み込み時に32x32ピクセルのサムネイル画像として作成し、それらをmagickで1ペアずつ比較するプログラムがあります(100枚の画像で9,900回の比較)。 もう1つは、メモリ内の一般的な色で画像をソートすることです!
- 任意の順序で、多くの異なる画像処理スレッドを実行できます。 次の画像または手順で作業を開始する前に、1つの処理シーケンスを「完了」する必要はありません。 たとえば、ジグソーパズルを解くプログラムを想像してみてください!
- 画像から情報を取得し、その情報を複雑な方法で使用して、画像処理を何度も再初期化(構成と画像の再読み込み)することなく、画像処理を変更できます。 たとえば、画像のフレーミング要件を計算する前に、画像サイズを取得します。
- 画像をループして、各画像で非常に異なる処理を実行します。 たとえば、各フレームがわずかに異なる方法で歪められたアニメーションシーケンスを生成します。
- 画像データへの直接的かつ完全にランダムなアクセス。 たとえば、画像内の「顔」を探す。
- 中間画像の高速再読み込みのためにMPC画像保存を利用します。 スクリプトdivide_vertを参照してください。
- パイプライン(異なるステップに異なるマシンを使用することもあります!)を使用して並列処理を行い、プロセッサの使用率を向上させ、中間画像をディスクに保存することを回避します。 シーケンスの次の(場合によってはオプションの)ステップに画像をパイプするパイプライン化されたスクリプトの例については、enlarge_imageを参照してください。
- ループを使用して各画像を個別に処理してから、画像結果のストリームを最終的な「すべてをマージ」ステップにパイプします。 これに似たスクリプトがたくさんあります...そのようなスクリプトの1つについては、レイヤー化された画像のプログラムされた配置を参照してください。
WindowsとDOS
CLI APIを使用したWindowsおよびDOSスクリプトの使用例は、Windowsでの使用法に移動されました。PHP(「system()
」関数からのIMコマンド)
PHPユーザーは、ImageMagickを使用する3つの方法があります。- 「
imagick
」PECLインターフェース - 「
MagicWand
」インターフェース - 「system()」および「exec()」関数を使用して、CLIの「
magick
」コマンドを実行します。
シェルコマンドを使用するPHP
この手法を使用する際の具体的な情報の最良の情報源は、IMフォーラムユーザー* Bonzo*と彼のウェブサイトRubbleWebsです。 PHPは、コマンドラインとは異なる環境で、おそらく異なるユーザーとして「magick
」を実行することに注意してください。 そのため、コマンドラインで機能するものは、PHP Web駆動型スクリプトで機能させるために少し調整が必要になる場合があります。 以下は、リモートシステムで直接コマンドライン「シェル」アクセスできないと仮定して、ISPのコマンドラインIMインターフェースの初期テストに推奨される手順です。 つまり、実行のためにWebファイルをアップロードすることしかできません。 したがって、最初に行う必要があるのは、システムで「magick
」コマンドを見つけ、インストールされているバージョンと、PHPが実行されている環境を確認することです。 Linux Webサービスでは、このPHPスクリプトをISPのWebサーバーにアップロードしてアクセスします...
|
pwd
」は、PHPスクリプトが実行された現在のディレクトリを示します。 これは、PHPスクリプトが配置されているディレクトリである場合とそうでない場合があり、PHPスクリプトからそのディレクトリに書き込むことができない場合があります。 次の2つのコマンドは、「type
」を使用してデフォルトで提供されるコマンドPATHで「magick
」が使用可能かどうか、そして使用可能な場合はその場所を示します。 「locate
」コマンドは、サーバー(Linuxサーバーであると仮定)に存在するすべての「magick
」コマンドを見つけますが、ImageMagick以外の「magick
」コマンド、ファイル、およびディレクトリを見つける場合があります。 結果を解釈する必要があります。 次の3つのコマンドは、「magick
」がコマンドPATH上にあると仮定し、バージョン番号とIMがアクセスできると考えているフォントを報告するように要求します。 どのコマンドがどのフォントを報告するかは、インストールされているIMバージョンの古さに依存します。 エラーのみが表示される場合は、「magick
」がコマンドラインパス上にないため、ISPプロバイダーはWebサーバーの「PATH
」と「LD_LIBRARY_PATH
」を正しく初期化して、それを含めていません。 定義した内容については、「env
」コマンドの出力を参照してください。 この場合、その正確な場所を見つけて、次のPHPスクリプトのようなものを使用する必要があります。 これにより、スクリプトの移植性が低下します。これは、特定のISP用にハードコードされているためです。 たとえば、「magick
」コマンドが「/opt/php5extras/ImageMagick/bin
」にあるとすると、変数を設定してその場所を指定できます。 これは、異なるISPホストで使用されているPHPスクリプトのアプリケーション構成とインストールプロセスの一部としてよく行われます。
|
ldd
」ライブラリエラーが発生した場合、「LD_LIBRARY_PATH
」が間違っており、ISPはインストール中に確実にジョブに失敗しているため、エラーを報告し、Webサーバーの「LD_LIBRARY_PATH
」環境変数設定を修正するか、ImageMagickを再インストールする必要があります。 magickコマンドの場所を設定する代わりに、上部に次のような行を使用してPATH環境変数を調整することもできます。 ただし、この方法は、一般的なPHPシステム構成ではデフォルトで「拒否」されることがよくあります...
|
|
|
|
その基本的なスクリプトが機能したら、PHPテストスクリプトにリストされているフォントの1つを試すことができます(PHPサーバーに合わせて以下を変更してください)。 たとえば、この時点で利用可能だったSolarisサーバーでは、「
Utopia
」フォントセットが利用可能であることに気づいたので、そのフォントを使用してラベルを作成しようとしました...
|
シェルからPHPへの変換の例
ここでは、かなり典型的なImageMagickコマンドを示します...
|
|
追加の引用符に注意してください
通常、PHPのIMコマンドは追加の引用符(通常は二重引用符)で囲まれているため、この追加の引用符レベルの使用を考慮する必要があります。PHPが文字列を実行するとき... PHPは引用符、バックスラッシュ、変数の置換を行い、シェルは引数を分割し、独自の変数と引用符の置換を行います。また、存在する場合は「2>&1」タイプのファイル記述子のリダイレクトも行います。ImageMagickは引数配列を取得しますが、DOS(dos環境はメタ文字を処理しません)およびcoder:*.gif[50x50]などの引数(シェルがcoder:プレフィックスまたは[...]読み取り修飾子のため展開に失敗する)に対して、独自のファイル名メタ文字処理を行います。つまり、たくさんの引数解析です!これは、多くの引用符とバックスラッシュの処理が必要になることを意味します。注意と事前検討が必要です。少なくともプログラム実行関数に関するPHPマニュアルを読むことをお勧めします。これには、PHP exec()、system()、passthru()が含まれます。また、バックティック演算子も参照してください。特に重要なのは、何が返され(通常は最後の行のみ)、呼び出し元のクライアントに渡されるか(その他すべて)を理解することです。PHPのセキュリティ
覚えておいてください...On the net, the only users you can trust not to be potentially hostile are those who are *activally* hostile. -- Programming Perl - Camel Book, r3
- 引数内のバイナリ文字 - 一般的なクラッカーの手法
- 引数内の予期しないスペース、タブ、改行、復帰
- バックスラッシュ(ディレクトリ区切り文字)と「..」パス。また、Windowsではファイル名に「\」と「;」を使用します。
- 「~*?[]{}<>」を含むファイル展開メタ文字と、ImageMagickに固有の特別な「@」メタ文字。
- 「$#;」を含むその他のシェルメタ文字と、3つの引用符「'」、「"」、「`」
- 引数がImageMagickの期待と一致しません。「-list」を使用して、IMが特定のオプションに対してどのようなタイプの引数を理解しているかを確認してください。たとえば、ユーザー入力の「-gravity」オプションには、10種類の異なる設定しかありません。
- など...
ファイルシステムへの書き込み
上記で述べたように、上記の初期手順に従った場合、PHPは一般的にサーバー上で異なる、より制限の厳しいユーザーとして実行されることが確実にわかります。このため、通常はスクリプトを含むディレクトリ(または実際に実行されている場所)に書き込むことはできません。セキュリティ上の理由から、通常はそのディレクトリに書き込みたくありません!PHPにファイルを書き込ませる必要がある場合は、画像(またはデータ)を「/tmp」の一意のファイル名に保存し、とりわけ、正常終了時とエラー発生時の両方で後片付けを行ってください。適切にクリーンアップしないアプリケーションから残された一時ファイルでディスクがいっぱいになる速度は驚くほどです。保存されたファイル(画像)をWebサーバーから見えるようにする必要がある場合は、それらのファイル用に特別な「プログラムによる書き込み」サブディレクトリを作成します。どのように行うべきか。ほとんどのPHPアプリケーションは、データベースバックエンドを使用することで、ファイルシステムへの書き込みを実際に回避しています。つまり、Cookie、トークン、ユーザーデータ、画像などはすべて、(複雑さと規模の順に)SQLite、PostgresSQL、MySQL、Oracleなどのデータベースに書き込まれます。ファイルシステムには何も保存されません。システムプログラマーは通常、アプリケーションのインストール時にPHPアプリケーションをその情報で構成します。画像は通常、同じ、または画像「ブロブ」を検索してクライアントに出力する別のPHPスクリプトによって再現されます。画像はHTML自体に「インライン」画像として送信される場合があります(HTMLインライン画像のデモがある「inline:」形式を参照してください)、または単一の「オールインワン」複数画像として送信されるため、クライアントHTML/JAVAは20個の個別のリクエストではなく1つの画像リクエストのみを行います。最後のポイント。古いデータをクリーンアップする何らかの方法が常に存在する必要があります。2年間ログインしていないユーザーのデータは削除する必要があります。エラー出力の取得
次のいずれかの方法を試してください...
|
|
|
|
より安全なImageMagickコマンド...
セキュリティ上の理由から、シェルを使用して単一の長い文字列を個別の コマンドと引数に解析することは避けるのが理想的です。自分で行う方が良いでしょう!これは、コマンドへの引数を1つのシェル解析文字列としてではなく、個別の文字列の配列として提供することを意味します。これにより、シェル構文エラーの可能性、シェルに必要な追加の引用符の負担を防ぎ、ハッカーがシェルコマンドを破って独自のコマンドを実行する可能性を防ぎます(非常に悪いことです)。一方、シェルスクリプト、パイプ、ファイルリダイレクトは失われますが、PHPや他のラッパー言語をすでに使用している場合は、通常は大きな損失ではありません。PHPでは、シェルなしでコマンドを直接呼び出すことができる唯一の関数は、pcntl_exec()関数です。これは基本的にシェルを回避し、コマンドを直接呼び出します。ただし、これは真の「execl()」システムコールであり、現在のプロセスを指定されたコマンドに置き換えます。つまり、「fork()」とファイル記述子のリンクを行わず、サブプロセスとして実行するために必要です。そのため、pcntl_exec()は実際には一般的な使用には低レベルすぎ、「シェルなし」コマンドの実装はかなり複雑になる可能性があります。よりシンプルで安全な「シェルを回避する」コマンドコールがPHPインターフェースによってまだ提供されていないことに非常に驚いています。しかし、私はPHPプログラマーではありません。一方、Perlは、サブコマンドとプロセスを安全に呼び出すための多くの方法を提供しており、PHPよりもWebインターフェースとしてより好ましいものになります。*PHPセキュリティの知識を持つ人は、より多くの情報を啓発したり、ポインタを提供したりできますか?*PHP「IMagick」API
PHP PECL Imagickモジュールが実際に機能しているかどうかをテストするには、単純なテスト「image.jpg」画像とこのPHPスクリプトを同じWebアクセス可能なディレクトリにアップロードします。
|
PHP「MagickWand」
次を使用して、PHP MagickWandモジュールがPHPインストールの一部であるかどうかを確認できます...
|
|
複雑なPHPスクリプト...
HTMLとIMAGEの両方を作成および出力する必要がある場合は、個別のHTMLリクエストまたは入力オプションが、同じまたは異なるPHPスクリプトからWebドキュメントに必要なさまざまな部分を作成するように、PHPスクリプトを設計することを検討してください。つまり、トップレベルのPHPスクリプトは、適切な<IMG>タグを含むHTMLを出力でき、適切なオプションを使用して自身(または別のPHPスクリプト)を呼び出して、最初のトップレベルのPHPスクリプトに表示される画像を作成または変更できます。これは、多くのフォトアルバムとグラフ作成PHPスクリプトが行っていることです。すべて、URL呼び出しのGETおよびPATH_INFO拡張機能によって制御されます。IMGタグ内ではPOSTを使用できないことに注意してください。このようにすることで、PHPで生成されたWebページの一時画像を生成、保存、クリーンアップする必要がなくなります。リソースの制限やガベージコレクションなどの問題が山積しているソリューションであり、非常に悪いプログラミング手法です。この手法は、ImageMagickブックの両方で検討されていますが、実際に使用されているImageMagickは少し古くなっています。Perl Magickスクリプト
PerlMagick APIは、「magick
」コマンドを、データベース、多数の画像、あるいはその他の方法では不可能な、より複雑な画像処理も扱うことができるスクリプトに変換する優れた方法です。 最良のヘルプは、PerlMagickの「デモ」スクリプトを参照することです。これはソースにも含まれており、通常はPerlMagickのドキュメント領域にインストールされています。 私のシステムでは、「/usr/share/doc/ImageMagick-perl-*/demo/
」にありました。 このディレクトリには、さまざまな画像の読み取り、書き込み、処理に関する簡単な例が多数あります。 また、ほぼすべての一般的な画像処理オプションとその使用方法を一覧表示するスクリプト「demo.pl」も含まれています。 コマンドラインの「magick
」コマンドをPerlに変換する際には、いくつかの注意点があります。- 最初に覚えておくべきことは、PerlMagickは処理された新しい画像を自動的に削除しないことです。多くの演算子は古い画像から新しい変更された画像を作成しますが、他の演算子は既存の画像を直接変更します。
- また、多くの演算子は、画像のリスト全体に特定の操作を適用するのではなく、指定したリストの最初の画像にのみ適用します。 つまり、画像シーケンス(Perl配列)自体をループ処理する必要があります。
- 複数の画像シーケンスを持つことができます。 実際には、コマンドラインの場合のように単一の画像シーケンスで済ませるのではなく、通常はすべての画像をそれぞれ独自の画像シーケンスに読み込みます。
- また、画像がメモリに読み込まれたら、既存の画像のサイズを簡単に抽出できます。 つまり、コマンドラインで行うように、既存の画像を複製してクリアする必要なく、新しいキャンバスを作成できます。 ただし、画像の複製は画像のメタデータもコピーするため、デジタル写真などの画像のメタデータを追跡することをお勧めします。
- 特に画像の読み込み時には、主要な処理の後ごとに画像エラー(PerlMagickページに示されているとおり)を確認してください。
magick
」コマンドでの括弧の使用や余分な複製操作は通常問題になりません。 スクリプトの変換で最も難しい部分は、通常、コマンドラインオプションをPerlMagick関数呼び出しにマッピングすることです。私が発見した最速の方法は、IMのソースコードを取得し、「MagickWand/mogrify.c
」ファイルを見て、問題のある特定のコマンドラインオプションを検索することです。 たとえば、-threshold
オプションの場合は、引用符を含めて"threshold"
を検索します。 2つの一致があります。1つはすべてのオプションが見つかったことを確認するためのクイック構文解析用で、2つ目はそのオプションの実際の内部呼び出し用です。 ここで、使用されているライブラリ関数の名前が見つかります。これは通常、Perl関数に直接マッピングされます。 この場合... BilevelImageChannel()
セキュリティ警告
特に、世界中の誰もが実行できるWebベースのPHPスクリプトなど、公共の用途向けにスクリプトを作成する場合、未知の(または既知の)ユーザーから発信された可能性のあるすべての内容を確認することが非常に重要です。 そして、私はすべてを意味します。引数、ファイル名、URL、そして画像もです。 入力引数を確認するまでは、その引数には文字、数字、スペース、句読点、さらには「ヌル」文字や制御文字が含まれている可能性があります。 徹底的にチェックするまでは、疑わしいものとして扱われ、使用しないでください。 Webで制御された入力フォームを使用しているかどうかは関係ありません。 少し知識のある人なら、その入力フォームをまったく使用せずに、独自の引数を使用してPHPを簡単に呼び出すことができます。 彼らがそうしないと思うのは間違いです。ロボットはそこら中にいて、入力フォームを読み取り、独自の「ハッキングされた」引数を作成して、ランダムなスクリプトに侵入しようとしています。ファイル名に含まれるメタ文字
セキュリティ上の問題として、特に注意すべき点は、スペース、引用符、句読点、制御文字、またはその他のメタ文字を含むファイル名です。IMとシェルの両方がそれらを展開しようとする可能性があります。 問題は、「*?@${&) .jpg
」というファイルは、UNIXでは実際には完全に合法なファイル名ですが、そのプログラム(シェルとIMの両方など)がファイル名展開も行う場合、多くのプログラムはそれを処理するのに苦労します。 シェルが「glob」メタ文字展開を実行するのを防いでも、IM自体もこの展開を実行します(DOSの使用のため)。 そのため、そのような文字をすべて禁止する(そしてエラーを生成する)ことは、おそらく賢明なことです。 セキュリティ対策として、ファイル名に未知の文字や ungewöhnliche 文字、つまり文字、数字、または予想されるサフィックス以外の文字が含まれている場合は、エラーを発生させて中止することをお勧めします。 そのようなファイル名をシェルコマンドまたはIMに渡す前に。 許容的で何か悪いことを通すよりも、はるかに制限的で物事を防ぐ方が良いです。より優れたImageMagickシェル/PHPスクリプトのためのヒント
これらは、他のユーザーが使用するためにIMメーリングリストに送信された寄稿されたシェルスクリプトについて私が行った基本的なスクリプトプログラミングのポイントです。 これらを当初は個人的に作者(匿名のままです)に送信しましたが、彼は感謝していました。 これらはすべてIMに固有のものではありませんが、標準的なプログラミングプラクティスとして、とにかく適用する必要があります。 特に、他の誰かにプログラムまたはスクリプトを使用、参照、および/またはバグ修正してもらう予定がある場合はなおさらです。 これにより、スクリプトがより便利になります。- スクリプトとプログラムの先頭に「help」または「doc」を配置します。 これにより、他の人がスクリプトをインストールまたは実行することなく、特定のプログラムの機能を理解しやすくなります。 私自身は、そのような未知のスクリプトをコンパイルまたは実行しようとするのではなく、それが何のためにあるのかについての明確なコメントがないプログラムをしばしば破棄します。 実際、最初のREADMEファイルでさえ、巨大で複雑なプロジェクトが何をするのかさえ書かれていない巨大なプロジェクトを見たことがあります! プログラマーは、ダウンロードしたということは、それが何をするのか知っているはずだと考えているだけです! また、「-?」などの「不正なオプション」は、オプションの概要だけでなく、プログラムの機能の簡単な要約、またはそのようなヘルプを見つける場所を出力するようにしてください。 リモートWebサイトを指すだけではいけません。10年後には消えてしまうかもしれません! スクリプトが独自の「オープニングコメント」を出力する例については、IM scriptsエリアの「jigsaw」スクリプトを参照してください。 Perlは自己文書化にPODを使用できます(Perlの「
Pod::Usage
」モジュールを参照)。 たとえば、寄稿されたdpx_timecode.plスクリプトを参照してください。最初のサブルーチンに「ヒアドキュメント」としてヘルプを用意することも許容され、ほとんどの言語で機能します。 ただし、そのサブルーチンはスクリプトまたはプログラムの下部または中央ではなく、上部に配置してください。 - コードをクリーンアップし、古い不要なコードとコメントを削除して、できるだけきれいに整理してください。 簡潔で、簡単なコメント付きのステージにしてください(可能な場合)。 再び「jigsaw」スクリプトを参照してください。
- 最後に一時ファイルがクリーンアップされていることを確認してください。 ファイルの終了または中断時にそれらを削除するには、「trap」シェルコマンドを使用します。 もちろん、単一の一時ファイルを複数回再利用できるため、特にIM v6 magickコマンドでは、それほど多くは必要ありません。 再び「jigsaw」スクリプトを参照し、「trap」を検索してください。
- また、誰もがシステムXを使用しているわけではありませんが、あなたにはそう見えるかもしれません。 特定のシステム要件、または問題の修正方法については言及しないでください。 あなたに有効なことが、彼らのシステムと設定にはまったく不適切かもしれません。 彼らはインターネットアクセスを持っていないかもしれません! ImageMagickの「
magick
」コマンドが見つからなかったと言うだけです。 インストール要件または提案を追加する場合は、別のより広範なドキュメントの一部として追加してください。 - 使用されているIMのバージョンが十分に高いかどうかを確認するか、下位互換性のある変更を追加してください。 この目的のために、さまざまな特別な機能が追加された時期について、IMの例全体で意図的に「バージョンの警告」ノートを提供しています。 これにより、単一の最小限のバージョンチェックでスクリプトを作成するのが容易になります。 シェルスクリプトでテスト目的で単一のバージョン番号を取得する簡単な方法を次に示します。 4つのバージョン番号を抽出し、各番号を2桁にするために適切な数のゼロを挿入して、単純な8桁の番号を生成します。
IM_VERSION=`magick -list configure | \ sed '/^LIB_VERSION_NUMBER /!d; s//,/; s/,/,0/g; s/,0*\([0-9][0-9]\)/\1/g'`
06030510
」を生成しますが、次のリリースであるIM v6.3.6.0は「06030600
」を生成します。 上記のPHPバージョンは、RubbleWeb、フォントリストのサンプルページから入手できます。 結果の文字列は、単純な数値テストまたは文字列テストを使用してテストして、使用可能なImageMagickバージョンがスクリプトの目的のために十分に最新かどうかを調べることができます。 例えば...if [ "$IM_VERSION" -lt '06030600' ]; then echo >&2 "The perspective distortion operator is not available." echo >&2 "Sorry your installed ImageMagick is too old -- ABORTING" exit 10 fi
-list
」設定「type
」は「既知のフォント」リストを返しました。 以降のバージョンでは、代わりに「font
」設定を使用する必要があります。 そこで、ここではバージョンチェックを実行して、適切な設定を使用して必要な情報を取得できます。if [ "$IM_VERSION" -lt '06030507' ]; then font_list="type"; else font_list="font"; fi avail_fonts=`magick -list $font_list | cut -d\ -f1 |\ egrep -v '^($|----|Path:|Name$)'`
[
」テストの代わりに「expr
」を使用することです...if expr + "$im_version" \>= "06030507" >/dev/null; then ...
+
」は、少なくともこのテストには通常は必要ありませんが、変数に特別なキーワード「match
」が含まれている可能性がある場合に必要です。これは「expr
」に問題を引き起こします。特に文字列または部分文字列の作業に使用されている場合。 - また、「
-list
」情報の出力を使用して、現在インストールされているImageMagickに特別な機能が追加されているかどうかを確認することもできます。magick -list distort | grep 'Arc' >/dev/null 2>&1 if [ "$?" -ne 0 ]; then echo >&2 "Arc distortion method not available." echo >&2 "Sorry your installed ImageMagick is too old -- ABORTING" exit 10 fi
-distort Arc
」などの新しいメソッドは、一般的に使用できるようになる前に、IMの開発中に表示される場合があることに注意してください。 そのため、バージョンチェックの方が良い考えかもしれません。 このため、IMの例では、新しい機能が一般的に使用できるほど安定したIMバージョンをメモするようにしています(記号を探してください)。
- 非常に長い一行は使用しないでください。特に複雑な 'convert' コマンドの場合には。上記で示したように、UNIX では '
\
'、DOS では '^
'、PHP では '.
' 文字列連結などの行継続方法を使用して分割してください。しかし、すべて設定や操作を別々の行に配置するという意味ではありません。1行につき1つの主要な操作または段階を実行し、新しい画像を作成し、画像を変更し、他の画像と結合するなどしてください。特定の演算子に必要なすべての操作設定を、その演算子の直前に配置します。各行を単一の処理ステップと考えてください。これにより、行を分離して、個々の処理ステップを読みやすく理解しやすくなります。演算子の分離が明確であるほど、複雑な画像処理を理解しやすくなります。追加の括弧を使用したり、さまざまな段階でインデントを付けたり、大きな処理ブロックの間に空行を追加したりすることで、大規模で長い操作の主要な段階をさらに見やすくすることができます。IM の例では、例を理解しやすくするために、これらの手法を至るところで使用しているので、参考にしてください。最後に、特定のコマンドが何をしているかについての追加のコメントは、他の誰か(あるいは2か月後のあなた自身でさえ)がスクリプトを読み理解する上で大きな違いを生むことがあります。長いコマンドラインにコメントを挿入できないのは残念です! - あまり多くの外部プログラムに依存しないようにするか、利用可能な場合にのみ使用してください(可能な代替手段を用意してください)。他の人は、そのプログラムを持っていないか、他のものを使用することを好むでしょう。プログラムの使用がオプションの場合は、ユーザー制御下または見つかった場合は自動的に使用されるように、オプションにしてください。可能な限り、強制的な要件にしないでください。たとえば、 "
pngcrush
"、"optipng
"、"pngnq
" を使用して、IM が通常提供するよりも PNG を圧縮することができます(IM は特定ではなく汎用性を重視して設計されています)。また、GIF アニメーション用の LZW 圧縮オプティマイザである "gifsicle
"、"intergif
" などにも、長所と短所があります。スクリプトの動作に絶対必要な要件にしないでください。実際的な例として、古いバージョンの "gif2anim" は、ImageMagick の "magick identify
" を使用して GIF 固有のメタデータを参照するのではなく、パッチが適用されたバージョンの "giftrans
" に依存していました。この要件は、ImageMagick の "magick identify
" の改善により後で必要なくなったため、スクリプトの使い勝手を良くするために削除しました。ImageMagick 自体には、PostScript および PDF ドキュメントの読み取り用の "ghostscript
" や、SVG ベクトル画像の正しい処理用の "librsvg
" など、多くのオプションの要件があります。IM は、利用可能な場合は問題なく動作します。IM はこれらのライブラリをオプションとして扱い、これらの形式の画像を処理する場合にのみ必要となります。スクリプトの依存関係を確認するために使用できるコードスニペットを次に示します(特に最小限の cygwin 環境で役立ちます)...# Check Dependencies to scripts correct working DEPENDENCIES="sed awk grep tr bc magick identify" # adjust to suit for i in $DEPENDENCIES; do type $i >/dev/null 2>&1 || Usage "Required program dependency \"$i\" missing" done
- 最後のポイントをさらに進めます。IM を使用しているシェルスクリプトで浮動小数点演算が必要な場合は、'
awk
' や 'bc
' などの他のプログラムに頼るのではなく、IM 自体を使用してその演算を実行できます。これらのプログラムは利用できない場合があります(特に Windows 上の cygwin の場合)。たとえば、ここでは 'magick
' を使用して、度で指定された特定の角度の sin() を計算します...angle=-20 sine=`magick xc: -format "%[fx:sin( $angle *pi/180)]" info:` echo $sine
-0.34202
' の値を出力します。精度操作制御を使用して、小数点以下の桁数を調整できます。デフォルトでは6桁に設定されています。 - ユーザーが使用する入出力画像形式を決定できるようにします。ImageMagick は、主に画像コンバーターであり、さまざまな形式を使用できます。画面、PostScript、プリンターに出力したり、画像を別のコマンドにパイプしてさらに処理したりできます。ユーザーを特定の形式に限定しないでください。たとえば、"jigsaw" スクリプトと "gif_anim_montage" スクリプトでは、ユーザーが任意の入力または出力画像を指定できます。このようにして、ユーザーは画像をスクリプトにパイプインまたはパイプアウトして、他のプログラムやスクリプトを使用してさらに処理できます。たとえば、私はよく次のようなコマンドを使用します...
gif_anim_montage animation.miff show:
URL:
" または "HTTP:
" 入力形式を使用して World Wide Web から読み取ることができます。セキュリティ上の懸念(Web 使用など)がない限り、これらの可能性を制限しないでください。 - 入力画像の読み取りと複数画像の出力は、一度だけ行ってください。ユーザーがパイプラインファイル名または URL を提供した場合、それらの画像を複数回読み取ろうとしないでください。問題が発生する可能性があります。その画像を複数回参照する必要がある場合は、一時ファイル、複製された画像、または "
MPC:
" を使用して入力画像のコピーを保存してください。パイプラインからの複数の画像を処理できる場合は、さらに優れています。プログラムの引数が示唆するものとは異なる順序で、または複数回入力画像を処理する必要がある場合に、入力画像を一時ファイルに保存する例については、"jigsaw" スクリプトを再び参照してください。
なぜ複数の "magick" コマンドを使用するのですか?
- Willem on Wed, 25 Oct 2006 wrote...
- 疑問に思っているのですが、あなたの例では、目的の結果を得るために Convert を複数回呼び出しているのを見ることがあります。一般的に、magick を複数回呼び出す必要はないはずです。1回の呼び出しで全てが可能になるはずです(ただし、コマンドはより複雑になります)。この声明に同意しますか?
magick /tmp/image1.png ..operations.. /tmp/image1.png |
IM の高速化(一般的に)
IM の動作を高速化するには、多くの方法があります。注意すべき最も重要な側面を次に示します。リストを下に進むにつれて、高速化は小さくなるか、IM インストールのより複雑な変更が必要になります。- IM Q8(またはカラー値あたり 8 ビット、ピクセルあたり 3 ~ 4 バイト)は、より高いカラー解像度を持つ IM Q16 デフォルトよりもはるかに高速です(3 ~ 4 倍高速)。画像に Q16 が 필요하지 않은 경우、IM を Q8 バージョンに置き換える必要があります。ただし、8 ビットの内部品質のみを使用すると、中間画像の情報が失われるため、画像処理全体に影響を与える可能性があることに注意してください。この反対については、HDRI を参照してください。
- 可能な限り、単一の画像に必要なすべての処理を1つの"
magick
"コマンドで行ってください。 これにより、初期化、一時ファイルの作成、コマンド間のパイプライン、さらにはパイプラインやディスクI/Oのための画像ファイル形式へのエンコード/デコードが節約されます。 もちろん、画像サイズ、色、あるいはオプションの処理手順などを含む計算など、オプションの画像処理手順を可能にするために、複数のコマンドを使用する必要がある場合もあります。 IMv7スクリプトはこの点で役立ちます。 - シェルスクリプトは本質的に遅いです。 解釈され、複数の手順とディスクへの追加のファイル処理が必要です。 もちろん、これは新しいIM v6オプション処理のおかげで改善されており、1つのコマンドで多数の画像処理操作を実行できます。 それでも、単一の"
magick
"コマンドですべてを実行できることは稀であるため、多くの場合、目的を達成するために複数のコマンドを使用する必要があります。 そのため、perl、ruby、またはPHP magickモジュールのようなAPIは、シェルとIMコマンドラインAPIの両方のすべての解釈部分を削除するため、高速です。 また、IMがフォントと色の定義を読み込む際の初期化手順も削減します。 - APIはまた、プログラムの存続期間中、すべての画像、あるいは複数の画像リストを保持することもできます(十分なメモリがある限り)。 つまり、コマンドラインで行うように画像をシャッフルしたり、ジャグリングしたりすることなく、作業中の画像を自由に切り替えたり、変更したりできます。 これは、以前の画像処理手順に基づいて追加の計算を行う必要がある場合に特に便利です。
- GIF画像ファイル形式の書き込みは遅いです。 IMは、画像の色をファイル形式の限られた色に収まるように減らす(量子化する)ために、懸命に作業する必要があります。 それでも、特にGIFアニメーションでは、正しく処理するために追加の作業が必要になることがよくあります。 PNGとJPEGは高速ですが、PNGはサイズが大きくなり、JPEGは品質が低下します。 ただし、実際にはGIF画像は品質の面で最悪です!
- 背景、オーバーレイ、フレーム、マスクなどの画像を事前に準備してキャッシュしたり、カラー検索テーブル、歪みマップ、テンプレート、マスクなどを事前に生成したりします。 これらのすべてが処理時間に大きな違いをもたらす可能性があります。 事前に何ができるかを考えてください。 事前に生成された画像の大きなライブラリは、必要に応じて画像を作成しようとするよりもはるかに高速です。 中間およびキャッシュされた画像には「MPC:」の使用も参照してください。 これらはディスク上のメモリマップされた画像であり、基本的に読み取り時間はゼロですが、他の用途や他のマシンでは役に立ちません。 これらは、主要な画像処理プロセスの開始時にのみ作成する必要があり、最小限のソフトウェアまたはシステムのアップグレードによって無効になり、おそらくセグメンテーション違反が発生するため、長期間保存しないでください。
- アルファ合成、またはより単純な評価、単純な数学演算、または他の手法を使用できる場合は、FX、特殊効果画像演算子の使用を避けてください。 これらを使用する必要がある場合は、できるだけ小さい画像、または画像の単一のチャネル(グレースケールを処理する場合)にその使用を制限してみてください。
- いくつかの小さなぼかしの方が速い場合は、大きなサイズの画像ぼかしの使用を避けてください。 どちらが速いかを確認するために、いくつかのタイミングテストを行ってください。 同じことが、ガウス演算子やシャドウ演算子などの他のモルフォロジーおよび畳み込み演算子にも当てはまります。
- 小さな領域の複雑な処理には、小さなサブ画像または領域を使用します。 たとえば、マスクと再着色を行う前に、人の目を(領域を使用して)見つけて抽出すると、画像の完全な大きなバージョンを処理するよりも速度が大幅に向上する可能性があります。 差が大きいほど、節約量も大きくなります。
- 大きな画像、または多数の画像を読み取る場合は、読み取り修飾子を使用して、各画像の読み取り直後にサイズ変更またはトリミングを行う方が、全体的なメモリ要件を削減できます。 JPEGの場合、特別な '
jpeg:size
' ライブラリモディファイアを使用して、メモリの割り当てを回避することもできます。 これにより、「ディスクスラッシング」(コンピューターの速度が非常に遅くなる)を防ぎます。 特に、モンタージュディレクトリインデックスやその他の複数画像のコラージュを生成する場合など、多数の大きな画像が関係する場合に有効です。 - ディスクから処理する必要がある非常に巨大な画像の場合、それらを小さなチャンクで処理する方が良い場合があります。
- 大きな画像の場合も同様です... Windows 64ビットOSを使用している場合は、64ビットImageMagickディストリビューションを使用してください。 より大きなアドレス空間を使用し、32ビットWindowsよりも大きな画像をメモリに収めることができます。
- IMはデフォルトで、個々の画像処理操作にマルチスレッドを使用します。 つまり、「コア」が2つ以上あるコンピューターは、一般に単一CPUマシンよりも高速に画像を処理します。 大きな画像の場合、OpenMPマルチスレッド機能は、個々の画像処理操作を完了するためにより多くのCPUを使用するため、明確な速度上の利点をもたらす可能性があります。 IM内では、並列化されるのは個々の画像処理操作のみであることに注意してください。 したがって、節約は、多数の画像を処理する場合ではなく、大きな画像処理で行う方が多くなります(次を参照)。
- 小さな画像の場合、IMマルチスレッド機能を使用しても大きな利点はありません。 この場合、異なる画像で複数の変換を同時に実行すると、スループットが向上する可能性があります。 これは、複数のPHP Webリクエストが複数の画像「magick」コマンドを起動できる状況でも発生する可能性があります。 これらのいずれの状況でも、CPUの競合によりマルチスレッドを有効にすると非常に有害になる可能性があり、'
MAGICK_THREAD_LIMIT
' 環境変数を '1
' に設定してOpenMPを無効にする方が良いでしょう。 IMフォーラムディスカッションスレッド化は「変換」を遅くするを参照してください。 また、ImageMagickがより適切な時点でCPUの制御をより頻繁に放棄するように、MAGICK_THROTTLE
を確認することもできます。 - 画像に多数の小さな操作(描画など)を実行する場合は、色の名前を使用しないでください。 IMが(かなり大きい)カラーネームテーブルを読み込まないようにするために、「
#00AA99
」などのハッシュカラー、または「rgb(0,160,100)
」などのrgb番号を使用して色を指定してください! また、システムの「フォント」リスト定義ファイル(「type.xml
」から)を削除または削減することもできます。 あるいは、これらのファイルを完全に削除し、代わりにファイル名でフォントを直接指定します。 基本的に、IMが必要に応じて特定の画像プロセス用に読み取って初期化する追加の構成情報の読み込みを削減します。 したがって、それらを使用しないか、構成ファイルのサイズと影響を減らしてください。 - ImageMagickを共有ライブラリ(デフォルト)としてビルドすると、ロード時間を大幅に短縮できます。 ライブラリとコーダーモジュールは必要に応じてのみロードされるため、IMの動的バージョンは、画像処理中に使用する必要のないものはロードしません。 また、共有ライブラリは使用可能なままになる傾向があるため、2回目の実行のためにリロードする必要がない場合があります。
- Apacheモジュールの一部としてImageMagickを呼び出すと、起動時間も短縮されます。 パーツは一度ロードされて複数回使用できるようになるため、何度もリロードする必要がなくなります。 これは、将来、永続的に実行される「デーモン」IMプロセスでより実用的になる可能性があります。
ソースからのImageMagickのコンパイル
SRPMからのLinux用ImageMagick RPMのビルド
RPMをインストールするにはrootが必要ですが、RPMを実際にビルドするにはrootは必要ありません。 私はこれを*Fedora Linux Systems*にIMを生成してインストールするために使用しますが、*CentOS 5.4 (Enterprise Redhat) Linux Systems* でも動作することが報告されています(より具体的なCentOSのIMに関する注意事項を参照)。 まず、LinuxソースRPMから最新のソースRPMリリースを入手してください。 まず、マシンに必要なすべてのコンパイラとツールが揃っていることを確認してください。
|
![]() ![]() |
"sudo "は、許可されている場合はrootとしてコマンドを実行するプログラムです。そうでない場合は、rootシェルを使用して、上記から"sudo "の部分を削除してください。 |
|
|
- また、これらのパッケージとその依存関係(jpegやpng開発ライブラリなど)もインストールされていることを確認する必要があります
-
freetype-devel ghostscript-devel libwmf-devel jasper-devel lcms-devel bzip2-devel librsvg2 librsvg2-devel liblpr-1 liblqr-1-devel libtool-ltdl-devel autotrace-devel
- 「ImageMagickの例」の一部の例では、これらのオプションのパッケージとライブラリによって提供されるプログラムを使用する場合もありますが、これらはビルドプロセスには必要ありません。
-
gnuplot autotrace
liblqr
」モジュールは、Liquid Rescale Operatorを有効にするために必要です。 SRPMをビルドする既存のTARまたはSVNダウンロードから、バイナリRPMをビルドするSRPM(ソースRPM)パッケージをダウンロードします。 または、次を使用して...からSRPMをビルドします。
|
|
rpmbuild
」というサブディレクトリが作成され、その中にSRPMソースが抽出され、IMのコンパイル済みパッケージRPMバージョンがビルドされます。![]() ![]() |
FedoraとRedhatの古いバージョンでは、これは通常rootのみに制限されている「/usr/src 」で行われていました。 ただし、このディレクトリを所有または書き込み可能にすることができるため、ビルドのために完全なrootアクセスを必要とせずに実行できます。 |
|
|
sudo
」コマンドに関する注意事項を参照)。
|
--nodeps
」は、Linuxシステムに存在する unusual な依存関係のために、通常必要です。 既存のインストールをアップグレードするには、通常、(rootとして)これを実行します。
|
後でIMを削除するには、パッケージを削除するだけです(これもroot権限が必要です)。
|
システムからIMの痕跡を完全に消去したい場合があります。そのためには、まず上記のコマンドを使用してシステムから実際のパッケージを削除します(下記はバリエーションです)。次に、以下の削除コマンドを実行します。注意:これについては保証できません。実行前にコマンドを徹底的に確認し、削除すべきでないものを削除しないようにしてください。何か不足している場合、または削除すべきでないものを削除した場合は、更新できるようにお知らせください。
|
yum upgrade
」コマンドを使用することで行います。お楽しみください。UbuntuでのソースからのImageMagick
ImageMagickをビルドするためのすべての開発ライブラリを取得するには、以下を使用します。
|
MacOSXでのコンパイル
MacOSXにImageMagickをインストールする最も簡単な方法は、MacPortsを使用することです。しかし、以下はMacOSX用にコンパイルするための情報のポインタです。私はそれを使ったことがないので、それがうまくいくか、役に立つかどうかはわかりません。しかし、FinkまたはMacPortsなしでImageMagickをインストールするとSnow LeopardにImageMagickをインストールするを参照してください。上記はIMユーザーフォーラムでの議論から抜粋したものです。IMのHDRIバージョンのコンパイル
HDRIバージョンのIMをコンパイルする方法については、IMのメインウェブサイトのImageMagickでHDRIを有効にするを参照してください。また、WindowsおよびUbuntu Linux固有の情報については、ユーザーフォーラムのフーリエ変換発表に関する議論を参照してください。個人用ImageMagickの作成
画像処理を行うマシンにスーパーユーザーアクセス権を持つことができるとは限りません。また、アクセス権を持つ人は、ImageMagickのインストールを更新したくないことがよくあります。おそらくパッケージ管理の問題、または互換性の問題のためです。コマンドラインアクセス(たとえばSSH経由)があれば、すべてが失われるわけではありません。個人用のImageMagickをインストールして使用できます。悪いニュースは、システム管理者にコンパイラと開発パッケージをインストールしてもらう必要があることです(上記を参照)。ただし、これらはすでに存在していることが多いため、常に問題になるとは限りません。まず、IMのバージョンをインストールするサブディレクトリを決定します。専用のディレクトリは、インストールを削除するためにそのディレクトリ全体を削除するだけで済むため、最適な選択肢です。私の場合は、ホームディレクトリの "apps/im" サブディレクトリにインストールします。
|
|
--prefix
」と共に使用される「--disable-installed
」です。他の部分は、個人用バージョンのImageMagickのオプションの側面のコンパイルを無効にします。必要に応じて変更してください。通常のシステムバージョンではなく、独自のインストールバージョンを使用するには、次の環境変数を設定するだけです。
|
|
--disable-installed
」オプションで作成されたImageMagickでは、変数「$MAGICK_HOME
」を設定する必要があります。他の2つの環境変数は、インストールされている可能性のあるシステムバージョンではなく、個人用バージョンを使用することを保証します。警告:上記の変数を混在させないでください。すべてを定義するか、この方法で定義しないでください。使用するIM実行ファイルは、それらの実行ファイルでビルドされたのと同じライブラリ、コーダー、および設定ファイルを使用する必要があります。システムバージョンと個人用バージョンを混在させると、セグメンテーション違反やメモリフォールトが発生する可能性があります。
再コンパイルせずに個人用IMの場所を移動できますが、上記の環境変数を変更するだけでなく、「
delegate.xml
」ファイルの個人用インストールバージョンの「show:
」デリゲートで使用される「magick display
」プログラムへのハードコードされたパスも変更(または削除)する必要があります。このIMの側面の詳細については、デリゲートを参照してください。システムインストールバージョンと複数の個人用バージョンのIMを簡単に切り替えられるように、通常は上記の変数をまったく設定しません。代わりに、特定のバージョンのIMを呼び出す前にこれらの変数を設定するスクリプトを呼び出します。たとえば、HDRIでコンパイルされた個人用バージョンのIMがあり、これはImageMagickの例で特定の例にのみ使用します。通常はこのバージョンを使用せず、ほとんどの画像処理にはHDRI以外のシステムインストールバージョンを使用することを好みます。そのため、個人用領域「
$HOME/apps/im_hdri
」にIMの「HDRI」バージョンをインストールし、「hdri
」というスクリプトを作成しました。内容は次のとおりです。
|
hdri
」を付けない場合、通常のシステムバージョンのIMが実行されます。警告:スクリプトで個人用バージョンのIMが見つからない場合、システムバージョンを使用するようにサイレントに切り替わります。上記の「バージョン」チェックは、システムバージョンではなく、実際に個人用バージョンを使用していることを確認するための重要なテストです。「which」を使用して、スクリプトが実行しようとしているmagickコマンドを正確に確認することもできます。
|
magick
」を実行する必要はなく、ImageMagickシェルスクリプトなどの任意のコマンドを実行できるほど柔軟性があるため、そのスクリプトは通常のシステム変換ではなくHDRI magickを使用します。
|