Flash/ドキュメントクラス超解説

ドキュメントクラス超解説 †

某beinteractiveさんによる超解説 †

ドキュメントクラスが実行されるのは、1フレーム目がロードされきった時なので、
これよりも前に色々書き出されてるといつまでたってもプリローダとかが実行されない。

「いろいろ」の部分を 2フレーム目に持っていき、ドキュメントクラスをすぐ実行できるようにしたい。
こんな感じに2フレーム目にいろいろMCなど配置する。

ドキュメントクラスはどうするか？

package
{
	import flash.display.MovieClip;
	import flash.display.Sprite;
	import flash.events.Event;
	import flash.display.Stage;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.utils.getDefinitionByName;

	public class DocumentRoot extends MovieClip
	{
		public function DocumentRoot() 
		{
			stage.scaleMode = StageScaleMode.NO_SCALE;
			stage.align = StageAlign.LEFT;

			addEventListener(Event.ENTER_FRAME, _initialHandler);
		}

		private function _initialHandler(e:Event):void 
		{
			//3フレーム目まで到達すればロードが完了
			if (currentFrame == 3) {
				removeEventListener(Event.ENTER_FRAME, _initialHandler);
				stop();

				initialize();
			} else {
				var percent:Number = (loaderInfo.bytesLoaded / loaderInfo.bytesTotal) * 100;
				trace("Loading... " + percent + "%");
			}
		}

		protected function initialize():void
		{
			//var s:Sample1 = new Sample1();
			var sample1:Class = getDefinitionByName('Sample1') as Class;
			var s:Sprite = new sample1();
		}
	}
}

基本的に、「あるクラスが使うクラス」は、そのクラスが実行される前に全てロードされてる必要がある。
ということは、その「あるクラス」よりも、確実に前にロードされるように SWF に配置する必要がある。

DocumentRoot? の中で var s: Sample1 = new Sample1() としてしまうと、
DocumentRoot? クラスが「使うクラス」である「Sample1」クラスは、DocumentRoot? クラスよりも前に読み込まなきゃいけない。
つまり、Sample1 が読み込み終わるまで DocumentRoot? が実行されないので、意味が無い。
こんな図のような感じになってしまう。

で、ここで出てくるのが getDefinitionByName?
クラスは取得するけど、「このクラスはこのクラスが必要です」とまでは主張しない。
するとこんな図のような感じになる。

となって、見事 2フレーム目に埋め込まれる。

そうすると、1フレーム目では Sample1 クラスはロードされていないんだけど、
3フレーム目になればきちんとロードされていて、getDefinitionByName? で取得できる、という状況が出来上がる。
つまり、getDefinitionByName? を使うのは、確実に1フレーム目ではなく2フレーム目に埋め込むため。

↑