@next2d/display 1.18.11 → 2.0.0

package/src/DisplayObjectUtil.js

@@ -0,0 +1,465 @@
+import { Point } from "@next2d/geom";
+/**
+ * @description 現在のマウスの座標情報
+ *              Current mouse coordinate information
+ *
+ * @type {Point}
+ * @private
+ */
+export const $pointer = new Point();
+/**
+ * @type {number}
+ * @const
+ */
+export const $RENDERER_CONTAINER_TYPE = 0x00;
+/**
+ * @type {number}
+ * @const
+ */
+export const $RENDERER_SHAPE_TYPE = 0x01;
+/**
+ * @type {number}
+ * @const
+ */
+export const $RENDERER_TEXT_TYPE = 0x02;
+/**
+ * @type {number}
+ * @const
+ */
+export const $RENDERER_VIDEO_TYPE = 0x03;
+/**
+ * @typs {Float32Array}
+ * @const
+ */
+export const $MATRIX_ARRAY_IDENTITY = new Float32Array([1, 0, 0, 1, 0, 0]);
+/**
+ * @type {number}
+ */
+let instanceId = 0;
+/**
+ * @description インスタンスユニークIDを返却
+ *              Returns the instance unique ID
+ *
+ * @return {number}
+ * @method
+ * @public
+ */
+export const $getInstanceId = () => {
+    return instanceId++;
+};
+/**
+ * @description 使用済みになったArrayのプール配列
+ *              Pool array of used Array.
+ *
+ * @type {array[]}
+ * @const
+ * @private
+ */
+const $arrays = [];
+/**
+ * @description 使用済みになったBoundsのArrayのプール配列
+ *              Pool array of used Bounds Array.
+ *
+ * @type {Float32Array[]}
+ * @const
+ * @private
+ */
+const $boundsArrays = [];
+/**
+ * @description 使用済みになったFloat32Arrayをプール、サイズは6固定
+ *              Pool used Float32Array, size fixed at 6.
+ *
+ * @type {Float32Array[]}
+ * @const
+ * @private
+ */
+const $float32Array6 = [];
+/**
+ * @description 使用済みになったFloat32Arrayをプール、サイズは8固定
+ *              Pool used Float32Array, size fixed at 8.
+ *
+ * @type {Float32Array[]}
+ * @const
+ * @private
+ */
+const $float32Array8 = [];
+/**
+ * @description プールされたFloat32Arrayがあればプールから。なければ新規作成して返却、サイズは6固定
+ *              If there is a pooled Float32Array, it is taken from the pool.
+ *              If not, create a new one and return it. Size is fixed at 6.
+ *
+ * @param  {number} [f0=0]
+ * @param  {number} [f0=0]
+ * @param  {number} [f1=0]
+ * @param  {number} [f2=0]
+ * @param  {number} [f3=0]
+ * @param  {number} [f4=0]
+ * @param  {number} [f5=0]
+ * @return {Float32Array}
+ * @method
+ * @protected
+ */
+export const $getFloat32Array6 = (f0 = 0, f1 = 0, f2 = 0, f3 = 0, f4 = 0, f5 = 0) => {
+    const array = $float32Array6.pop() || new Float32Array(6);
+    array[0] = f0;
+    array[1] = f1;
+    array[2] = f2;
+    array[3] = f3;
+    array[4] = f4;
+    array[5] = f5;
+    return array;
+};
+/**
+ * @description 使用済みになったFloat32Arrayをプール
+ *              Pool used Float32Array.
+ *
+ * @param  {Float32Array} array
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const $poolFloat32Array6 = (array) => {
+    $float32Array6.push(array);
+};
+/**
+ * @description プールされたFloat32Arrayがあればプールから。なければ新規作成して返却、サイズは8固定
+ *              If there is a pooled Float32Array, it is taken from the pool.
+ *              If not, create a new one and return it. Size is fixed at 8.
+ *
+ * @param  {number} [f0=0]
+ * @param  {number} [f1=0]
+ * @param  {number} [f2=0]
+ * @param  {number} [f3=0]
+ * @param  {number} [f4=0]
+ * @param  {number} [f5=0]
+ * @param  {number} [f6=0]
+ * @param  {number} [f7=0]
+ * @return {Float32Array}
+ * @method
+ * @protected
+ */
+export const $getFloat32Array8 = (f0 = 1, f1 = 1, f2 = 1, f3 = 1, f4 = 0, f5 = 0, f6 = 0, f7 = 0) => {
+    const array = $float32Array8.pop() || new Float32Array(8);
+    array[0] = f0;
+    array[1] = f1;
+    array[2] = f2;
+    array[3] = f3;
+    array[4] = f4;
+    array[5] = f5;
+    array[6] = f6;
+    array[7] = f7;
+    return array;
+};
+/**
+ * @description 使用済みになったFloat32Arrayをプール
+ *              Pool used Float32Array.
+ *
+ * @param  {Float32Array} array
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const $poolFloat32Array8 = (array) => {
+    $float32Array8.push(array);
+};
+/**
+ * @type {Map}
+ * @private
+ */
+const $maps = [];
+/**
+ * @description プールされたMapがあればプールから、なければ新規作成して返却
+ *              If there is a pooled Map, return it from the pool,
+ *              otherwise create a new one and return it.
+ *
+ * @return {Map}
+ * @method
+ * @protected
+ */
+export const $getMap = () => {
+    return $maps.pop() || new Map();
+};
+/**
+ * @description 使用済みになったMapをプール
+ *              Pool used Map.
+ *
+ * @param  {Map} map
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const $poolMap = (map) => {
+    map.clear();
+    $maps.push(map);
+};
+/**
+ * @description プールされたArrayがあればプールから、なければ新規作成して返却
+ *              If there is a pooled Array, return it from the pool,
+ *              otherwise create a new one and return it.
+ *
+ * @param  {array} args
+ * @return {array}
+ * @method
+ * @protected
+ */
+export const $getArray = (...args) => {
+    const array = $arrays.pop() || [];
+    if (args.length) {
+        array.push(...args);
+    }
+    return array;
+};
+/**
+ * @description 使用済みになったArrayをプール
+ *              Pool used Array.
+ *
+ * @param  {array} array
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const $poolArray = (array) => {
+    if (array.length) {
+        array.length = 0;
+    }
+    $arrays.push(array);
+};
+/**
+ * @description プールされたArrayがあればプールから、なければ新規作成して返却
+ *              If there is a pooled Array, return it from the pool,
+ *              otherwise create a new one and return it.
+ *
+ * @param  {number} x_min
+ * @param  {number} y_min
+ * @param  {number} x_max
+ * @param  {number} y_max
+ * @return {number[]}
+ * @method
+ * @protected
+ */
+export const $getBoundsArray = (x_min, y_min, x_max, y_max) => {
+    const array = $boundsArrays.length
+        ? $boundsArrays.pop()
+        : new Float32Array(4);
+    array[0] = x_min;
+    array[1] = y_min;
+    array[2] = x_max;
+    array[3] = y_max;
+    return array;
+};
+/**
+ * @description 使用済みになったBoundsのArrayをプール
+ *              Pool used Bounds Array.
+ *
+ * @param {Float32Array} array
+ * @method
+ * @protected
+ */
+export const $poolBoundsArray = (array) => {
+    $boundsArrays.push(array);
+};
+/**
+ * @param  {object} option
+ * @return {void}
+ * @method
+ * @public
+ */
+export const $ajax = (option) => {
+    // get or post
+    let postData = null;
+    switch (option.method.toUpperCase()) {
+        case "GET":
+            if (option.data) {
+                const urls = option.url.split("?");
+                urls[1] = urls.length === 1
+                    ? option.data.toString()
+                    : `${urls[1]}&${option.data.toString()}`;
+                option.url = urls.join("?");
+            }
+            break;
+        case "PUT":
+        case "POST":
+            if (option.data) {
+                postData = option.data.toString();
+            }
+            break;
+        default:
+            break;
+    }
+    // start
+    const xmlHttpRequest = new XMLHttpRequest();
+    // init
+    xmlHttpRequest.open(option.method, option.url, true);
+    // set mimeType
+    xmlHttpRequest.responseType = option.format;
+    // use cookie
+    xmlHttpRequest.withCredentials = option.withCredentials;
+    // add event
+    if (option.event) {
+        const keys = Object.keys(option.event);
+        for (let idx = 0; idx < keys.length; ++idx) {
+            const name = keys[idx];
+            // @ts-ignore
+            xmlHttpRequest.addEventListener(name, option.event[name]);
+        }
+    }
+    // set request header
+    for (let idx = 0; idx < option.headers.length; ++idx) {
+        const header = option.headers[idx];
+        if (!header) {
+            continue;
+        }
+        xmlHttpRequest.setRequestHeader(header.name, header.value);
+    }
+    xmlHttpRequest.send(postData);
+};
+/**
+ * @description ヘッダー文字列を配列に変換
+ *              Convert header string to array
+ *
+ * @param  {string} header
+ * @return {array}
+ * @method
+ * @public
+ */
+export const $headerStringToArray = (header) => {
+    const results = $getArray();
+    if (header) {
+        const headers = header.trim().split("\n");
+        for (let idx = 0; idx < headers.length; ++idx) {
+            const values = headers[idx].split(":");
+            results.push({
+                "name": values[0].trim(),
+                "value": values[1].trim()
+            });
+        }
+    }
+    return results;
+};
+/**
+ * @description 親子関係のマップデータ
+ *              Parent-child relationship map data
+ *
+ * @type {Map}
+ * @protected
+ */
+export const $loaderInfoMap = new WeakMap();
+/**
+ * @description 子孫のrootへのマップデータ
+ *              Map data to the root of descendants
+ *
+ * @type {Map}
+ * @protected
+ */
+export const $rootMap = new WeakMap();
+/**
+ * @description Stageに追加したかどうかのマップデータ
+ *              Map data of whether it was added to the Stage
+ *
+ * @type {Map}
+ * @protected
+ */
+export const $stageAssignedMap = new Set();
+/**
+ * @description GraphicsとDisplayObjectのマップデータ
+ *              Map data of Graphics and DisplayObject
+ *
+ * @type {Map}
+ * @protected
+ */
+export const $graphicMap = new WeakMap();
+const canvas = document.createElement("canvas");
+canvas.width = canvas.height = 1;
+/**
+ * @type {CanvasRenderingContext2D}
+ * @protected
+ */
+export const $colorContext = canvas.getContext("2d");
+/**
+ * @description カラー文字列を数値に変換
+ *              Convert color string to number
+ * @param  {string} value
+ * @return {number}
+ * @method
+ * @protected
+ */
+export const $convertColorStringToNumber = (value) => {
+    if (!$colorContext) {
+        return 0;
+    }
+    $colorContext.fillStyle = value;
+    return +`0x${$colorContext.fillStyle.slice(1)}`;
+};
+/**
+ * @description 値が最小値と最大値の間に収まるように調整します。
+ *              Adjust the value so that it falls between the minimum and maximum values.
+ *
+ * @param  {number} value
+ * @param  {number} min
+ * @param  {number} max
+ * @param  {number} [default_value=null]
+ * @return {number}
+ * @method
+ * @protected
+ */
+export const $clamp = (value, min, max, default_value = null) => {
+    const number = +value;
+    return isNaN(number) && default_value !== null
+        ? default_value
+        : Math.min(Math.max(min, isNaN(number) ? 0 : number), max);
+};
+/**
+ * @description フレームアクションの発生したMovieClipを格納する配列
+ *              Array to store MovieClip where frame actions occurred
+ *
+ * @type {array}
+ * @protected
+ */
+export const $actions = [];
+/**
+ * @description フレームで実行するサウンドを格納する配列
+ *              Array to store sounds to be played on the frame
+ *
+ * @type {array}
+ * @protected
+ */
+export const $sounds = [];
+/**
+ * @description グローバル変数を格納するMap
+ *              Map to store global variables
+ *
+ * @type {Map}
+ * @protected
+ */
+export const $variables = new Map();
+/**
+ * @description ドラッグ中のDisplayObject
+ *              DisplayObject being dragged
+ *
+ * @type {ISprite}
+ * @private
+ */
+let $draggingDisplayObject = null;
+/**
+ * @description ドラッグ中のDisplayObjectを設定
+ *              Set the DisplayObject being dragged
+ *
+ * @param  {ISprite} display_object
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const $setDraggingDisplayObject = (display_object) => {
+    $draggingDisplayObject = display_object;
+};
+/**
+ * @description ドラッグ中のDisplayObjectを返却
+ *              Returns the DisplayObject being dragged
+ *
+ * @return {ISprite}
+ * @method
+ * @protected
+ */
+export const $getDraggingDisplayObject = () => {
+    return $draggingDisplayObject;
+};

package/src/FrameLabel.d.ts

@@ -0,0 +1,45 @@
+import { EventDispatcher } from "@next2d/events";
+/**
+ * @description FrameLabel オブジェクトには、フレーム番号および対応するラベル名を指定するプロパティがあります。
+ *              MovieClip クラスには、currentLabels プロパティがあります。
+ *              これは、現在のシーンの FrameLabel オブジェクトの配列です。
+ *              MovieClip インスタンスがシーンを使用していない場合、配列には MovieClip インスタンス全体のすべてのフレームラベルが含まれます。
+ *
+ *              The FrameLabel object contains properties that specify a frame number and the corresponding label name.
+ *              The MovieClip class includes a currentLabels property,
+ *              which is an Array of FrameLabel objects for the current scene.
+ *              If the MovieClip instance does not use scenes,
+ *              the Array includes all frame labels from the entire MovieClip instance.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  EventDispatcher
+ */
+export declare class FrameLabel extends EventDispatcher {
+    /**
+     * @description ラベルの名前。
+     *              The name of the label.
+     *
+     * @type {string}
+     * @readonly
+     * @public
+     */
+    readonly name: string;
+    /**
+     * @description ラベルを含むフレームの番号。
+     *              The frame number containing the label.
+     *
+     * @type {number}
+     * @readonly
+     * @public
+     */
+    readonly frame: number;
+    /**
+     * @param {string} name
+     * @param {number} frame
+     *
+     * @constructor
+     * @public
+     */
+    constructor(name: string, frame: number);
+}

package/src/FrameLabel.js

@@ -0,0 +1,59 @@
+import { EventDispatcher } from "@next2d/events";
+/**
+ * @description FrameLabel オブジェクトには、フレーム番号および対応するラベル名を指定するプロパティがあります。
+ *              MovieClip クラスには、currentLabels プロパティがあります。
+ *              これは、現在のシーンの FrameLabel オブジェクトの配列です。
+ *              MovieClip インスタンスがシーンを使用していない場合、配列には MovieClip インスタンス全体のすべてのフレームラベルが含まれます。
+ *
+ *              The FrameLabel object contains properties that specify a frame number and the corresponding label name.
+ *              The MovieClip class includes a currentLabels property,
+ *              which is an Array of FrameLabel objects for the current scene.
+ *              If the MovieClip instance does not use scenes,
+ *              the Array includes all frame labels from the entire MovieClip instance.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  EventDispatcher
+ */
+export class FrameLabel extends EventDispatcher {
+    /**
+     * @param {string} name
+     * @param {number} frame
+     *
+     * @constructor
+     * @public
+     */
+    constructor(name, frame) {
+        super();
+        /**
+         * @description ラベルの名前。
+         *              The name of the label.
+         *
+         * @type {string}
+         * @readonly
+         * @public
+         */
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @description ラベルを含むフレームの番号。
+         *              The frame number containing the label.
+         *
+         * @type {number}
+         * @readonly
+         * @public
+         */
+        Object.defineProperty(this, "frame", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = `${name}`;
+        this.frame = frame | 0;
+    }
+}

package/src/Graphics/service/GraphicsCalcFillBoundsService.d.ts

@@ -0,0 +1,13 @@
+import type { Graphics } from "../../Graphics";
+/**
+ * @description 塗りの描画範囲を計算
+ *              Calculate the fill drawing range
+ *
+ * @param  {Graphics} graphics
+ * @param  {number} x
+ * @param  {number} y
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (graphics: Graphics, x?: number, y?: number) => void;

package/src/Graphics/service/GraphicsCalcFillBoundsService.js

@@ -0,0 +1,17 @@
+/**
+ * @description 塗りの描画範囲を計算
+ *              Calculate the fill drawing range
+ *
+ * @param  {Graphics} graphics
+ * @param  {number} x
+ * @param  {number} y
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (graphics, x = 0, y = 0) => {
+    graphics.xMin = Math.min(graphics.xMin, x);
+    graphics.xMax = Math.max(graphics.xMax, x);
+    graphics.yMin = Math.min(graphics.yMin, y);
+    graphics.yMax = Math.max(graphics.yMax, y);
+};

package/src/Graphics/service/GraphicsCalcLineBoundsService.d.ts

@@ -0,0 +1,17 @@
+import type { Graphics } from "../../Graphics";
+/**
+ * @description 線の描画範囲を計算
+ *              Calculate the stroke drawing range
+ *
+ * @param  {Graphics} graphics
+ * @param  {number} x
+ * @param  {number} y
+ * @param  {number} position_x
+ * @param  {number} position_y
+ * @param  {number} line_width
+ * @param  {string} caps
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (graphics: Graphics, x?: number, y?: number, position_x?: number, position_y?: number, line_width?: number, caps?: string) => void;

package/src/Graphics/service/GraphicsCalcLineBoundsService.js

@@ -0,0 +1,58 @@
+/**
+ * @description 線の描画範囲を計算
+ *              Calculate the stroke drawing range
+ *
+ * @param  {Graphics} graphics
+ * @param  {number} x
+ * @param  {number} y
+ * @param  {number} position_x
+ * @param  {number} position_y
+ * @param  {number} line_width
+ * @param  {string} caps
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (graphics, x = 0, y = 0, position_x = 0, position_y = 0, line_width = 0, caps = "none") => {
+    graphics.xMin = Math.min(graphics.xMin, Math.min(x, position_x));
+    graphics.xMax = Math.max(graphics.xMax, Math.max(x, position_x));
+    graphics.yMin = Math.min(graphics.yMin, Math.min(y, position_y));
+    graphics.yMax = Math.max(graphics.yMax, Math.max(y, position_y));
+    // 始点 - 終点のベクトル
+    const dx = position_x - x;
+    const dy = position_y - y;
+    // ベクトルの長さ
+    const length = Math.sqrt(dx * dx + dy * dy);
+    if (!length) {
+        return;
+    }
+    // 単位ベクトル
+    const ux = dx / length;
+    const uy = dy / length;
+    const vx = -uy;
+    const vy = ux;
+    // 線の太さの半分(半径)
+    const r = line_width / 2;
+    const xMin = Math.min(x + vx * r, x - vx * r, position_x + vx * r, position_x - vx * r);
+    const xMax = Math.max(x + vx * r, x - vx * r, position_x + vx * r, position_x - vx * r);
+    const yMin = Math.min(y + vy * r, y - vy * r, position_y + vy * r, position_y - vy * r);
+    const yMax = Math.max(y + vy * r, y - vy * r, position_y + vy * r, position_y - vy * r);
+    graphics.xMin = Math.min(graphics.xMin, xMin);
+    graphics.xMax = Math.max(graphics.xMax, xMax);
+    graphics.yMin = Math.min(graphics.yMin, yMin);
+    graphics.yMax = Math.max(graphics.yMax, yMax);
+    // case
+    if (caps === "round" || caps === "square") {
+        // 矩形キャップの中心点(ux, uyは逆ベクトルなのでマイナスで反転)
+        const cxn = x + r * -ux;
+        const cyn = y + r * -uy;
+        const xMin = Math.min(cxn + r * ux + r * vx, cxn - r * ux + r * vx, cxn + r * ux - r * vx, cxn - r * ux - r * vx);
+        const xMax = Math.max(cxn + r * ux + r * vx, cxn - r * ux + r * vx, cxn + r * ux - r * vx, cxn - r * ux - r * vx);
+        const yMin = Math.min(cyn + r * uy + r * vy, cyn + r * uy - r * vy, cyn - r * uy - r * vy, cyn - r * uy + r * vy);
+        const yMax = Math.max(cyn + r * uy + r * vy, cyn + r * uy - r * vy, cyn - r * uy - r * vy, cyn - r * uy + r * vy);
+        graphics.xMin = Math.min(graphics.xMin, xMin);
+        graphics.xMax = Math.max(graphics.xMax, xMax);
+        graphics.yMin = Math.min(graphics.yMin, yMin);
+        graphics.yMax = Math.max(graphics.yMax, yMax);
+    }
+};

package/src/Graphics/service/GraphicsDrawEllipseService.d.ts

@@ -0,0 +1,15 @@
+import type { Graphics } from "../../Graphics";
+/**
+ * @description 楕円を描画データを登録
+ *              Register ellipse drawing data
+ *
+ * @param  {Graphics} graphics
+ * @param  {number} x
+ * @param  {number} y
+ * @param  {number} width
+ * @param  {number} height
+ * @return {Graphics}
+ * @method
+ * @protected
+ */
+export declare const execute: (graphics: Graphics, x: number, y: number, width: number, height: number) => Graphics;