@next2d/player 1.14.7 → 1.14.8

package/dist/player/next2d/geom/Transform.js

@@ -0,0 +1,497 @@
+import { Rectangle } from "./Rectangle";
+import { BevelFilter } from "../filters/BevelFilter";
+import { BlurFilter } from "../filters/BlurFilter";
+import { ColorMatrixFilter } from "../filters/ColorMatrixFilter";
+import { ConvolutionFilter } from "../filters/ConvolutionFilter";
+import { DisplacementMapFilter } from "../filters/DisplacementMapFilter";
+import { DropShadowFilter } from "../filters/DropShadowFilter";
+import { GlowFilter } from "../filters/GlowFilter";
+import { GradientBevelFilter } from "../filters/GradientBevelFilter";
+import { GradientGlowFilter } from "../filters/GradientGlowFilter";
+import { $doUpdated } from "../../util/Global";
+import { $getColorTransform, $getMatrix } from "../../util/Util";
+import { $Array, $Math, $MATRIX_ARRAY_IDENTITY, $COLOR_ARRAY_IDENTITY, $getFloat32Array6, $getArray, $poolArray, $multiplicationColor, $multiplicationMatrix, $poolBoundsObject, $getFloat32Array8 } from "../../util/RenderUtil";
+/**
+ * Transform クラスは、表示オブジェクトに適用されるカラー調整プロパティと 2 次元の変換オブジェクトへのアクセスを提供します。
+ * 変換時に、表示オブジェクトのカラーまたは方向と位置が、現在の値または座標から新しい値または座標に調整（オフセット）されます。
+ * Transform クラスは、表示オブジェクトおよびすべての親オブジェクトに適用されるカラー変換と 2 次元マトリックス変換に関するデータも収集します。
+ * concatenatedColorTransform プロパティと concatenatedMatrix プロパティを使用して、これらの結合された変換にアクセスできます。
+ * カラー変換を適用するには、ColorTransform オブジェクトを作成し、オブジェクトのメソッドとプロパティを使用してカラー調整を設定した後、
+ * colorTransformation プロパティ（表示オブジェクトの transform プロパティの）を新しい ColorTransformation オブジェクトに割り当てます。
+ * 2 次元変換を適用するには、Matrix オブジェクトを作成し、マトリックスの 2 次元変換を設定した後、表示オブジェクトの transform.matrix プロパティを新しい Matrix オブジェクトに割り当てます。
+ *
+ * The Transform class provides access to color adjustment properties and two--dimensional transformation objects that can be applied to a display object.
+ * During the transformation, the color or the orientation and position of a display object is adjusted (offset) from the current values or coordinates to new values or coordinates.
+ * The Transform class also collects data about color and two-dimensional matrix transformations that are applied to a display object and all of its parent objects.
+ * You can access these combined transformations through the concatenatedColorTransform and concatenatedMatrix properties.
+ * To apply color transformations: create a ColorTransform object,
+ * set the color adjustments using the object's methods and properties,
+ * and then assign the colorTransformation property of the transform property of the display object to the new ColorTransformation object.
+ * To apply two-dimensional transformations: create a Matrix object,
+ * set the matrix's two-dimensional transformation,
+ * and then assign the transform.matrix property of the display object to the new Matrix object.
+ *
+ * @example <caption>Example usage of Transform.</caption>
+ * // new Transform
+ * const {Transform} = next2d.geom;
+ * const transform   = new Transform(displayObject);
+ *
+ * @class
+ * @memberOf next2d.geom
+ */
+export class Transform {
+    _$displayObject;
+    _$matrix;
+    _$colorTransform;
+    _$blendMode;
+    _$filters;
+    /**
+     * @param {DisplayObject} src
+     *
+     * @constructor
+     * @public
+     */
+    constructor(src) {
+        /**
+         * @type {DisplayObject}
+         * @private
+         */
+        this._$displayObject = src;
+        /**
+         * @type {Matrix}
+         * @default null
+         * @private
+         */
+        this._$matrix = null;
+        /**
+         * @type {ColorTransform}
+         * @default null
+         * @private
+         */
+        this._$colorTransform = null;
+        /**
+         * @type {string}
+         * @default null
+         * @private
+         */
+        this._$blendMode = null;
+        /**
+         * @type {array}
+         * @default null
+         * @private
+         */
+        this._$filters = null;
+    }
+    /**
+     * 指定されたクラスのストリングを返します。
+     * Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class Transform]
+     * @method
+     * @static
+     */
+    static toString() {
+        return "[class Transform]";
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @member  {string}
+     * @default next2d.geom.Transform
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.geom.Transform";
+    }
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return {string}
+     * @method
+     * @public
+     */
+    toString() {
+        return "[object Transform]";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @member  {string}
+     * @default next2d.geom.Transform
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.geom.Transform";
+    }
+    /**
+     * @description 表示オブジェクトのカラーを全体的に調整する値を格納している
+     *              ColorTransform オブジェクトです。
+     *              A ColorTransform object containing values that universally adjust
+     *              the colors in the display object.
+     *
+     * @member {ColorTransform}
+     * @public
+     */
+    get colorTransform() {
+        if (this._$colorTransform) {
+            return this._$colorTransform._$clone();
+        }
+        const placeObject = this
+            ._$displayObject
+            ._$getPlaceObject();
+        if (placeObject && placeObject.colorTransform) {
+            const buffer = placeObject.colorTransform;
+            return $getColorTransform(buffer[0], buffer[1], buffer[2], buffer[3], buffer[4], buffer[5], buffer[6], buffer[7]);
+        }
+        this._$transform();
+        if (!this._$colorTransform) {
+            this._$colorTransform = $getColorTransform();
+        }
+        return this._$colorTransform._$clone();
+    }
+    set colorTransform(color_transform) {
+        this._$transform(null, color_transform._$colorTransform);
+    }
+    /**
+     * @description この表示オブジェクトおよびルートレベルまでのすべての親オブジェクトに適用される、
+     *              結合されたカラー変換を表す ColorTransform オブジェクトです。
+     *              A ColorTransform object representing
+     *              the combined color transformations applied to the display object
+     *              and all of its parent objects, back to the root level.
+     *
+     * @member {ColorTransform}
+     * @readonly
+     * @public
+     */
+    get concatenatedColorTransform() {
+        let colorTransform = this._$rawColorTransform();
+        let parent = this._$displayObject._$parent;
+        while (parent) {
+            colorTransform = $multiplicationColor(parent._$transform._$rawColorTransform(), colorTransform);
+            parent = parent._$parent;
+        }
+        return $getColorTransform(colorTransform[0], colorTransform[1], colorTransform[2], colorTransform[3], colorTransform[4], colorTransform[5], colorTransform[6], colorTransform[7]);
+    }
+    /**
+     * @description 表示オブジェクトの拡大 / 縮小、回転、および移動を変更する値を格納している
+     *              Matrix オブジェクトです。
+     *              A Matrix object containing values that alter the scaling,
+     *              rotation, and translation of the display object.
+     *
+     * @member {Matrix}
+     * @public
+     */
+    get matrix() {
+        if (this._$matrix) {
+            return this._$matrix._$clone();
+        }
+        const placeObject = this
+            ._$displayObject
+            ._$getPlaceObject();
+        if (placeObject && placeObject.matrix) {
+            const buffer = placeObject.matrix;
+            return $getMatrix(buffer[0], buffer[1], buffer[2], buffer[3], buffer[4], buffer[5]);
+        }
+        this._$transform();
+        if (!this._$matrix) {
+            this._$matrix = $getMatrix();
+        }
+        return this._$matrix._$clone();
+    }
+    set matrix(matrix) {
+        this._$transform(matrix._$matrix, null);
+    }
+    /**
+     * @description この表示オブジェクトおよびルートレベルまでのそのすべての親オブジェクトの結合された
+     *              変換マトリックスを表す Matrix オブジェクトです。
+     *              A Matrix object representing the combined transformation matrixes
+     *              of the display object and all of its parent objects, back to the root level.
+     *
+     * @member {Matrix}
+     * @readonly
+     * @method
+     * @public
+     */
+    get concatenatedMatrix() {
+        let matrix = this._$rawMatrix();
+        let parent = this._$displayObject._$parent;
+        while (parent) {
+            matrix = $multiplicationMatrix(parent._$transform._$rawMatrix(), matrix);
+            parent = parent._$parent;
+        }
+        return $getMatrix(matrix[0], matrix[1], matrix[2], matrix[3], matrix[4], matrix[5]);
+    }
+    /**
+     * @description ステージ上の表示オブジェクトの境界を示す矩形を定義する Transform オブジェクトです。
+     *              A Transform object that defines the bounding rectangle of
+     *              the display object on the stage.
+     *
+     * @member {Transform}
+     * @readonly
+     * @method
+     * @public
+     */
+    pixelBounds() {
+        if (!this._$displayObject) {
+            return new Rectangle(0, 0, 0, 0);
+        }
+        const bounds = this
+            ._$displayObject
+            ._$getBounds(null);
+        const rectangle = new Rectangle(bounds.xMin, bounds.yMin, +$Math.abs(bounds.xMax - bounds.xMin), +$Math.abs(bounds.yMax - bounds.yMin));
+        $poolBoundsObject(bounds);
+        return rectangle;
+    }
+    /**
+     * matrix プロパティから取得される Matrix の Matrix._$matrix と同じ値を返しますが、matrix プロパティと異なり Matrix を複製しません。
+     * 返される値は一時的に使用することのみできます。返される値の要素を直接更新してはいけません。返される値をプール（Util.$poolFloat32Array）してはいけません。
+     *
+     * @return {Float32Array}
+     * @method
+     * @private
+     */
+    _$rawMatrix() {
+        if (this._$matrix !== null) {
+            return this._$matrix._$matrix;
+        }
+        const placeObject = this
+            ._$displayObject
+            ._$getPlaceObject();
+        if (placeObject && placeObject.matrix) {
+            if ($Array.isArray(placeObject.matrix)) {
+                const matrix = placeObject.matrix;
+                placeObject.matrix = $getFloat32Array6(matrix[0], matrix[1], matrix[2], matrix[3], matrix[4], matrix[5]);
+                $poolArray(matrix);
+            }
+            return placeObject.matrix;
+        }
+        return $MATRIX_ARRAY_IDENTITY;
+    }
+    /**
+     * colorTransform プロパティから取得される ColorTransform の colorTransform._$colorTransform と同じ値を返しますが、colorTransform プロパティと異なり ColorTransform を複製しません。
+     * 返される値は一時的に使用することのみできます。返される値の要素を直接更新してはいけません。返される値をプール（Util.$poolFloat32Array）してはいけません。
+     *
+     * @return {Float32Array}
+     * @method
+     * @private
+     */
+    _$rawColorTransform() {
+        if (this._$colorTransform !== null) {
+            return this._$colorTransform._$colorTransform;
+        }
+        const placeObject = this
+            ._$displayObject
+            ._$getPlaceObject();
+        if (placeObject && placeObject.colorTransform) {
+            if ($Array.isArray(placeObject.colorTransform)) {
+                const colorTransform = placeObject.colorTransform;
+                placeObject.colorTransform = $getFloat32Array8(colorTransform[0], colorTransform[1], colorTransform[2], colorTransform[3], colorTransform[4], colorTransform[5], colorTransform[6], colorTransform[7]);
+                $poolArray(colorTransform);
+            }
+            return placeObject.colorTransform;
+        }
+        return $COLOR_ARRAY_IDENTITY;
+    }
+    /**
+     * @param  {Float32Array} [matrix=null]
+     * @param  {Float32Array} [color_transform=null]
+     * @param  {array}        [filters=null]
+     * @param  {string}       [blend_mode=""]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$transform(matrix = null, color_transform = null, filters = null, blend_mode = "") {
+        const placeObject = this
+            ._$displayObject
+            ._$getPlaceObject();
+        // Matrix
+        this._$setMatrix(matrix, placeObject);
+        // ColorTransform
+        this._$setColorTransform(color_transform, placeObject);
+        // Filter
+        this._$setFilters(filters, placeObject);
+        // BlendMode
+        this._$setBlendMode(blend_mode, placeObject);
+    }
+    /**
+     * @param  {Float32Array} [matrix=null]
+     * @param  {object} [place_object=null]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$setMatrix(matrix = null, place_object = null) {
+        if (matrix || place_object) {
+            this._$displayObject._$doChanged();
+            $doUpdated();
+        }
+        // Matrix
+        if (!this._$matrix) {
+            this._$matrix = $getMatrix(1, 0, 0, 1, 0, 0);
+            if (!matrix
+                && place_object
+                && place_object.matrix) {
+                matrix = place_object.matrix;
+            }
+        }
+        // update
+        if (matrix) {
+            const currentMatrix = this._$matrix._$matrix;
+            currentMatrix[0] = matrix[0];
+            currentMatrix[1] = matrix[1];
+            currentMatrix[2] = matrix[2];
+            currentMatrix[3] = matrix[3];
+            currentMatrix[4] = matrix[4];
+            currentMatrix[5] = matrix[5];
+        }
+    }
+    /**
+     * @param  {Float32Array} [color_transform=null]
+     * @param  {object} [place_object=null]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$setColorTransform(color_transform = null, place_object = null) {
+        if (color_transform || place_object) {
+            this._$displayObject._$doChanged();
+            $doUpdated();
+        }
+        if (!this._$colorTransform) {
+            this._$colorTransform = $getColorTransform(1, 1, 1, 1, 0, 0, 0, 0);
+            if (!color_transform
+                && place_object
+                && place_object.colorTransform) {
+                color_transform = place_object.colorTransform;
+            }
+        }
+        if (color_transform) {
+            const colorTransform = this._$colorTransform._$colorTransform;
+            colorTransform[0] = color_transform[0];
+            colorTransform[1] = color_transform[1];
+            colorTransform[2] = color_transform[2];
+            colorTransform[3] = color_transform[3];
+            colorTransform[4] = color_transform[4];
+            colorTransform[5] = color_transform[5];
+            colorTransform[6] = color_transform[6];
+            colorTransform[7] = color_transform[7];
+        }
+    }
+    /**
+     * @param  {array}  [filters=null]
+     * @param  {object} [place_object=null]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$setFilters(filters = null, place_object = null) {
+        if ($Array.isArray(filters)) {
+            if (this._$filters) {
+                $poolArray(this._$filters);
+            }
+            this._$filters = filters.slice(0);
+            this._$displayObject._$doChanged();
+            $doUpdated();
+            return;
+        }
+        if (this._$filters) {
+            return;
+        }
+        if (!place_object) {
+            this._$filters = $getArray();
+            return;
+        }
+        if (place_object.filters) {
+            this._$filters = place_object.filters.slice(0);
+            for (let idx = 0; idx < this._$filters.length; ++idx) {
+                this._$filters[idx] = this._$filters[idx].clone();
+            }
+            return;
+        }
+        if (place_object.surfaceFilterList) {
+            // build origin
+            place_object.filters = this._$buildFilter(place_object.surfaceFilterList);
+            // use clone
+            this._$filters = place_object.filters.slice(0);
+            for (let idx = 0; idx < this._$filters.length; ++idx) {
+                this._$filters[idx] = this._$filters[idx].clone();
+            }
+        }
+    }
+    /**
+     * @param  {array} surface_filter_list
+     * @return {array}
+     * @method
+     * @public
+     */
+    _$buildFilter(surface_filter_list) {
+        const filters = $getArray();
+        const length = surface_filter_list.length;
+        for (let idx = 0; idx < length; ++idx) {
+            const filter = surface_filter_list[idx];
+            if (filter.params[0] === null) {
+                filter.params.shift();
+            }
+            switch (filter.class) {
+                case "BevelFilter":
+                    filters.push(new BevelFilter(...filter.params));
+                    break;
+                case "BlurFilter":
+                    filters.push(new BlurFilter(...filter.params));
+                    break;
+                case "ColorMatrixFilter":
+                    filters.push(new ColorMatrixFilter(...filter.params));
+                    break;
+                case "ConvolutionFilter":
+                    filters.push(new ConvolutionFilter(...filter.params));
+                    break;
+                case "DisplacementMapFilter":
+                    filters.push(new DisplacementMapFilter(...filter.params));
+                    break;
+                case "DropShadowFilter":
+                    filters.push(new DropShadowFilter(...filter.params));
+                    break;
+                case "GlowFilter":
+                    filters.push(new GlowFilter(...filter.params));
+                    break;
+                case "GradientBevelFilter":
+                    filters.push(new GradientBevelFilter(...filter.params));
+                    break;
+                case "GradientGlowFilter":
+                    filters.push(new GradientGlowFilter(...filter.params));
+                    break;
+            }
+        }
+        return filters;
+    }
+    /**
+     * @param  {string} [blend_mode=""]
+     * @param  {object} [place_object=null]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$setBlendMode(blend_mode = "", place_object = null) {
+        if (blend_mode) {
+            this._$blendMode = blend_mode;
+            this._$displayObject._$doChanged();
+            $doUpdated();
+            return;
+        }
+        if (this._$blendMode) {
+            return;
+        }
+        if (place_object && place_object.blendMode) {
+            this._$blendMode = place_object.blendMode;
+            return;
+        }
+        this._$blendMode = "normal";
+    }
+}

package/dist/player/next2d/media/Sound.d.ts

@@ -0,0 +1,208 @@
+import { EventDispatcher } from "../events/EventDispatcher";
+import { URLRequest } from "../net/URLRequest";
+import type { DisplayObjectContainer } from "../display/DisplayObjectContainer";
+import type { SoundTagImpl } from "../../../interface/SoundTagImpl";
+import type { SoundCharacterImpl } from "../../../interface/SoundCharacterImpl";
+import type { Character } from "../../../interface/Character";
+/**
+ * Sound クラスを使用すると、アプリケーション内のサウンドを処理することができます。
+ * Sound クラスを使用すると、Sound オブジェクトの作成や、外部 MP3 ファイルのオブジェクトへのロードと再生ができます。
+ *
+ * The Sound class lets you work with sound in an application.
+ * The Sound class lets you create a Sound object,
+ * load and play an external MP3 file into that object.
+ *
+ * @class
+ * @memberOf next2d.media
+ * @extends  EventDispatcher
+ */
+export declare class Sound extends EventDispatcher {
+    readonly _$sources: AudioBufferSourceNode[];
+    private _$bytesLoaded;
+    private _$bytesTotal;
+    private _$volume;
+    private _$currentCount;
+    private _$src;
+    private _$loopCount;
+    private _$stopFlag;
+    _$character: Character<SoundCharacterImpl> | null;
+    _$audioBuffer: AudioBuffer | null;
+    _$arrayBuffer: ArrayBuffer | null;
+    /**
+     * @constructor
+     * @public
+     */
+    constructor();
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class Sound]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.media.Sound
+     * @const
+     * @static
+     */
+    static get namespace(): string;
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object Sound]
+     * @method
+     * @public
+     */
+    toString(): string;
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.media.Sound
+     * @const
+     * @public
+     */
+    get namespace(): string;
+    /**
+     * @description 既にアプリケーションにロードされているデータのバイト数です。
+     *              The number of bytes of data that have been loaded into the application.
+     *
+     * @member {number}
+     * @default 0
+     * @readonly
+     * @public
+     */
+    get bytesLoaded(): number;
+    /**
+     * @description アプリケーションにロードされるファイルの総バイト数。
+     *              The total size in bytes of the file being loaded into the application.
+     *
+     * @member {number}
+     * @default 0
+     * @readonly
+     * @public
+     */
+    get bytesTotal(): number;
+    /**
+     * @description ループ回数の設定
+     *              Loop count setting.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get loopCount(): number;
+    set loopCount(loop_count: number);
+    /**
+     * @description 外部サウンドのURL
+     *              URL for external sound.
+     *
+     * @member {string}
+     * @default ""
+     * @public
+     */
+    get src(): string;
+    set src(url: string);
+    /**
+     * @description ボリュームです。範囲は 0（無音）～ 1（フルボリューム）です。
+     *              The volume, ranging from 0 (silent) to 1 (full volume).
+     *
+     * @member {number}
+     * @default 1
+     * @public
+     */
+    get volume(): number;
+    set volume(volume: number);
+    /**
+     * @description Sound クラスを複製します。
+     *              Duplicate the Sound class.
+     *
+     * @return {Sound}
+     * @method
+     * @public
+     */
+    clone(): Sound;
+    /**
+     * @description 指定した URL から外部 MP3 ファイルのロードを開始します。
+     *              Initiates loading of an external MP3 file from the specified URL.
+     *
+     * @param {URLRequest} request
+     * @return {void}
+     * @method
+     * @public
+     */
+    load(request: URLRequest): void;
+    /**
+     * @param  {ProgressEvent} event
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$loadStart(event: ProgressEvent): void;
+    /**
+     * @param  {ProgressEvent} event
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$progress(event: ProgressEvent): void;
+    /**
+     * @param  {ProgressEvent} event
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$loadEnd(event: ProgressEvent): void;
+    /**
+     * @description サウンドを再生します。
+     *              Play a sound.
+     *
+     * @param   {number} [start_time=0]
+     * @return  {void}
+     * @method
+     * @public
+     */
+    play(start_time?: number): void;
+    /**
+     * @description チャンネルで再生しているサウンドを停止します。
+     *              Stops the sound playing in the channel.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    stop(): void;
+    /**
+     * @param  {object} tag
+     * @param  {MovieClip} parent
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$build(tag: SoundTagImpl, parent: DisplayObjectContainer): void;
+    /**
+     * @param  {number}  [start_time=0]
+     * @param  {number}  [offset=0]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$createBufferSource(start_time?: number, offset?: number): void;
+    /**
+     * @param  {Event} event
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$endEventHandler(event: Event): void;
+}