@next2d/display 1.18.12 → 2.0.0

package/src/MovieClip.js

@@ -0,0 +1,409 @@
+import { Sprite } from "./Sprite";
+import { execute as movieClipGetChildrenService } from "./MovieClip/service/MovieClipGetChildrenService";
+import { execute as movieClipAddFrameLabelService } from "./MovieClip/service/MovieClipAddFrameLabelService";
+import { execute as movieClipCurrentFrameLabelService } from "./MovieClip/service/MovieClipCurrentFrameLabelService";
+import { execute as movieClipCurrentLabelsService } from "./MovieClip/service/MovieClipCurrentLabelsService";
+import { execute as displayObjectApplyChangesService } from "./DisplayObject/service/DisplayObjectApplyChangesService";
+import { execute as movieClipGotoAndPlayUseCase } from "./MovieClip/usecase/MovieClipGotoAndPlayUseCase";
+import { execute as movieClipGotoAndStopUseCase } from "./MovieClip/usecase/MovieClipGotoAndStopUseCase";
+import { execute as movieClipNextFrameUseCase } from "./MovieClip/usecase/MovieClipNextFrameUseCase";
+import { execute as movieClipPrevFrameUseCase } from "./MovieClip/usecase/MovieClipPrevFrameUseCase";
+import { execute as movieClipBuildFromCharacterUseCase } from "./MovieClip/usecase/MovieClipBuildFromCharacterUseCase";
+/**
+ * @description MovieClip クラスは、Sprite、DisplayObjectContainer、InteractiveObject、DisplayObject
+ *              および EventDispatcher クラスを継承します。
+ *              MovieClip オブジェクトには、Sprite オブジェクトとは違ってタイムラインがあります。
+ *              タイムラインの再生ヘッドが停止されても、その MovieClip オブジェクトの子 MovieClip オブジェクトの再生ヘッドは停止しません。
+ *
+ *              The MovieClip class inherits from the following classes: Sprite, DisplayObjectContainer,
+ *              InteractiveObject, DisplayObject, and EventDispatcher.
+ *              Unlike the Sprite object, a MovieClip object has a timeline.
+ *              When the playback head of the timeline is stopped,
+ *              the playback head of the child MovieClip object of that MovieClip object will not be stopped.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  Sprite
+ */
+export class MovieClip extends Sprite {
+    /**
+     * @constructor
+     * @public
+     */
+    constructor() {
+        super();
+        /**
+         * @description フレーム毎のラベルマップ
+         *              Label map per frame
+         *
+         * @type {Map<number, FrameLabel>}
+         * @default null
+         * @private
+         */
+        Object.defineProperty(this, "$labels", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description フレーム毎のアクションマップ
+         *              Action map per frame
+         *
+         * @type {Map<number, Function[]>}
+         * @default null
+         * @private
+         */
+        Object.defineProperty(this, "$actions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description フレーム毎のサウンドマップ
+         *              Sound map per frame
+         *
+         * @type {Map<number, Sound[]>}
+         * @default null
+         * @private
+         */
+        Object.defineProperty(this, "$sounds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description アクション実行フラグ
+         *              Action execution flag
+         *
+         * @type {boolean}
+         * @default true
+         * @private
+         */
+        Object.defineProperty(this, "$canAction", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description 待機フラグ
+         *              Wait flag
+         *
+         * @type {boolean}
+         * @default false
+         * @private
+         */
+        Object.defineProperty(this, "$wait", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description MovieClip インスタンス内のフレーム総数です。
+         *              The total number of frames in the MovieClip instance.
+         *
+         * @member  {number}
+         * @default 1
+         * @readonly
+         * @public
+         */
+        Object.defineProperty(this, "totalFrames", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description MovieClipのタイムライン内の再生ヘッドが置かれているフレームの番号を示します。
+         *              Specifies the number of the frame in which the playhead is located
+         *
+         * @member {number}
+         * @default 1
+         * @readonly
+         * @public
+         */
+        Object.defineProperty(this, "currentFrame", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description 停止フラグ
+         *              Stop flag
+         *
+         * @type {boolean}
+         * @default false
+         * @private
+         */
+        Object.defineProperty(this, "_$stopFlag", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description サウンド実行フラグ
+         *              Sound execution flag
+         *
+         * @type {boolean}
+         * @default true
+         * @private
+         */
+        Object.defineProperty(this, "$canSound", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description タイムラインヘッドが移動したかどうか
+         *              Whether the timeline head has moved
+         *
+         * @type {boolean}
+         * @default true
+         * @private
+         */
+        Object.defineProperty(this, "$hasTimelineHeadMoved", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description MovieClipの機能を所持しているかを返却
+         *              Returns whether the display object has MovieClip functionality.
+         *
+         * @type {boolean}
+         * @readonly
+         * @public
+         */
+        Object.defineProperty(this, "isTimelineEnabled", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        // public
+        this.currentFrame = 1;
+        this.totalFrames = 1;
+        this.isTimelineEnabled = true;
+        // protected
+        this.$actions = null;
+        this.$labels = null;
+        this.$sounds = null;
+        this.$canAction = true;
+        this.$wait = false;
+        this.$canSound = true;
+        this.$hasTimelineHeadMoved = true;
+        // private
+        this._$stopFlag = false;
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return {string}
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.display.MovieClip";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return {string}
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.display.MovieClip";
+    }
+    /**
+     * @description コンテナのアクティブな子要素を返却
+     *              Returns the active child elements of the container.
+     *
+     * @return {array}
+     * @method
+     * @protected
+     */
+    get children() {
+        if (!this.$hasTimelineHeadMoved || this.characterId === -1) {
+            return this._$children;
+        }
+        this.$hasTimelineHeadMoved = false;
+        return movieClipGetChildrenService(this, this._$children);
+    }
+    /**
+     * @description MovieClip インスタンスのタイムライン内の現在のフレームにあるラベルです。
+     *              The label at the current frame in the timeline of the MovieClip instance.
+     *
+     * @member  {FrameLabel|null}
+     * @readonly
+     * @public
+     */
+    get currentFrameLabel() {
+        return movieClipCurrentFrameLabelService(this);
+    }
+    /**
+     * @description 現在のシーンの FrameLabel オブジェクトの配列を返します。
+     *              Returns an array of FrameLabel objects from the current scene.
+     *
+     * @member  {FrameLabel[]|null}
+     * @readonly
+     * @public
+     */
+    get currentLabels() {
+        return movieClipCurrentLabelsService(this);
+    }
+    /**
+     * @description ムービークリップが現在再生されているかどうかを示すブール値です。
+     *              A Boolean value that indicates whether a movie clip is curently playing.
+     *
+     * @member  {boolean}
+     * @default false
+     * @readonly
+     * @public
+     */
+    get isPlaying() {
+        return !this._$stopFlag;
+    }
+    /**
+     * @description MovieClipのフレームヘッダーの移動方法の設定オブジェクトを返します。
+     *              Returns a configuration object for how MovieClip's frame headers are moved.
+     *
+     * @member  {object}
+     * @default null
+     * @public
+     */
+    // get loopConfig (): LoopConfigImpl | null
+    // {
+    //     if (this._$loopConfig) {
+    //         return this._$loopConfig;
+    //     }
+    //     const place: PlaceObjectImpl | null = this._$placeObject || this._$getPlaceObject();
+    //     if (!place || !place.loop) {
+    //         return null;
+    //     }
+    //     if (this._$tweenFrame) {
+    //         this._$changePlace = this._$tweenFrame !== this._$parent._$currentFrame;
+    //         this._$tweenFrame  = 0;
+    //     }
+    //     if (place.loop.tweenFrame) {
+    //         this._$tweenFrame = place.loop.tweenFrame;
+    //     }
+    //     return place.loop;
+    // }
+    // set loopConfig (loop_config: LoopConfigImpl | null)
+    // {
+    //     this._$loopConfig = loop_config;
+    //     if (loop_config) {
+    //         loop_config.frame   = this._$startFrame;
+    //         this._$loopConfig   = loop_config;
+    //         this._$currentFrame = this._$getLoopFrame(loop_config);
+    //     }
+    // }
+    /**
+     * @description 指定されたフレームで SWF ファイルの再生を開始します。
+     *              Starts playing the SWF file at the specified frame.
+     *
+     * @param  {string|number} frame
+     * @return {void}
+     * @method
+     * @public
+     */
+    gotoAndPlay(frame) {
+        movieClipGotoAndPlayUseCase(this, frame);
+    }
+    /**
+     * @description このムービークリップの指定されたフレームに再生ヘッドを送り、そこで停止させます。
+     *              Brings the playhead to the specified frame
+     *              of the movie clip and stops it there.
+     *
+     * @param  {number|string} frame
+     * @return {void}
+     * @method
+     * @public
+     */
+    gotoAndStop(frame) {
+        movieClipGotoAndStopUseCase(this, frame);
+    }
+    /**
+     * @description 次のフレームに再生ヘッドを送り、停止します。
+     *              Sends the playhead to the next frame and stops it.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    nextFrame() {
+        movieClipNextFrameUseCase(this);
+    }
+    /**
+     * @description ムービークリップのタイムライン内で再生ヘッドを移動します。
+     *              Moves the playhead in the timeline of the movie clip.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    play() {
+        this._$stopFlag = false;
+        displayObjectApplyChangesService(this);
+    }
+    /**
+     * @description 直前のフレームに再生ヘッドを戻し、停止します。
+     *              Sends the playhead to the previous frame and stops it.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    prevFrame() {
+        movieClipPrevFrameUseCase(this);
+    }
+    /**
+     * @description ムービークリップ内の再生ヘッドを停止します。
+     *              Stops the playhead in the movie clip.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    stop() {
+        this._$stopFlag = true;
+    }
+    /**
+     * @description タイムラインに対して動的にLabelを追加できます。
+     *              Labels can be added dynamically to the timeline.
+     *
+     * @param  {FrameLabel} frame_label
+     * @return {void}
+     * @public
+     */
+    addFrameLabel(frame_label) {
+        movieClipAddFrameLabelService(this, frame_label);
+    }
+    /**
+     * @description character 情報を元に DisplayObject を構築
+     *              Build DisplayObject based on character
+     *
+     * @param  {ICharacter} character
+     * @param  {LoaderInfo} [loader_info=null]
+     * @return {void}
+     * @method
+     * @protected
+     */
+    $sync(character, loader_info = null) {
+        if (loader_info) {
+            super.$syncLoaderInfo(loader_info);
+        }
+        movieClipBuildFromCharacterUseCase(this, character);
+    }
+}

package/src/Shape/service/ShapeGetRawBoundsService.d.ts

@@ -0,0 +1,10 @@
+import type { Shape } from "../../Shape";
+/**
+ * @description Shapeのローカルバウンディングボックスを取得します。
+ *              Get the local bounding box of the Shape.
+ *
+ * @param  {Shape} shape
+ * @return {Float32Array}
+ * @protected
+ */
+export declare const execute: (shape: Shape) => Float32Array;

package/src/Shape/service/ShapeGetRawBoundsService.js

@@ -0,0 +1,13 @@
+import { $getBoundsArray } from "../../DisplayObjectUtil";
+/**
+ * @description Shapeのローカルバウンディングボックスを取得します。
+ *              Get the local bounding box of the Shape.
+ *
+ * @param  {Shape} shape
+ * @return {Float32Array}
+ * @protected
+ */
+export const execute = (shape) => {
+    const graphics = shape.graphics;
+    return $getBoundsArray(graphics.xMin, graphics.yMin, graphics.xMax, graphics.yMax);
+};

package/src/Shape/usecase/ShapeBuildFromCharacterUseCase.d.ts

@@ -0,0 +1,13 @@
+import type { Shape } from "../../Shape";
+import type { IShapeCharacter } from "../../interface/IShapeCharacter";
+/**
+ * @description characterを元にShapeを構築
+ *              Build Shape based on character
+ *
+ * @param  {Shape} shape
+ * @param  {object} character
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (shape: Shape, character: IShapeCharacter) => void;

package/src/Shape/usecase/ShapeBuildFromCharacterUseCase.js

@@ -0,0 +1,121 @@
+import { execute as graphicsToNumberArrayService } from "../../Graphics/service/GraphicsToNumberArrayService";
+import { $poolArray } from "../../DisplayObjectUtil";
+import { BitmapData } from "../../BitmapData";
+import { Graphics } from "../../Graphics";
+import { Rectangle } from "@next2d/geom";
+/**
+ * @description characterを元にShapeを構築
+ *              Build Shape based on character
+ *
+ * @param  {Shape} shape
+ * @param  {object} character
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (shape, character) => {
+    const graphics = shape.graphics;
+    const width = Math.ceil(Math.abs(character.bounds.xMax - character.bounds.xMin));
+    const height = Math.ceil(Math.abs(character.bounds.yMax - character.bounds.yMin));
+    switch (true) {
+        case character.bitmapId > 0:
+            {
+                const loaderInfo = shape.loaderInfo;
+                const bitmap = loaderInfo.data?.characters[character.bitmapId];
+                if (!bitmap) {
+                    break;
+                }
+                shape.isBitmap = true;
+                if (!bitmap.imageBuffer) {
+                    bitmap.imageBuffer = new Uint8Array(bitmap.buffer);
+                    bitmap.buffer = null;
+                }
+                const bitmapWidth = Math.ceil(Math.abs(bitmap.bounds.xMax - bitmap.bounds.xMin));
+                const bitmapHeight = Math.ceil(Math.abs(bitmap.bounds.yMax - bitmap.bounds.yMin));
+                if (character.grid) {
+                    // 9slice image
+                    if (character.recodes) {
+                        const recodes = character.recodes.slice(0);
+                        recodes.splice(-6, 6);
+                        const bitmapData = new BitmapData(bitmapWidth, bitmapHeight);
+                        bitmapData.buffer = bitmap.imageBuffer;
+                        recodes.push(Graphics.BITMAP_FILL, bitmapData, null, true, false, 9);
+                        const numberArray = graphicsToNumberArrayService(recodes);
+                        graphics.buffer = new Float32Array(numberArray);
+                        $poolArray(recodes);
+                        $poolArray(numberArray);
+                    }
+                }
+                else {
+                    // draw image
+                    if (width === bitmapWidth && height === bitmapHeight) {
+                        shape.setBitmapBuffer(Math.ceil(Math.abs(bitmap.bounds.xMax - bitmap.bounds.xMin)), Math.ceil(Math.abs(bitmap.bounds.yMax - bitmap.bounds.yMin)), bitmap.imageBuffer);
+                    }
+                    else {
+                        const bitmapData = new BitmapData(bitmapWidth, bitmapHeight);
+                        bitmapData.buffer = bitmap.imageBuffer;
+                        if (character.recodes) {
+                            const type = character.recodes[character.recodes.length - 10];
+                            if (type === Graphics.BITMAP_STROKE) {
+                                const recodes = character.recodes.slice(0);
+                                recodes.splice(-5, 5);
+                                recodes.push(bitmapData, null, true, false);
+                                const numberArray = graphicsToNumberArrayService(recodes);
+                                graphics.buffer = new Float32Array(numberArray);
+                                $poolArray(recodes);
+                                $poolArray(numberArray);
+                            }
+                            else {
+                                graphics
+                                    .beginBitmapFill(bitmapData)
+                                    .drawRect(0, 0, width, height);
+                            }
+                        }
+                    }
+                }
+            }
+            break;
+        case character.inBitmap: // to swf only
+            {
+                shape.isBitmap = true;
+                const recodes = character.recodes;
+                const bitmap = recodes[recodes.length - 4];
+                if (width === bitmap.width && height === bitmap.height) {
+                    shape.setBitmapBuffer(bitmap.width, bitmap.height, bitmap.buffer);
+                }
+                else {
+                    const bitmapData = new BitmapData(bitmap.width, bitmap.height);
+                    bitmapData.buffer = bitmap.buffer;
+                    graphics
+                        .beginBitmapFill(bitmapData)
+                        .drawRect(0, 0, width, height);
+                }
+            }
+            break;
+        case "buffer" in character: // bitmap
+            if (!character.imageBuffer) {
+                character.imageBuffer = new Uint8Array(character.buffer);
+                character.buffer = null;
+            }
+            shape.setBitmapBuffer(Math.ceil(Math.abs(graphics.xMax - graphics.xMin)), Math.ceil(Math.abs(graphics.yMax - graphics.yMin)), character.imageBuffer);
+            break;
+        default: // normal shape
+            if (character.recodes) {
+                character.recodeBuffer = new Float32Array(graphicsToNumberArrayService(character.recodes));
+                $poolArray(character.recodes);
+                character.recodes = null;
+            }
+            if (character.recodeBuffer) {
+                graphics.buffer = character.recodeBuffer;
+            }
+            break;
+    }
+    // fixed logic
+    graphics.xMin = character.bounds.xMin;
+    graphics.xMax = character.bounds.xMax;
+    graphics.yMin = character.bounds.yMin;
+    graphics.yMax = character.bounds.yMax;
+    if (character.grid) {
+        shape.scale9Grid = new Rectangle(character.grid.x, character.grid.y, character.grid.w, character.grid.h);
+    }
+};

package/src/Shape/usecase/ShapeCalcBoundsMatrixUseCase.d.ts

@@ -0,0 +1,12 @@
+import type { Shape } from "../../Shape";
+/**
+ * @description Shapeの描画範囲を計算します。
+ *              Calculate the drawing area of Shape.
+ *
+ * @param  {Shape} shape
+ * @param  {Float32Array | null} [matrix=null]
+ * @return {number[]}
+ * @method
+ * @protected
+ */
+export declare const execute: (shape: Shape, matrix?: Float32Array | null) => Float32Array;

package/src/Shape/usecase/ShapeCalcBoundsMatrixUseCase.js

@@ -0,0 +1,30 @@
+import { Matrix } from "@next2d/geom";
+import { execute as displayObjectCalcBoundsMatrixService } from "../../DisplayObject/service/DisplayObjectCalcBoundsMatrixService";
+import { execute as shapeGetRawBoundsService } from "../service/ShapeGetRawBoundsService";
+import { execute as displayObjectGetRawMatrixUseCase } from "../../DisplayObject/usecase/DisplayObjectGetRawMatrixUseCase";
+import { $poolBoundsArray } from "../../DisplayObjectUtil";
+/**
+ * @description Shapeの描画範囲を計算します。
+ *              Calculate the drawing area of Shape.
+ *
+ * @param  {Shape} shape
+ * @param  {Float32Array | null} [matrix=null]
+ * @return {number[]}
+ * @method
+ * @protected
+ */
+export const execute = (shape, matrix = null) => {
+    const rawBounds = shapeGetRawBoundsService(shape);
+    const rawMatrix = displayObjectGetRawMatrixUseCase(shape);
+    if (!rawMatrix) {
+        if (matrix) {
+            const calcBounds = displayObjectCalcBoundsMatrixService(rawBounds[0], rawBounds[1], rawBounds[2], rawBounds[3], matrix);
+            $poolBoundsArray(rawBounds);
+            return calcBounds;
+        }
+        return rawBounds;
+    }
+    const calcBounds = displayObjectCalcBoundsMatrixService(rawBounds[0], rawBounds[1], rawBounds[2], rawBounds[3], matrix ? Matrix.multiply(matrix, rawMatrix) : rawMatrix);
+    $poolBoundsArray(rawBounds);
+    return calcBounds;
+};

package/src/Shape/usecase/ShapeClearBitmapBufferUseCase.d.ts

@@ -0,0 +1,11 @@
+import type { Shape } from "../../Shape";
+/**
+ * @description BitmapBufferの設定をクリア
+ *              Clear the BitmapBuffer settings
+ *
+ * @param  {Shape} shape
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (shape: Shape) => void;

package/src/Shape/usecase/ShapeClearBitmapBufferUseCase.js

@@ -0,0 +1,24 @@
+import { $cacheStore } from "@next2d/cache";
+import { execute as displayObjectApplyChangesService } from "../../DisplayObject/service/DisplayObjectApplyChangesService";
+/**
+ * @description BitmapBufferの設定をクリア
+ *              Clear the BitmapBuffer settings
+ *
+ * @param  {Shape} shape
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (shape) => {
+    shape.isBitmap = false;
+    shape.$bitmapBuffer = null;
+    // graphics clear
+    shape.graphics.clear();
+    // cache clear
+    if (shape.uniqueKey !== "" && $cacheStore.has(shape.uniqueKey)) {
+        $cacheStore.removeById(shape.uniqueKey);
+        $cacheStore.$removeIds.push(+shape.uniqueKey);
+    }
+    // apply changes
+    displayObjectApplyChangesService(shape);
+};

package/src/Shape/usecase/ShapeGenerateClipQueueUseCase.d.ts

@@ -0,0 +1,12 @@
+import type { Shape } from "../../Shape";
+/**
+ * @description renderer workerに渡すShapeのマスク描画データを生成
+ *              Generate mask drawing data of Shape to pass to renderer worker
+ *
+ * @param  {Shape} shape
+ * @param  {Float32Array} matrix
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (shape: Shape, matrix: Float32Array) => void;