Layer.independMainImage

機能/意味

メイン画像の共有の解除

タイプ

Layerクラスのメソッド

構文

independMainImage(copy=true)

引数

copy	共有状態を解除する際、元の画像をコピーするかどうかを指定します。 　真を指定すると元の画像をコピーします。偽を指定すると元の画像はコピーされず、画像の 内容は不定となります。

戻り値

なし (void)

説明

　レイヤ画像の共有状態を強制的に解除します。
　吉里吉里は、assignImages などで画像をまるごと他のレイヤにコピーした場合、実際には 画像バッファのコピーを行わず、同一の画像を共有するようになります。
　通常、画像に変更を加えようとする直前でこの共有状態は自動的に解除されますが、 このメソッドで強制的に解除することができます。
　copy 引数に false を指定した場合は、画像の共有は解除されますが、元の画像を 引き継ぐことは保証されません ( 画像の内容は不定になります ) が、共有の解除を より高速に行うことができます。レイヤの画像全部を書き換える場合は元の画像を 引き継ぐ必要はありませんので、描画を行う前にあらかじめこのメソッドに false を 指定して呼び出すと効率が良くなる場合があります。
　このメソッドは、画像が共有されていない場合は何もしません。