@next2d/player 1.14.7 → 1.14.8

package/dist/player/next2d/display/Loader.js

@@ -0,0 +1,324 @@
+import { DisplayObjectContainer } from "./DisplayObjectContainer";
+import { LoaderInfo } from "./LoaderInfo";
+import { MovieClip } from "./MovieClip";
+import { IOErrorEvent } from "../events/IOErrorEvent";
+import { Event } from "../events/Event";
+import { ProgressEvent as Next2DProgressEvent } from "../events/ProgressEvent";
+import { HTTPStatusEvent } from "../events/HTTPStatusEvent";
+import { $ajax, $headerToArray, $unzipQueues, $updateUnzipWorkerStatus, $getUnzipWorker, $getClass, $currentPlayer, $useUnzipWorker } from "../../util/Util";
+import { $getMap } from "../../util/RenderUtil";
+/**
+ * Loader クラスは、JSON ファイルまたはイメージ（JPEG、PNG、または GIF）ファイルを読み込むために使用します。
+ * 読み込みを開始するには load() メソッドを使用します。
+ * 読み込まれた表示オブジェクトは Loader オブジェクトの子として追加されます。
+ *
+ * The Loader class is used to load JSON files or image (JPEG, PNG, or GIF) files.
+ * Use the load() method to initiate loading.
+ * The loaded display object is added as a child of the Loader object.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  DisplayObjectContainer
+ */
+export class Loader extends DisplayObjectContainer {
+    /**
+     * @constructor
+     * @public
+     */
+    constructor() {
+        super();
+        /**
+         * @type {LoaderInfo}
+         * @private
+         */
+        this._$loaderInfo = new LoaderInfo();
+    }
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class Loader]
+     * @method
+     * @static
+     */
+    static toString() {
+        return "[class Loader]";
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.display.Loader
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.display.Loader";
+    }
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object Loader]
+     * @method
+     * @public
+     */
+    toString() {
+        return "[object Loader]";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.display.Loader
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.display.Loader";
+    }
+    /**
+     * @description load メソッドを使用して読み込まれた JSON のルート表示オブジェクトが含まれます。
+     *              It contains a JSON root display object loaded using the load method.
+     *
+     * @member {MovieClip | Sprite | null}
+     * @readonly
+     * @public
+     */
+    get content() {
+        return this._$loaderInfo ? this._$loaderInfo.content : null;
+    }
+    /**
+     * @description 読み込まれているオブジェクトに対応する LoaderInfo オブジェクトを返します。
+     *              Returns a LoaderInfo object corresponding to the object being loaded.
+     *
+     * @member {LoaderInfo}
+     * @readonly
+     * @public
+     */
+    get contentLoaderInfo() {
+        return this._$loaderInfo;
+    }
+    /**
+     * @description JSONファイルを、この Loader オブジェクトの子であるcontentプロパティにロードします。
+     *              JPEG、GIF、PNGなどの画像データは loadImage で同様にcontentプロパティにロードします。
+     *              Load the JSON file into the content property, which is a child of this Loader object.
+     *              Image data such as JPEG, GIF, PNG, etc.
+     *              are loaded into the content property in the same way with loadImage.
+     *
+     * @param   {URLRequest} request
+     * @returns {void}
+     * @method
+     * @public
+     */
+    load(request) {
+        const loaderInfo = this._$loaderInfo;
+        if (!loaderInfo) {
+            return;
+        }
+        loaderInfo.url = request.url;
+        loaderInfo.format = request.responseDataFormat;
+        $ajax({
+            "format": request.responseDataFormat,
+            "url": request.url,
+            "method": request.method,
+            "data": request.data,
+            "headers": request.headers,
+            "withCredentials": request.withCredentials,
+            "event": {
+                "loadstart": (event) => {
+                    this._$loadstart(event);
+                },
+                "progress": (event) => {
+                    this._$progress(event);
+                },
+                "loadend": (event) => {
+                    this._$loadend(event);
+                }
+            }
+        });
+    }
+    /**
+     * @param  {ProgressEvent} event
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$loadend(event) {
+        const loaderInfo = this._$loaderInfo;
+        if (!loaderInfo) {
+            return;
+        }
+        // set
+        loaderInfo.bytesLoaded = event.loaded;
+        loaderInfo.bytesTotal = event.total;
+        // progress event
+        if (loaderInfo.willTrigger(Next2DProgressEvent.PROGRESS)) {
+            loaderInfo.dispatchEvent(new Next2DProgressEvent(Next2DProgressEvent.PROGRESS, false, false, event.loaded, event.total));
+        }
+        const target = event.target;
+        // http status event
+        if (loaderInfo.willTrigger(HTTPStatusEvent.HTTP_STATUS)) {
+            const responseHeaders = $headerToArray(target.getAllResponseHeaders());
+            loaderInfo.dispatchEvent(new HTTPStatusEvent(HTTPStatusEvent.HTTP_STATUS, false, false, target.status, target.responseURL, responseHeaders));
+        }
+        if (199 < target.status && 400 > target.status) {
+            if (loaderInfo.format === "json") {
+                const json = target.response;
+                if (json.type === "zlib") {
+                    if ($useUnzipWorker()) {
+                        $unzipQueues.push({
+                            "json": json,
+                            "scope": this
+                        });
+                        return;
+                    }
+                    $updateUnzipWorkerStatus(true);
+                    const unzipWorker = $getUnzipWorker();
+                    const buffer = new Uint8Array(json.buffer);
+                    unzipWorker.onmessage = async (event) => {
+                        this._$unzipHandler(event);
+                    };
+                    unzipWorker.postMessage(buffer, [buffer.buffer]);
+                }
+                else {
+                    this._$build(json);
+                }
+            }
+            else {
+                throw new Error("LoaderInfo format is `json`");
+            }
+        }
+        else {
+            if (loaderInfo.willTrigger(IOErrorEvent.IO_ERROR)) {
+                loaderInfo.dispatchEvent(new IOErrorEvent(IOErrorEvent.IO_ERROR, false, false, target.statusText));
+            }
+        }
+    }
+    /**
+     * @param  {MessageEvent} event
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$unzipHandler(event) {
+        this._$build(event.data);
+        if ($unzipQueues.length) {
+            const object = $unzipQueues.pop();
+            if (!object) {
+                return;
+            }
+            const buffer = new Uint8Array(object.json.buffer);
+            const unzipWorker = $getUnzipWorker();
+            unzipWorker.onmessage = (event) => {
+                object.scope._$unzipHandler(event);
+            };
+            unzipWorker.postMessage(buffer, [buffer.buffer]);
+        }
+        else {
+            $updateUnzipWorkerStatus(false);
+        }
+    }
+    /**
+     * @param  {ProgressEvent} event
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$loadstart(event) {
+        const loaderInfo = this._$loaderInfo;
+        if (!loaderInfo) {
+            return;
+        }
+        loaderInfo.bytesLoaded = event.loaded;
+        loaderInfo.bytesTotal = event.total;
+        if (loaderInfo.willTrigger(Event.OPEN)) {
+            loaderInfo.dispatchEvent(new Event(Event.OPEN));
+        }
+        if (loaderInfo.willTrigger(Next2DProgressEvent.PROGRESS)) {
+            loaderInfo.dispatchEvent(new Next2DProgressEvent(Next2DProgressEvent.PROGRESS, false, false, event.loaded, event.total));
+        }
+    }
+    /**
+     * @param  {ProgressEvent} event
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$progress(event) {
+        const loaderInfo = this._$loaderInfo;
+        if (!loaderInfo) {
+            return;
+        }
+        // set
+        loaderInfo.bytesLoaded = event.loaded;
+        loaderInfo.bytesTotal = event.total;
+        // progress event
+        if (loaderInfo.willTrigger(Next2DProgressEvent.PROGRESS)) {
+            loaderInfo.dispatchEvent(new Next2DProgressEvent(Next2DProgressEvent.PROGRESS, false, false, event.loaded, event.total));
+        }
+    }
+    /**
+     * @param  {object} object
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$build(object) {
+        const loaderInfo = this._$loaderInfo;
+        if (!loaderInfo) {
+            return;
+        }
+        let rootSymbol = null;
+        const symbols = $getMap();
+        if (object.symbols.length) {
+            for (let idx = 0; idx < object.symbols.length; ++idx) {
+                const values = object.symbols[idx];
+                if (values[1] === 0) {
+                    rootSymbol = values[0];
+                }
+                symbols.set(values[0], values[1]);
+            }
+        }
+        loaderInfo._$data = {
+            "stage": object.stage,
+            "characters": object.characters,
+            "symbols": symbols
+        };
+        // setup
+        if (rootSymbol) {
+            // TODO
+            const SymbolClass = $getClass(rootSymbol) || MovieClip;
+            // @ts-ignore
+            loaderInfo._$content = new SymbolClass();
+        }
+        else {
+            loaderInfo._$content = new MovieClip();
+        }
+        // build root
+        const root = object.characters[0];
+        loaderInfo._$content._$build({
+            "characterId": 0,
+            "clipDepth": 0,
+            "depth": 0,
+            "endFrame": root.controller.length,
+            "startFrame": 1
+        }, this);
+        // fixed logic
+        loaderInfo._$content._$parent = null;
+        this.addChild(loaderInfo._$content);
+        // fixed logic
+        loaderInfo._$content._$added = false;
+        loaderInfo._$content._$addedStage = false;
+        // to event
+        const player = $currentPlayer();
+        player._$loaders.push(loaderInfo);
+        if (player._$loadStatus === 1) { // LOAD_START
+            player._$loadStatus = 2; // LOAD_END
+        }
+    }
+}

package/dist/player/next2d/display/LoaderInfo.d.ts

@@ -0,0 +1,122 @@
+import { EventDispatcher } from "../events/EventDispatcher";
+import type { URLLoaderDataFormatImpl } from "../../../interface/URLLoaderDataFormatImpl";
+import type { ParentImpl } from "../../../interface/ParentImpl";
+import type { LoaderInfoDataImpl } from "../../../interface/LoaderInfoDataImpl";
+/**
+ * LoaderInfo クラスは、読み込まれる JSON ファイルやイメージファイル（JPEG、GIF、PNG ファイルなど）に関する情報を提供します。
+ * LoaderInfo オブジェクトは、すべての表示オブジェクトで使用できます。
+ * 提供される情報には、読み込みの進行状況、読み込む側と読み込まれたコンテンツの URL、メディアの総バイト数、メディアの規格高さと幅などが含まれます。
+ *
+ * The LoaderInfo class provides information about a loaded JSON file or a loaded image file (JPEG, GIF, or PNG).
+ * LoaderInfo objects are available for any display object.
+ * The information provided includes load progress, the URLs of the loader and loaded content,
+ * the number of bytes total for the media, and the nominal height and width of the media.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  EventDispatcher
+ */
+export declare class LoaderInfo extends EventDispatcher {
+    readonly _$id: number;
+    _$content: ParentImpl<any> | null;
+    _$data: LoaderInfoDataImpl | null;
+    private _$bytesLoaded;
+    private _$bytesTotal;
+    private _$url;
+    private _$format;
+    /**
+     * @constructor
+     * @public
+     */
+    constructor();
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class LoaderInfo]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.display.LoaderInfo
+     * @const
+     * @static
+     */
+    static get namespace(): string;
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object LoaderInfo]
+     * @method
+     * @public
+     */
+    toString(): string;
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.display.LoaderInfo
+     * @const
+     * @public
+     */
+    get namespace(): string;
+    /**
+     * @description そのメディアのロード済みのバイト数です。
+     *              The uint of bytes that are loaded for the media.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get bytesLoaded(): number;
+    set bytesLoaded(bytes_loaded: number);
+    /**
+     * @description メディアファイル全体のバイト数です。
+     *              The number of bytes in the entire media file.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get bytesTotal(): number;
+    set bytesTotal(bytes_total: number);
+    /**
+     * @description LoaderInfo オブジェクトに関係したロードされたオブジェクトです。
+     *              The loaded object associated with this LoaderInfo object.
+     *
+     * @member {DisplayObject}
+     * @public
+     */
+    get content(): ParentImpl<any>;
+    set content(content: ParentImpl<any>);
+    /**
+     * @description 読み込まれるメディアの URL です。
+     *              The URL of the media being loaded.
+     *
+     * @member {string}
+     * @default ""
+     * @readonly
+     * @public
+     */
+    get url(): string;
+    set url(url: string);
+    /**
+     * @description 読み込まれるメディアの データフォーマット です。
+     *              The data format of the media being loaded.
+     *
+     * @member {string}
+     * @default "json"
+     * @public
+     */
+    get format(): URLLoaderDataFormatImpl;
+    set format(format: URLLoaderDataFormatImpl);
+}

package/dist/player/next2d/display/LoaderInfo.js

@@ -0,0 +1,191 @@
+import { EventDispatcher } from "../events/EventDispatcher";
+import { $getLoaderInfoId } from "../../util/Global";
+/**
+ * LoaderInfo クラスは、読み込まれる JSON ファイルやイメージファイル（JPEG、GIF、PNG ファイルなど）に関する情報を提供します。
+ * LoaderInfo オブジェクトは、すべての表示オブジェクトで使用できます。
+ * 提供される情報には、読み込みの進行状況、読み込む側と読み込まれたコンテンツの URL、メディアの総バイト数、メディアの規格高さと幅などが含まれます。
+ *
+ * The LoaderInfo class provides information about a loaded JSON file or a loaded image file (JPEG, GIF, or PNG).
+ * LoaderInfo objects are available for any display object.
+ * The information provided includes load progress, the URLs of the loader and loaded content,
+ * the number of bytes total for the media, and the nominal height and width of the media.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  EventDispatcher
+ */
+export class LoaderInfo extends EventDispatcher {
+    _$id;
+    _$content;
+    _$data;
+    _$bytesLoaded;
+    _$bytesTotal;
+    _$url;
+    _$format;
+    /**
+     * @constructor
+     * @public
+     */
+    constructor() {
+        super();
+        /**
+         * @type {number}
+         * @private
+         */
+        this._$id = $getLoaderInfoId();
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$bytesLoaded = 0;
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$bytesTotal = 0;
+        /**
+         * @type {string}
+         * @default ""
+         * @private
+         */
+        this._$url = "";
+        /**
+         * @type {DisplayObject}
+         * @default null
+         * @private
+         */
+        this._$content = null;
+        /**
+         * @type {object}
+         * @default null
+         * @private
+         */
+        this._$data = null;
+        /**
+         * @type {string}
+         * @default "json"
+         * @private
+         */
+        this._$format = "json";
+    }
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class LoaderInfo]
+     * @method
+     * @static
+     */
+    static toString() {
+        return "[class LoaderInfo]";
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.display.LoaderInfo
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.display.LoaderInfo";
+    }
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object LoaderInfo]
+     * @method
+     * @public
+     */
+    toString() {
+        return "[object LoaderInfo]";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.display.LoaderInfo
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.display.LoaderInfo";
+    }
+    /**
+     * @description そのメディアのロード済みのバイト数です。
+     *              The uint of bytes that are loaded for the media.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get bytesLoaded() {
+        return this._$bytesLoaded;
+    }
+    set bytesLoaded(bytes_loaded) {
+        this._$bytesLoaded = bytes_loaded | 0;
+    }
+    /**
+     * @description メディアファイル全体のバイト数です。
+     *              The number of bytes in the entire media file.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get bytesTotal() {
+        return this._$bytesTotal;
+    }
+    set bytesTotal(bytes_total) {
+        this._$bytesTotal = bytes_total | 0;
+    }
+    /**
+     * @description LoaderInfo オブジェクトに関係したロードされたオブジェクトです。
+     *              The loaded object associated with this LoaderInfo object.
+     *
+     * @member {DisplayObject}
+     * @public
+     */
+    get content() {
+        return this._$content;
+    }
+    set content(content) {
+        this._$content = content;
+    }
+    /**
+     * @description 読み込まれるメディアの URL です。
+     *              The URL of the media being loaded.
+     *
+     * @member {string}
+     * @default ""
+     * @readonly
+     * @public
+     */
+    get url() {
+        return this._$url;
+    }
+    set url(url) {
+        this._$url = url;
+    }
+    /**
+     * @description 読み込まれるメディアの データフォーマット です。
+     *              The data format of the media being loaded.
+     *
+     * @member {string}
+     * @default "json"
+     * @public
+     */
+    get format() {
+        return this._$format;
+    }
+    set format(format) {
+        this._$format = format;
+    }
+}