Layer.pileRect

機能/意味

矩形ピクセルアルファブレンド重ね合わせ

タイプ

Layerクラスのメソッド

構文

pileRect(dleft, dtop, src, sleft, stop, swidth, sheight, opa=255)

引数

dleft	重ね合わせ先の矩形の左端位置を ( 重ね合わせ先レイヤの画像位置における ) ピクセル単位で指定します。
dtop	重ね合わせ先の矩形の上端位置を ( 重ね合わせ先レイヤの画像位置における ) ピクセル単位で指定します。
src	重ね合わせ元のレイヤオブジェクトを指定します。
sleft	重ね合わせる矩形の左端位置を ( 重ね合わせ元レイヤの画像位置における ) ピクセル単位で指定します。
stop	重ね合わせる矩形の上端位置を ( 重ね合わせ元レイヤの画像位置における ) ピクセル単位で指定します。
swidth	重ね合わせる矩形の横幅を ( 重ね合わせ元レイヤの画像位置における ) ピクセル単位で指定します。
sheight	重ね合わせる矩形の縦幅を ( 重ね合わせ元レイヤの画像位置における ) ピクセル単位で指定します。
opa	重ね合わせの不透明度 ( 0 ～ 255 ) を指定します。

戻り値

なし (void)

説明

　指定された重ね合わせ元レイヤの矩形部分を自分のレイヤの指定位置に重ね合わせます。
　ピクセルごとの不透明度 ( ピクセルアルファ ) を用いた重ね合わせを行うことができます。
　重ね合わされる画像は、重ね合わせ先の ( メソッドを実行する ) レイヤの Layer.face プロパティの値によって変わります。
dfAlpha (またはdfBoth) : 重ね合わせ先の不透明度を考慮した重ね合わせが行われます
dfOpaque (またはdfMain) : 重ね合わせ先の不透明度を無視した重ね合わせが行われます(重ね合わせ先は全面完全不透明として扱われます)
それ以外 : できません ( 例外が発生します )
　重ね合わせ元のレイヤの Layer.face プロパティは無視されます ( 常にメイン画像とマスク画像を 用いてアルファブレンドが行われます )。

　このメソッドは旧式になりました。代わりに Layer.operateRect を使用してください。演算のモードに omAlpha か omAddAlpha を指定すると同じ効果になります(omAlphaを指定するのかomAddAlphaを指定するのかはsrcのアルファタイプによって異なります。omAutoを指定すればsrcのレイヤタイプに従って自動的に決定されます)。