Next: XBM Images, Previous: Image Formats, Up: Images [Contents][Index]
イメージディスクリプタ(image
descriptor)とは、イメージにたいする基礎的なデータと表示する方法を指定するリストです。これは通常はオーバーレイプロパティかテキストプロパティdisplay
(Other Display Specsを参照)の値を通じて使用されますが、バッファーにイメージを挿入する便利なヘルパー関数についてはShowing Imagesを参照してください。
イメージディスクリプタはそれぞれ(image
.
props)
という形式をもちます。ここでpropsはキーワードシンボルと値のペアーからなるプロパティリストであり、少なくともそのイメージタイプを指定するペアー:type
type
を含みます。
以下はすべてのイメージタイプにたいして意味のあるプロパティのリストです(以降のサブセクションで説明するように特定のイメージタイプにたいしてのみ意味があるプロパティも存在する):
:type type
イメージタイプ。 Image Formatsを参照のこと。 すべてのイメージディスクリプタは。このプロパティを含まなければならない。
:file file
これはファイルfileからイメージをロードすることを意味する。fileが絶対ファイル名でなければ、それはdata-directory
のimagesサブディレクトリーから相対的に展開される。これに失敗するとx-bitmap-file-path
にリストされたディレクトリーから相対的に展開される(Face Attributesを参照)。
:data data
これはrawイメージデータを指定する。すべてのイメージディスクリプタは:data
か:file
のいずれかをもたなければならないが両方もつことはできない。
ほとんどのイメージタイプにたいして、:data
プロパティの値はイメージデータを含む文字列であること。いくつかのイメージタイプは:data
をサポートしない。それ以外のイメージタイプにたいしては:data
単独では不十分であり、:data
とともに他のイメージプロパティを使用する必要がある。詳細は以下のサブセクションを参照のこと。
:margin margin
これはイメージ周囲に余分なマージンとして何ピクセル追加するかを指定する。値marginは非負の数値か、そのような数値のペアー(x
.
y)
でなければならない。ペアーならxは水平方向に追加するピクセル数、yは垂直方向に追加するピクセル数を指定する。:margin
が指定されない場合のデフォルトは0。
:ascent ascent
これはイメージのアセント(ベースラインの上の部分)に使用するイメージの高さの分量を指定する。値ascentは0から100の数値かシンボルcenter
でなければならない。
ascentが数値ならアセントに使用するイメージの高さのパーセンテージであること。
ascentがcenter
なら、イメージにたいしてテキストプロパティやオーバーレイプロパティにより指定される方法で、センターライン(そのイメージ位置にテキストを描画する際の垂直方向のセンターライン)の垂直方向中心にイメージが配置される。
このプロパティが省略された場合のデフォルトは50。
:relief relief
これはイメージ周辺にシャドー矩形を追加する。値reliefはシャドーライン幅をピクセルで指定する。reliefが負ならボタンを押下した状態、それ以外はボタンを押下していない状態のイメージでシャドーを描画する。
:width width, :height height
キーワード:width
と:height
はイメージのスケーリングに使用される。いずれか一方のみが指定された場合には、アスペクト比を保つためにもう一方が算出される。両方が指定された場合にはアスペクト比は保たれないかもしれない。
:max-width max-width, :max-height max-height
キーワード:max-width
と:max-height
は、イメージのサイズがこれらの値を超過した場合のスケーリングに使用される。:width
がセットされた場合にはmax-width
より優先されて、:height
がセットされた場合にはmax-height
より優先されるだろうが、それ以外ではこれらのキーワードを望むように混交できる。
:max-width
と:height
が指定されていて:width
が未指定なら、アスペクト比を維持することにより:max-width
を超える幅が要求されるかもしれない。これが発生した場合には、スケーリングは:max-width
を超過しないアスペクト比を維持できるように、小さい値を使用する。:max-height
と:width
が指定されていて:height
が未指定のときも同様。たとえば200x100のイメージがあり:width
を400、:max-height
を150に指定すると、アスペクト比を保持しつつ“max”のセッティングを超過しないようにイメージは最終的には300x150になる。このパラメーターの組み合わせは、“可能なかぎり大きく、ただし利用可能なディスプレイエリア以下でこのイメージを表示せよ”のように指示する簡便な手段である。
:scale scale
これは数字であること。1より大きい値は幅および高さを乗じたサイズの増加、小さい値はサイズの減少を意味する。たとえば値0.25はイメージをオリジナルの1/4のサイズにするだろう。このスケーリングにより:max-width
や:max-height
で指定されたイメージの元のサイズより大きくなる場合でも、結果サイズがこれら2つの値を超過することはない。:scale
および:height
/:width
の両方が指定されたら、高さ/幅は指定されたスケーリング倍率に調整される。
:rotation angle
ローテーション角度を度数(degree)で指定する。イメージタイプがimagemagick
でなければ、90°の倍数のみをサポート。値が正なら時計回り、負なら反時計回り。ローテーションはスケーリングとクロッピング(cropping:
切り取り、抜き出し)の後に行われる。
:index frame
Multi-Frame Imagesを参照のこと。
:conversion algorithm
これはイメージを表示する前に適用するべき変換アルゴリズムを指定する。値algorithmは何のアルゴリズムかを指定する。
laplace
emboss
カラーの大きな差異を強調して小さな差異を不鮮明にするラプラスエッジ検出アルゴリズム(Laplace edge detection algorithm)を指定する。無効なボタンのイメージ表示に、これが役立つと考える人もいます。
(edge-detection :matrix matrix :color-adjust adjust)
一般的なエッジ検出アルゴリズムを指定する。matrixは数値からなる9要素のリストかベクターでなければならない。変換されたイメージ内の位置x/yにあるピクセルは、その位置周辺にある元のピクセルから計算される。matrixはx/yに近接する各ピクセルにたいして、そのピクセルが変換先ピクセルに影響するファクター(factor: 要因)を指定する。以下のように要素0はx-1/y-1にあるピクセルのファクター、要素1はx/y-1にあるピクセルにたいするファクター、...を指定する。
(x-1/y-1 x/y-1 x+1/y-1 x-1/y x/y x+1/y x-1/y+1 x/y+1 x+1/y+1)
結果となるピクセルは周辺ピクセルのRGB値を合計したカラーを指定されたファクターで乗じて、その合計をファクター絶対値の合計で除した色強度から計算される。
ラプラスエッジ検出は現在のところは以下のマトリクス
(1 0 0 0 0 0 0 0 -1)
エンボスエッジ検出(Emboss edge-detection)は以下のマトリクスを使用する
( 2 -1 0 -1 0 1 0 1 -2)
disabled
イメージが無効(disabled)に見えるよう変換することを指定する。
:mask mask
maskがheuristic
か(heuristic
bg)
なら、フレームのバックグラウンドがイメージ背後に見えるようにイメージのクリッピングマスクを構築する。bgが未指定かt
なら、イメージ4隅に最頻するカラーをそのイメージのバックグラウンドカラーとみなしてバックグラウンドカラーを決定する。それ以外ならbgはイメージのバックグラウンドとみなすべきカラーを指定するリスト(red
green blue)
でなければならない。
maskがnil
なら、イメージがマスクをもつ場合にはマスクを削除する。マスクを含むフォーマットのイメージは:mask
nil
を指定することにより削除される可能性がある。
:pointer shape
これはマウスポインターがそのイメージ上にある際のポインターシェイプを指定する。利用可能なポインターシェイプについてはPointer Shapeを参照のこと。
:map map
これはイメージにホットスポット(hot spots)のイメージマップを関連付ける。
イメージマップは各要素が(area id
plist)
という形式をもつalist。areaにはrectangle(矩形)、circle(円)、またはpolygon(ポリゴン、多角形)のいずれかを指定する。
rectangleは矩形エリアの左上隅と右下隅のピクセル座標を指定するコンス(rect . ((x0 . y0)
. (x1 . y1)))
。
circleは円の中心と半径を指定するコンス(circle . ((x0 . y0)
. r))
。rは整数か浮動小数点数。
polygonは各ペアーが多角形の1つの頂点を記述するコンス(poly . [x0 y0 x1
y1 ...])
。
マウスポインターがホットスポット上にある際には、ホットスポットのplistが参照される。これがhelp-echo
プロパティを含むならそのホットスポットのツールチップ、pointer
プロパティを含む場合はマウスカーソルがホットスポット上にあるときのマウスカーソルのシェイプを指定する。利用可能なポインターシェイプについてはPointer Shapeを参照のこと。
マウスポインターがホットスポット上にあるときにマウスをクリックしたときのイベントは、ホットスポットのidとマウスイベントを組み合わせて構成される。たとえばホットスポットのidがarea4
なら[area4
mouse-1]
。
この関数はイメージspecがマスクビットマップをもつならt
をリターンする。frameはそのイメージが表示されるフレーム。frameがnil
か省略された場合には選択されたフレームが使用される(Input Focusを参照)。
この関数はframeがイメージのスケーリングとローテーションをサポートすれば非nil
をリターンする。frameがnil
か省略なら選択されたフレームの使用を意味する(Input Focusを参照)。リターンされるリストには何のイメージ変換操作がサポートされるかを示すシンボルが含まれる:
scale
frameは:scale
、:width
、:height
、:max-width
、:max-height
のプロパティを通じたイメージスケーリングをサポートする。
rotate90
frameはローテーション角度が90°の整数倍ならイメージローテーションをサポートする。
イメージ変換がサポートされていなければ:rotation
、:crop
、:width
、:height
、:scale
、:max-width
、:max-height
は(利用可能なら)ImageMagickを通じた場合のみ使用可能(ImageMagick Imagesを参照)。