cacheAsBitmap (MovieClip.cacheAsBitmap プロパティ)

true に設定されている場合、ムービークリップの内部ビットマップ表現がキャッシュされます。これで、複雑なベクターコンテンツを格納しているムービークリップのパフォーマンスを向上させることができます。

ビットマップがキャッシュされているムービークリップのベクターデータはすべて、メインステージでなくビットマップに描画されます。その後、ビットマップは、最も近いピクセル境界に吸着された非伸縮、非回転のピクセルとして、メインステージにコピーされます。ピクセルは、親オブジェクトと 1 対 1 でマップされます。ビットマップの境界が変更されると、ビットマップは伸縮されずに再作成されます。

内部ビットマップが作成されるのは、cacheAsBitmap プロパティが true に設定されている場合だけです。

ムービークリップの cacheAsBitmap プロパティを true に設定しても、レンダリングは変化しませんが、ムービークリップでピクセルへの吸着が自動的に実行されます。ベクターコンテンツの複雑さによっては、アニメーションの速度が大幅に向上する可能性があります。

ムービークリップにフィルタを適用するたびに、そのムービークリップの filter 配列が空でなければ、cacheAsBitmap プロパティが自動的に true に設定されます。ムービークリップにフィルタが適用されている場合、そのムービークリップの cacheAsBitmap は、false に設定されている場合でも、true と報告されます。ムービークリップのすべてのフィルタをクリアすると、cacheAsBitmap は直前の設定に戻ります。

次の場合は、cacheAsBitmap プロパティが true に設定されていても、ムービークリップはビットマップを使用せずにベクターデータからレンダリングされます。

cacheAsBitmap プロパティは、その内容がほぼ静的で、拡大や縮小、回転が頻繁に行われないムービークリップに最適です。そのようなムービークリップでは、cacheAsBitmap プロパティによって、ムービークリップの変換時 (その x 位置と y 位置の変更時) にパフォーマンスが向上します。

例

次の例では、ムービークリップインスタンスにドロップシャドウを適用します。その後、フィルタの適用時に true に設定される cacheAsBitmap プロパティの値をトレースします。

import flash.filters.DropShadowFilter;

var container:MovieClip = setUpShape();
trace(container.cacheAsBitmap); // false
var dropShadow:DropShadowFilter = new DropShadowFilter(6, 45, 0x000000, 50, 5, 5, 1, 2, false, false, false); 
container.filters = new Array(dropShadow);
trace(container.cacheAsBitmap); // true

function setUpShape():MovieClip {
    var mc:MovieClip = this.createEmptyMovieClip("container", this.getNextHighestDepth());
    mc._x = 10;
    mc._y = 10;
    var w:Number = 50;
    var h:Number = 50;
    mc.beginFill(0xFFCC00);
    mc.lineTo(w, 0);
    mc.lineTo(w, h);
    mc.lineTo(0, h);
    mc.lineTo(0, 0);
    mc.endFill();
    return mc;
}

cacheAsBitmap (MovieClip.cacheAsBitmap プロパティ)

例

関連項目