@next2d/display 1.18.12 → 2.0.0

package/src/Shape.js

@@ -0,0 +1,235 @@
+import { DisplayObject } from "./DisplayObject";
+import { Graphics } from "./Graphics";
+import { BitmapData } from "./BitmapData";
+import { execute as shapeClearBitmapBufferService } from "./Shape/usecase/ShapeClearBitmapBufferUseCase";
+import { execute as shapeSetBitmapBufferUseCase } from "./Shape/usecase/ShapeSetBitmapBufferUseCase";
+import { execute as shapeLoadSrcUseCase } from "./Shape/usecase/ShapeLoadSrcUseCase";
+import { execute as shapeBuildFromCharacterUseCase } from "./Shape/usecase/ShapeBuildFromCharacterUseCase";
+import { $graphicMap, $getArray } from "./DisplayObjectUtil";
+/**
+ * @description Shape クラスは、ベクターグラフィックスを表示するための表示オブジェクトです。
+ *              The Shape class is a display object for displaying vector graphics.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  DisplayObject
+ */
+export class Shape extends DisplayObject {
+    /**
+     * @constructor
+     * @public
+     */
+    constructor() {
+        super();
+        /**
+         * @type {Graphics}
+         * @default null
+         * @private
+         */
+        Object.defineProperty(this, "_$graphics", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @type {string}
+         * @default ""
+         * @private
+         */
+        Object.defineProperty(this, "_$src", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description Shapeの機能を所持しているかを返却
+         *              Returns whether the display object has Shape functionality.
+         *
+         * @type {boolean}
+         * @readonly
+         * @public
+         */
+        Object.defineProperty(this, "isShape", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description ビルドされたキャッシュキー
+         *              Built cache key
+         *
+         * @type {number}
+         * @default 0
+         * @public
+         */
+        Object.defineProperty(this, "cacheKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description キャッシュのビルドに利用されるパラメータ
+         *              Parameters used to build the cache
+         *
+         * @type {number[]}
+         * @public
+         */
+        Object.defineProperty(this, "cacheParams", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description ビットマップ描画の判定フラグ
+         *              Bitmap drawing judgment flag
+         *
+         * @type {boolean}
+         * @default false
+         * @protected
+         */
+        Object.defineProperty(this, "isBitmap", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description 画像RGBAのUint8Array
+         *              Image RGBA Uint8Array
+         *
+         * @type {Uint8Array|null}
+         * @default null
+         * @protected
+         */
+        Object.defineProperty(this, "$bitmapBuffer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.isShape = true;
+        this.cacheKey = 0;
+        this.cacheParams = $getArray(0, 0, 0);
+        // private
+        this._$graphics = null;
+        this._$src = "";
+        // bitmap
+        this.$bitmapBuffer = null;
+        this.isBitmap = false;
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return {string}
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.display.Shape";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return {string}
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.display.Shape";
+    }
+    /**
+     * @description この Shape オブジェクトに描画されるベクターの描画コマンドを保持する Graphics オブジェクトです。
+     *              The Graphics object that belongs to this Shape object, where vector drawing commands can occur.
+     *
+     * @member  {Graphics}
+     * @readonly
+     * @public
+     */
+    get graphics() {
+        if (!this._$graphics) {
+            this._$graphics = new Graphics();
+            $graphicMap.set(this._$graphics, this);
+        }
+        return this._$graphics;
+    }
+    /**
+     * @description 指定されたパスから画像を読み込み、Graphicsを生成します
+     *              Reads images from the specified path and generates Graphics.
+     *
+     * @member  {string}
+     * @readonly
+     * @public
+     */
+    get src() {
+        return this._$src;
+    }
+    set src(src) {
+        if (this._$src === src) {
+            return;
+        }
+        this._$src = src;
+        shapeLoadSrcUseCase(this, src);
+    }
+    /**
+     * @description ビットマップデータを返します
+     *              Returns the bitmap data.
+     *
+     * @return {BitmapData}
+     * @readonly
+     * @public
+     */
+    get bitmapData() {
+        const bitmapData = new BitmapData(this.width, this.height);
+        if (this.$bitmapBuffer) {
+            bitmapData.buffer = this.$bitmapBuffer;
+        }
+        return bitmapData;
+    }
+    /**
+     * @description ビットマップデータを解放します
+     *              Releases bitmap data.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    clearBitmapBuffer() {
+        shapeClearBitmapBufferService(this);
+    }
+    /**
+     * @description RGBAの画像データを設定します
+     *              Sets the RGBA image data.
+     *
+     * @param {number} width
+     * @param {number} height
+     * @param {Uint8Array} buffer
+     * @method
+     * @public
+     */
+    setBitmapBuffer(width, height, buffer) {
+        shapeSetBitmapBufferUseCase(this, width, height, buffer);
+    }
+    /**
+     * @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);
+        }
+        shapeBuildFromCharacterUseCase(this, character);
+    }
+}

package/src/Sprite/service/SpriteStartDragService.d.ts

@@ -0,0 +1,14 @@
+import type { Sprite } from "../../Sprite";
+import type { Rectangle } from "@next2d/geom";
+/**
+ * @description ドラッグを開始します。
+ *              Starts dragging.
+ *
+ * @param  {Sprite} sprite
+ * @param  {boolean} [lock_center=false]
+ * @param  {Rectangle|null} [bounds=null]
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: <D extends Sprite>(sprite: D, lock_center?: boolean, bounds?: Rectangle | null) => void;

package/src/Sprite/service/SpriteStartDragService.js

@@ -0,0 +1,22 @@
+import { $pointer, $setDraggingDisplayObject } from "../../DisplayObjectUtil";
+/**
+ * @description ドラッグを開始します。
+ *              Starts dragging.
+ *
+ * @param  {Sprite} sprite
+ * @param  {boolean} [lock_center=false]
+ * @param  {Rectangle|null} [bounds=null]
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (sprite, lock_center = false, bounds = null) => {
+    const point = sprite.parent
+        ? sprite.parent.globalToLocal($pointer)
+        : sprite.globalToLocal($pointer);
+    sprite.$lockCenter = lock_center;
+    sprite.$offsetX = sprite.x - point.x;
+    sprite.$offsetY = sprite.y - point.y;
+    sprite.$boundedRect = bounds;
+    $setDraggingDisplayObject(sprite);
+};

package/src/Sprite/service/SpriteStopDragService.d.ts

@@ -0,0 +1,11 @@
+import type { Sprite } from "../../Sprite";
+/**
+ * @description startDrag() メソッドを終了して、ドラッグ変数をリセットします。
+ *              Ends the startDrag() method and resets the drag variables.
+ *
+ * @param  {Sprite} sprite
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: <D extends Sprite>(sprite: D) => void;

package/src/Sprite/service/SpriteStopDragService.js

@@ -0,0 +1,17 @@
+import { $setDraggingDisplayObject } from "../../DisplayObjectUtil";
+/**
+ * @description startDrag() メソッドを終了して、ドラッグ変数をリセットします。
+ *              Ends the startDrag() method and resets the drag variables.
+ *
+ * @param  {Sprite} sprite
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (sprite) => {
+    sprite.$lockCenter = false;
+    sprite.$offsetX = 0;
+    sprite.$offsetY = 0;
+    sprite.$boundedRect = null;
+    $setDraggingDisplayObject(null);
+};

package/src/Sprite.d.ts

@@ -0,0 +1,126 @@
+import type { ISprite } from "./interface/ISprite";
+import type { Rectangle } from "@next2d/geom";
+import type { SoundTransform } from "@next2d/media";
+import { DisplayObjectContainer } from "./DisplayObjectContainer";
+/**
+ * @description Sprite クラスは、表示リストの基本的要素です。
+ *              グラフィックを表示でき、子を持つこともできる表示リストノードです。
+ *
+ *              The Sprite class is a basic display list building block:
+ *              a display list node that can display graphics and can also contain children.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  DisplayObjectContainer
+ */
+export declare class Sprite extends DisplayObjectContainer {
+    /**
+     * @description このスプライトのボタンモードを指定します。
+     *              Specifies the button mode of this sprite.
+     *
+     * @member  {boolean}
+     * @default false
+     * @public
+     */
+    buttonMode: boolean;
+    /**
+     * @description buttonMode プロパティが true に設定されたスプライト上にポインターが移動したときに、
+     *              指差しハンドポインター（ハンドカーソル）を表示するかどうかを示すブール値です。
+     *              A Boolean value that indicates whether the pointing hand (hand cursor)
+     *              appears when the pointer rolls over a sprite
+     *              in which the buttonMode property is set to true.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    useHandCursor: boolean;
+    /**
+     * @description Spriteの機能を所持しているかを返却
+     *              Returns whether Sprite functions are possessed.
+     *
+     * @type {boolean}
+     * @readonly
+     * @public
+     */
+    readonly isSprite: boolean;
+    /**
+     * @description スプライトのヒット領域となる別のスプライトを指定します。
+     *              Designates another sprite to serve as the hit area for a sprite.
+     *
+     * @type {Sprite|null}
+     * @private
+     */
+    hitArea: ISprite<any> | null;
+    /**
+     * @type {SoundTransform|null}
+     * @private
+     */
+    private _$soundTransform;
+    /**
+     * @description ドラッグ時のオフセットX
+     *              Offset X during drag
+     *
+     * @type {number}
+     * @public
+     */
+    $offsetX: number;
+    /**
+     * @description ドラッグ時のオフセットY
+     *              Offset Y during drag
+     *
+     * @type {number}
+     * @public
+     */
+    $offsetY: number;
+    /**
+     * @description 中心をロックするかどうか
+     *              Whether to lock the center
+     *
+     * @type {boolean}
+     * @public
+     */
+    $lockCenter: boolean;
+    /**
+     * @description バウンドされた矩形
+     *              Bounded rectangle
+     *
+     * @type {Rectangle|null}
+     * @public
+     */
+    $boundedRect: Rectangle | null;
+    /**
+     * @constructor
+     * @public
+     */
+    constructor();
+    /**
+     * @description このスプライト内のサウンドを制御します。
+     *              Controls sound within this sprite.
+     *
+     * @member {SoundTransform | null}
+     * @public
+     */
+    get soundTransform(): SoundTransform | null;
+    set soundTransform(sound_transform: SoundTransform | null);
+    /**
+     * @description 指定されたスプライトをユーザーがドラッグできるようにします。
+     *              Lets the user drag the specified sprite.
+     *
+     * @param  {boolean}   [lock_center=false]
+     * @param  {Rectangle} [bounds=null]
+     * @return {void}
+     * @method
+     * @public
+     */
+    startDrag(lock_center?: boolean, bounds?: Rectangle | null): void;
+    /**
+     * @description startDrag() メソッドを終了します。
+     *              Ends the startDrag() method.
+     *
+     * @return void
+     * @method
+     * @public
+     */
+    stopDrag(): void;
+}

package/src/Sprite.js

@@ -0,0 +1,192 @@
+import { DisplayObjectContainer } from "./DisplayObjectContainer";
+import { execute as spriteStartDragService } from "./Sprite/service/SpriteStartDragService";
+import { execute as spriteStopDragService } from "./Sprite/service/SpriteStopDragService";
+/**
+ * @description Sprite クラスは、表示リストの基本的要素です。
+ *              グラフィックを表示でき、子を持つこともできる表示リストノードです。
+ *
+ *              The Sprite class is a basic display list building block:
+ *              a display list node that can display graphics and can also contain children.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  DisplayObjectContainer
+ */
+export class Sprite extends DisplayObjectContainer {
+    /**
+     * @constructor
+     * @public
+     */
+    constructor() {
+        super();
+        /**
+         * @description このスプライトのボタンモードを指定します。
+         *              Specifies the button mode of this sprite.
+         *
+         * @member  {boolean}
+         * @default false
+         * @public
+         */
+        Object.defineProperty(this, "buttonMode", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description buttonMode プロパティが true に設定されたスプライト上にポインターが移動したときに、
+         *              指差しハンドポインター（ハンドカーソル）を表示するかどうかを示すブール値です。
+         *              A Boolean value that indicates whether the pointing hand (hand cursor)
+         *              appears when the pointer rolls over a sprite
+         *              in which the buttonMode property is set to true.
+         *
+         * @member  {boolean}
+         * @default true
+         * @public
+         */
+        Object.defineProperty(this, "useHandCursor", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description Spriteの機能を所持しているかを返却
+         *              Returns whether Sprite functions are possessed.
+         *
+         * @type {boolean}
+         * @readonly
+         * @public
+         */
+        Object.defineProperty(this, "isSprite", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description スプライトのヒット領域となる別のスプライトを指定します。
+         *              Designates another sprite to serve as the hit area for a sprite.
+         *
+         * @type {Sprite|null}
+         * @private
+         */
+        Object.defineProperty(this, "hitArea", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @type {SoundTransform|null}
+         * @private
+         */
+        Object.defineProperty(this, "_$soundTransform", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description ドラッグ時のオフセットX
+         *              Offset X during drag
+         *
+         * @type {number}
+         * @public
+         */
+        Object.defineProperty(this, "$offsetX", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        /**
+         * @description ドラッグ時のオフセットY
+         *              Offset Y during drag
+         *
+         * @type {number}
+         * @public
+         */
+        Object.defineProperty(this, "$offsetY", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        /**
+         * @description 中心をロックするかどうか
+         *              Whether to lock the center
+         *
+         * @type {boolean}
+         * @public
+         */
+        Object.defineProperty(this, "$lockCenter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        /**
+         * @description バウンドされた矩形
+         *              Bounded rectangle
+         *
+         * @type {Rectangle|null}
+         * @public
+         */
+        Object.defineProperty(this, "$boundedRect", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        // public
+        this.isSprite = true;
+        this.buttonMode = false;
+        this.useHandCursor = true;
+        this.hitArea = null;
+        // drag rules
+        this.$offsetX = 0;
+        this.$offsetY = 0;
+        this.$lockCenter = false;
+        this.$boundedRect = null;
+        // private
+        this._$soundTransform = null;
+    }
+    /**
+     * @description このスプライト内のサウンドを制御します。
+     *              Controls sound within this sprite.
+     *
+     * @member {SoundTransform | null}
+     * @public
+     */
+    get soundTransform() {
+        return this._$soundTransform;
+    }
+    set soundTransform(sound_transform) {
+        this._$soundTransform = sound_transform;
+    }
+    /**
+     * @description 指定されたスプライトをユーザーがドラッグできるようにします。
+     *              Lets the user drag the specified sprite.
+     *
+     * @param  {boolean}   [lock_center=false]
+     * @param  {Rectangle} [bounds=null]
+     * @return {void}
+     * @method
+     * @public
+     */
+    startDrag(lock_center = false, bounds = null) {
+        spriteStartDragService(this, lock_center, bounds);
+    }
+    /**
+     * @description startDrag() メソッドを終了します。
+     *              Ends the startDrag() method.
+     *
+     * @return void
+     * @method
+     * @public
+     */
+    stopDrag() {
+        spriteStopDragService(this);
+    }
+}

package/src/Stage/service/StageExecuteFrameActionsService.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @description フレームアクションがなくなるまで実行
+ *              Execute until there are no frame actions
+ *
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: () => void;

package/src/Stage/service/StageExecuteFrameActionsService.js

@@ -0,0 +1,34 @@
+import { $actions } from "../../DisplayObjectUtil";
+/**
+ * @description フレームアクションがなくなるまで実行
+ *              Execute until there are no frame actions
+ *
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = () => {
+    while ($actions.length) {
+        const movieClip = $actions.pop();
+        const actionMap = movieClip.$actions;
+        if (!actionMap) {
+            continue;
+        }
+        const frame = movieClip.currentFrame;
+        if (!actionMap.has(frame)) {
+            continue;
+        }
+        const actions = actionMap.get(frame);
+        if (!actions) {
+            continue;
+        }
+        for (let idx = 0; idx < actions.length; idx++) {
+            try {
+                actions[idx].apply(movieClip);
+            }
+            catch (error) {
+                console.error(error);
+            }
+        }
+    }
+};

package/src/Stage/service/StageExecuteFrameSoundsService.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @description フレームにセットされたサウンドを再生
+ *              Play the sound set in the frame
+ *
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: () => void;