Next: Multi-Frame Images, Previous: Defining Images, Up: Images [Contents][Index]
自分でdisplayプロパティをセットアップしてイメージディスクリプタを使用できますが、このセクションの関数を使用するほうがより簡単です。
この関数はカレントバッファーのポイント位置にimageを挿入する。imageはイメージディスクリプタであること。これはcreate-imageによりリターンされた値、またはdefimageで定義されたシンボルの値を使用できる。引数stringはイメージを保持するためにバッファー内に配置するテキストを指定する。これが省略かnilなら、insert-imageはデフォルトで"
"を使用する。
引数areaはマージン内にイメージを置くかどうかを指定する。これがleft-marginなら左マージンにイメージが表示され、right-marginなら右マージンを指定する。areaがnilか省略なら、イメージはバッファーのテキスト内のポイント位置に表示される。
引数sliceは挿入するイメージのスライスを指定する。sliceがnilか省略された場に合はイメージ全体が挿入される。それ以外では、sliceがリスト(x
y width
height)ならxとyは位置、widthとheightは挿入するイメージの領域を指定する。整数値はピクセル単位。0.0から1.0までの浮動小数点数はイメージ全体の幅や高さにたいする割合を指定する。
この関数は内部的にはバッファー内にstringを挿入して、imageを指定するdisplayプロパティにそれを渡す。Display Propertyを参照のこと。
この関数はinsert-imageと同様にカレントバッファー内にimageを挿入するが、イメージをrows✕colsの同一サイズのスライスに分割する点が異なる。
イメージが“スライス”されて挿入されると、Emacsは各スライスを個別のイメージとして表示して、(巨大な)イメージを表示するバッファーのページングの際、イメージ全体を上下にジャンプするのではなく、より直感的な上下スクロールが可能になる。
この関数はカレントバッファー内のposの前にイメージimageを配置する。引数posは整数かマーカーであること。これはイメージが表示されるべきバッファー位置を指定する。引数stringは代替として表示されるべきデフォルトのイメージを保持するテキストであること。
引数imageはイメージディスクリプタでなければならず、それはcreate-imageがリターンされたか、あるいはdefimageにより格納されたイメージディスクリプタかもしれない。
引数areaはマージン内にイメージを置くかどうかを指定する。これがleft-marginなら左マージンにイメージが表示され、right-marginなら右マージンを指定する。areaがnilか省略なら、イメージはバッファーのテキスト内のポイント位置に表示される。
内部的には、この関数はオーバーレイを作成して、値がそのイメージであるようなdisplayプロパティをもつテキストを含む、before-stringプロパティをそのオーバーレイに与えている(なんと!)。
この関数はbufferの位置startとendの間のイメージを削除する。bufferが省略かnilならカレントバッファーからイメージを削除する。
これはput-imageが行う方法でbufferに配置されたイメージだけを削除して、insert-imageや他の方法で挿入されたイメージは削除しない。
この関数は、ペアー(width . height)として、イメージのサイズをリターンする。specはイメージ仕様である。pixelsが非nilならピクセル単位、それ以外ならcanonicalな文字単位(そのフレームのデフォルトフォントの幅/高さの割合)で量ったサイズをリターンする。frameは、イメージが表示されるフレームである。frameがnilまたは省略された場合は、選択されたフレームを使用する(Input Focusを参照)。
この変数はEmacsがロードするイメージの最大サイズを定義するために使用される。Emacsはこの制限より大きいイメージのロード(と表示)を拒絶するだろう。
値が整数ならピクセル単位で量ったイメージの最大の高さと幅を直接指定する。浮動小数点数ならフレームの高さと幅にたいする比率として、イメージの最大の高さと幅を指定する。値が数値でなければイメージサイズにたいする明示的な制限は存在しない。
この変数の目的は意図せずEmacsに不当に大きなイメージがロードされるとを防ぐことである。これはイメージの初回ロード時だけ効果がある。イメージが一度イメージキャッシュに置かれると、その後にmax-image-sizeの値が変更されても、そのイメージは常に表示可能である(Image Cacheを参照)。