Layer.stretchCopy

機能/意味

拡大縮小コピー

タイプ

Layerクラスのメソッド

構文

stretchCopy(dleft, dtop, dwidth, dheight, src, sleft, stop, swidth, sheight, mode=stNearest)

引数

dleft	コピー先の矩形の左端位置を ( コピー先レイヤの画像位置における ) ピクセル単位で指定します。
dtop	コピー先の矩形の上端位置を ( コピー先レイヤの画像位置における ) ピクセル単位で指定します。
dwidth	コピー先の矩形の横幅を ( コピー先レイヤの画像位置における ) ピクセル単位で指定します。
dheight	コピー先の矩形の縦幅を ( コピー先レイヤの画像位置における ) ピクセル単位で指定します。
src	コピー元のレイヤオブジェクトを指定します。
sleft	コピーする矩形の左端位置を ( コピー元レイヤの画像位置における ) ピクセル単位で指定します。
stop	コピーする矩形の上端位置を ( コピー元レイヤの画像位置における ) ピクセル単位で指定します。
swidth	コピーする矩形の横幅を ( コピー元レイヤの画像位置における ) ピクセル単位で指定します。
sheight	コピーする矩形の縦幅を ( コピー元レイヤの画像位置における ) ピクセル単位で指定します。
mode	拡大縮小のモードを指定します。 stNearest : 最近傍点法が用いられます stFastLinear : 低精度の線形補間が用いられます(一部実装) stLinear : 線形補間が用いられます(一部実装) stCubic : ３次元補間が用いられます(一部実装) 　速度は ntNearest > stFastLinear > stLinear > stCubis の順に高速ですが、画質は速度が 早ければ早いモードほど低画質になります。

戻り値

なし (void)

説明

　指定されたコピー元レイヤの矩形を、コピー先 ( メソッドを実行するレイヤ ) の矩形に コピーします。コピー元矩形とコピー先矩形のサイズが異なる場合は拡大または縮小が 行われます。
　現バージョンでは stFastLinear の指定で線形補間が効くのは、コピー先レイヤの横幅、縦幅の 　どちらか、あるいは両方がコピー元レイヤのそれぞれの２倍である場合のみです。
　また、現バージョンでは stLinear あるいは stCubic の指定が有効なのは、左右／上下反転を 伴わず、コピー先矩形がレイヤをはみ出さない場合のみです。
　重ね合わせ先の ( メソッドを実行する ) レイヤの Layer.face プロパティが dfBoth 以外の場合は例外が発生します。