39.17.5 ImageMagickイメージ

ImageMagickのサポートつきのEmacsビルドでは、多くくのイメージフォーマットをロードするためにImageMagickライブラリーを使用できます(File Conveniences in The GNU Emacs Manualを参照)。ImageMagickを通じてロードしたイメージのイメージタイプシンボルは、基礎となる実際のイメージフォーマットとは無関係にimagemagickになります。

ImageMagickサポートをチェックするには以下を使用してください:

(image-type-available-p 'imagemagick)

Function: imagemagick-types

この関数はカレントのImageMagickインストールによりサポートされるイメージファイル拡張子のリストをリターンする。リストの各要素は.bmpイメージはBMPのような、イメージタイプにたいして内部的なImageMagick名を表すシンボル。

User Option: imagemagick-enabled-types

この変数の値はEmacsがImageMagickを使用してレンダリングを試みるかもしれないImageMagickイメージタイプのリスト。リストの各要素はimagemagick-typesがリターンするリスト内のシンボルのいずれか、または等価な文字列。もしくは値tはImageMagickにたいして利用できるすべてのイメージタイプを有効にする。この変数の値とは関係なくimagemagick-types-inhibit (以下参照)が優先される。

User Option: imagemagick-types-inhibit

この変数の値はimagemagick-enabled-typesの値とは無関係に、ImageMagickを使用して決してレンダリングされることのないImageMagickイメージタイプのリスト。値tはImageMagickを完全に無効にする。

Variable: image-format-suffixes

この変数はイメージタイプをファイル名拡張子にマッピングするalist。EmacsはImageMagickライブラリーにイメージのタイプに関するヒントを与えるために、この変数と:formatイメージプロパティ(以下参照)を組み合わせて使用する。各要素は(type extension)という形式をもちtypeはイメージのcontent-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を使用できないことを意味する。

クロッピングはスケーリング後、ローテーション前に行われる。