この関数は、シンボル bitmap を新しいフリンジビットマップとして定義するか、同名の既存のビットマップを置き換えます。
引数 bits で使用する画像を指定します。文字列または整数のベクトルのいずれかである必要があり、各要素(整数)はビットマップの1行に対応します。整数の各ビットはビットマップの1ピクセルに対応し、下位ビットがビットマップの最右端のピクセルに対応します。(なお、このビットの順序は XBM 画像の順序とは逆であることに注意してください。XBM 画像 を参照してください。)
高さは通常 bits の長さとなります。ただし、nil
height 以外の値を指定することで、異なる高さを設定できます。幅は通常 8 ですが、nil width
以外の値を指定することで、異なる幅を設定できます。幅は 1 から 16 までの整数である必要があります。
引数 align
は、ビットマップが使用される行範囲に対する相対的な位置を指定します。デフォルトでは、ビットマップは中央に配置されます。指定可能な値は top、center、または bottom です。
align 引数はリスト (align periodic) であってもよく、その場合
align は前述の通りに解釈されます。periodic が
nil 以外である場合、bits
の行を指定された高さに達するまで十分な回数繰り返すことを指定します。
この関数は、bitmap で指定されたフリンジビットマップを破棄します。bitmap が標準のフリンジビットマップを指している場合、そのビットマップを完全に削除するのではなく、実際にはその標準定義を復元します。
これにより、フリンジビットマップ bitmap の面が face に設定されます。face が nil の場合、fringe
の面が選択されます。ビットマップの面によって、描画時の色が制御されます。
face は fringe 面と統合されるため、通常
face では前景色のみを指定すべきです。