GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/elisp/ImageMagick-Images.html ・ emacs-doc.conao3.com

42.17.5 ImageMagick 画像

EmacsのビルドでImageMagickがサポートされている場合は、ImageMagickライブラリを使用して多くの画像形式を読み込むことができます(The GNU Emacs ManualのFile Conveniencesを参照してください)。ImageMagick経由で読み込まれた画像の画像タイプシンボルは、実際の基盤となる画像形式に関わらずimagemagickとなります。

ImageMagickのサポートを確認するには、以下を使用してください。

(image-type-available-p 'imagemagick)
関数: imagemagick-types

この関数は、現在の ImageMagick インストールでサポートされている画像ファイル拡張子の一覧を返します。一覧の各要素は、.bmp 画像に対する BMP のように、画像タイプを表す ImageMagick 内部名を示すシンボルです。

ユーザーオプション: imagemagick-enabled-types

この変数の値は、EmacsがImageMagickを用いてレンダリングを試みる可能性のあるImageMagick画像タイプのリストです。リストの各要素は、imagemagick-types が返すリストに含まれるシンボルのいずれか、またはそれに相当する文字列である必要があります。あるいは、t を指定すると、考えられるすべての画像タイプでImageMagickが有効になります。この変数の値にかかわらず、imagemagick-types-inhibit(後述)が優先されます。

ユーザーオプション: imagemagick-types-inhibit

この変数の値には、imagemagick-enabled-typesの値にかかわらず、ImageMagickでレンダリングしてはならないImageMagickの画像タイプが列挙されています。tを指定すると、ImageMagickが完全に無効になります。

変数: image-format-suffixes

この変数は、画像タイプをファイル名拡張子にマッピングするalistです。Emacsはこれを:format画像プロパティ(後述)と組み合わせて使用し、ImageMagickライブラリに画像のタイプに関するヒントを与えます。各要素は(type extension)という形式をしており、typeは画像のコンテンツタイプを指定するシンボル、extensionは対応するファイル名拡張子を指定する文字列です。

ImageMagick で読み込まれた画像は、以下の追加の画像記述子プロパティをサポートしています。

:background background

background が nil 以外の場合、色を指定する文字列である必要があり、画像が透過に対応している場合はその色が画像の背景色として使用されます。値が nil の場合は、フレームの背景色がデフォルトとなります。

:format type

値 type には、image-format-suffixes と同様に、画像データの形式を指定するシンボルを記述します。これは、画像に関連付けられたファイル名がない場合に、ImageMagick が画像形式を検出するためのヒントとして利用されます。

:crop geometry

geometry の値は、(width height x y) 形式のリストである必要があります。width と height は、切り抜き画像の幅と高さを指定します。x が正の数の場合は元画像の左からの切り抜き領域のオフセットを、負の数の場合は右からのオフセットを指定します。y が正の数の場合は元画像の上端からのオフセットを、負の数の場合は下端からのオフセットを指定します。x または y が nil であるか、あるいは未指定の場合、切り抜き領域は元画像の中央に配置されます。

クロップ領域が画像の外にあるか、または画像の端と重なっている場合は、画像外の領域を除外するように縮小されます。つまり、大きな width や height の値を入力して画像サイズを拡大するために :crop を使用することはできません。

クロッピングは、スケーリングの後、回転の前に行われます。