useXHR − LoadQueueインスタンスがロードするとき、XMLHttpRequestを用いるか、それともHTMLタグによるのかを示すブール(論理)値。デフォルト値はtrue。falseが与えられると、LoadQueueオブジェクトはタグを用いてロードし、必要があればXMLHttpRequestにフォールバックする。

basePath【0.3.1】− キューに入れられた項目をロードするとき、それらのソースの前に加えられるパスの文字列。ただし、LoadQueue.loadFile()やLoadQueue.loadManifest()メソッドで別のパスが与えられると、コンストラクタではなくその定めが用いられる。

file − 読込むファイルを定めるパスの文字列、またはつぎのプロパティが含まれたObjectインスタンス。オブジェクトには、少なくともsrcプロパティが定められていなければならない。

• src: 読込むファイルのパスを示す文字列(推奨)。あるいは、HTMLタグも用いることができる。
• type: 読込むファイルの種類を示すLoadQueueクラスに定数として備えられた文字列(表001)。PreloadJSは、読込むファイルの拡張子で形式を判別する。けれど、PHPスクリプトなど標準的でない形式のときには、typeプロパティで定めるのがよい。

表001■読込むファイルのtypeプロパティを定めるLoadQueueクラスの定数


LoadQueueクラスの定数	ファイル形式	おもな拡張子	文字列
BINARY	バイナリ	-	binary
CSS	CSS	.css	css
IMAGE	画像	.png/.gif/.jpg	image
JAVASCRIPT	JavaScript	.js	javascript
JSON	JSON	.json	json
JSONP【0.3.1】	JSONP	.jsonp	jsonp
SOUND	サウンド	.mp3/.ogg/.wav	sound
SVG	SVG	.svg	svg
TEXT	テキスト	.txt	text
XML	XML	.xml	xml

• id: 読込まれたオブジェクトを参照するための識別子とする文字列。
• callback【0.3.1】: JSONPのリクエストで、ロードし終えたときに呼出すメソッドを定める。
• data: 読込まれたオブジェクトに任意に加えるObjectインスタンス。
• method【0.3.1】: サーバーにデータを送るとき、リクエストにGETとPOSTのどちらを使うのか定める。デフォルトはGET。
• values【0.3.1】: サーバーに送る名前と値の組をもつオブジェクト。

loadNow − すぐに読込むかどうかを定めるブール値。falseを渡すと、LoadQueue.load()メソッドの呼出しを待つ。デフォルト値はtrueで、直ちにロードする。LoadQueue.setPaused()メソッドでキューを一時停止していても、この引数にtrueを渡すと読込みが再開される。

basePath【0.3.1】− ファイルをロードするとき、それらのソースの前に加えられるパスの文字列。ロードする項目には変更は加わらない。

manifest − ロードするファイルをエレメントに納めた配列。エレメントのファイルは、読込むファイルを示すパスの文字列、またはつぎのプロパティが含まれたObjectインスタンスのいずれかで定める。オブジェクトには、少なくともsrcプロパティが定められていなければならない。

• src: 読込むファイルのパスを示す文字列(推奨)。あるいは、HTMLタグも用いることができる。
• type: 読込むファイルの種類を示すLoadQueueクラスに定数として備えられた文字列(前掲表001)。PreloadJSは、読込むファイルの拡張子で形式を判別する。けれど、PHPスクリプトなど標準的でない形式のときには、typeプロパティで定めるのがよい。
• id: 読込まれたオブジェクトを参照するための識別子とする文字列。
• callback【0.3.1】: JSONPのリクエストで、ロードし終えたときに呼出すメソッドを定める。
• data: 読込まれたオブジェクトに任意に加えるObjectインスタンス。
• method【0.3.1】: サーバーにデータを送るとき、リクエストにGETとPOSTのどちらを使うのか定める。デフォルトはGET。
• values【0.3.1】: サーバーに送る名前と値の組をもつオブジェクト。

loadNow − すぐに読込むかどうかを定めるブール値。falseを渡すと、LoadQueue.load()メソッドの呼出しを待つ。デフォルト値はtrueで、直ちにロードする。LoadQueue.setPaused()メソッドでキューを一時停止していても、この引数にtrueを渡すと読込みが再開される。

basePath【0.3.1】− ファイルをロードするとき、それらのソースの前に加えられるパスの文字列。ロードする項目には変更は加わらない。

[*1] PreloadJS 0.3.1のドキュメントでは、LoadQueue.loadManifest()メソッドの第1引数に渡すオブジェクトについて、callbackやmethodおよびvaluesのプロパティが記されていません。けれど、このオブジェクトはLoadQueue.loadFile()メソッドの第1引数と共通ですので、0.3.0からの改訂が漏れたものと思われます。

[*2] CreateJS Support「The basePath option of LoadQueue class does not work」の議論(英語)をご参照ください。

1. var stage;
2. var file = "images/Pen.png";
3. var canvasElement = document.getElementById("myCanvas");
4. stage = new createjs.Stage(canvasElement);
5. var myBitmap = new createjs.Bitmap(file);
6. var loader = new createjs.LoadQueue(false);
7. loader.addEventListener("fileload", draw);
8. loader.loadFile({src:file, data:myBitmap});
9. myBitmap.x = canvasElement.width / 2;
10. myBitmap.y = canvasElement.height / 2;
11. stage.addChild(myBitmap);
12. function draw(eventObject) {
13.   var instance = eventObject.item.data;
14.   var myImage = eventObject.result;
15.   instance.regX = myImage.width / 2;
16.   instance.regY = myImage.height / 2;
17.   stage.update();
18. }