# ImageFunction.doBoxBlur

機能/意味

  矩形ブラーをかける

タイプ
  ImageFunctionクラスのメソッド
構文
  doBoxBlur(bmp, xblur=1, yblur=1, cliprect=null, isalpha=true)
引数

  bmp | 矩形ブラーをかける Bitmap オブジェクトを指定します。
  xblur | 横方向のブラーの範囲を指定します。
  yblur | 縦方向のブラーの範囲を指定します。
  cliprect | クリッピング領域を ( Bitmap の画像位置における ) Rect オブジェクトで指定します。 未指定時全体が対象となります。
  isalpha | アルファチャンネルを持つかどうかを指定します。

戻り値
  なし (void)
説明

  ブラー(ぼかし)をかけます。
  アルゴリズムは「矩形ブラー」(box blur)です。
  矩形ブラーは、xblurとyblurの２つのパラメータによって表現される「範囲」中のピクセルの輝度の平均値をとる物です。
  たとえば xblur=10 yblur=2 の場合は、対象のピクセルを中心に、横方向は -10～10、縦方向は -2～2 の矩形範囲のピクセルの輝度の平均をとり、それが最終的なそのピクセルの輝度となります。
  範囲の面積は (xblur×2+1) × (yblur×2+1) で計算することができます。
  現バージョンではこの面積が 256 未満 の場合は、面積が256以上の場合よりも高速なアルゴリズムが採用されます。
  isalpha が true の場合は、アルファ合成用の特別なアルゴリズムを使用しますので、少々遅くなります。
  false の場合は、より高速なアルゴリズムとなります。