40.17.3 XBMイメージ

XBMフォーマットを使用するにはイメージタイプとしてxbmを指定します。このイメージフォーマットは外部ライブラリーを要求せず、このタイプのイメージは常にサポートされます。

xbmイメージタイプにたいして追加のイメージプロパティがサポートされます:

:foreground foreground

値foregroundはそのイメージのフォアグラウンドカラーを指定する文字列、またはデフォルトカラーを指定するnilであること。このカラーはXBM内の1の各ピクセルに使用される。デフォルトはフレームのフォアグラウンドカラー。

:background background

値backgroundはそのイメージのバックグラウンドカラーを指定する文字列、またはデフォルトカラーを指定するnilであること。このカラーはXBM内の0の各ピクセルに使用される。デフォルトはフレームのバックグラウンドカラー。

外部ファイルのかわりにEmacs内のデータを指定してXBMイメージを指定するには以下の3つのプロパティを使用する:

:data data

値dataはイメージのコンテンツを指定する。dataとして使用できる3つのフォーマットが存在する:

• それぞれがイメージの1ラインを指定するような文字列ベクターかboolベクター。:heightと:widthを指定する。
• 文字列ならXBMファイルが含むのと同じバイトシーケンスを含む。この場合は:heightと:widthを指定してはならない。これらを省略することが、そのデータがXBMファイルのフォーマットをもつことを示すからである。イメージの高さと幅はファイルのコンテンツにより指定される。
• イメージのビットを含む文字列かboolベクター(終端の使用されない余分なビットを含むかもしれない)。少なくともstride * heightビットを含むこと(strideはイメージ幅以上の8の最小倍数)。この場合にはその文字列がXBMファイル全体ではなく、単にビットだけを含むことを示すとともに、そのイメージのサイズを指定するために:height、:width、:strideを指定する必要がある。

:width width

値widthはピクセル単位でイメージの幅を指定する。

:height height

値heightはピクセル単位でイメージの高さを指定する。

:widthと:heightは幅と高さを指定しないデータ(イメージビットを含んだ文字列やベクター)を渡された場合のみ使用できることに注意。XBMファイルは通常は自身でこれらを指定するので、これらのファイルにたいしてこれら2つのプロパティを使用するとエラーになる。更に:widthと:heightは他のほとんどのイメージフォーマットにおいて、表示するイメージが何であるか(通常は何らかのスケーリングを行うことを意味する)を指定するために使用されることにも注意。これはXBMイメージではサポートされない。

:stride stride

各行に格納さたブールベクターのエントリー数(width以上の8の最小倍数)。