@next2d/player 1.14.6 → 1.14.8

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

@@ -0,0 +1,255 @@
+import { DisplayObjectContainer } from "./DisplayObjectContainer";
+import { $devicePixelRatio } from "../../util/Shortcut";
+import { $clamp, $toColorInt, $uintToRGBA } from "../../util/RenderUtil";
+/**
+ * Stage クラスはメイン描画領域を表します。
+ * The Stage class represents the main drawing area.
+ *
+ * @class
+ * @memberOf next2d.display
+ * @extends  DisplayObjectContainer
+ */
+export class Stage extends DisplayObjectContainer {
+    _$player;
+    _$invalidate;
+    _$color;
+    _$frameRate;
+    /**
+     * @constructor
+     * @public
+     */
+    constructor() {
+        super();
+        /**
+         * @type {Player}
+         * @default null
+         * @private
+         */
+        this._$player = null;
+        /**
+         * @type {Stage}
+         * @private
+         */
+        this._$root = this;
+        /**
+         * @type {Stage}
+         * @private
+         */
+        this._$stage = this;
+        /**
+         * @type {boolean}
+         * @default true
+         * @private
+         */
+        this._$invalidate = true;
+        /**
+         * @type {number}
+         * @default 0xffffffff
+         * @private
+         */
+        this._$color = 0xffffffff;
+        /**
+         * @type {number}
+         * @default 60
+         * @private
+         */
+        this._$frameRate = 60;
+    }
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class Stage]
+     * @method
+     * @static
+     */
+    static toString() {
+        return "[class Stage]";
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.display.Stage
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.display.Stage";
+    }
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object Stage]
+     * @method
+     * @public
+     */
+    toString() {
+        return "[object Stage]";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.display.Stage
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.display.Stage";
+    }
+    /**
+     * @description 背景色です。
+     *              background color.
+     *
+     * @member {number}
+     * @public
+     */
+    get color() {
+        return this._$color;
+    }
+    set color(color) {
+        this._$color = $clamp($toColorInt(color), 0, 0xffffff, 0xffffff);
+        const player = this._$player;
+        if (player && player.context) {
+            const rgba = $uintToRGBA(this._$color);
+            player
+                .context
+                ._$setColor(rgba.R / 255, rgba.G / 255, rgba.B / 255, rgba.A / 255);
+        }
+    }
+    /**
+     * @description ステージのフレームレートを取得または設定します。
+     *              Gets and sets the frame rate of the stage.
+     *
+     * @member {number}
+     * @public
+     */
+    get frameRate() {
+        return this._$frameRate;
+    }
+    set frameRate(frame_rate) {
+        this._$frameRate = $clamp(+frame_rate, 1, 60, 60);
+        if (this._$player && !this._$player._$stopFlag) {
+            this._$player.stop();
+            this._$player.play();
+        }
+    }
+    /**
+     * @description Player オブジェクトを返します。
+     *              Returns a Player object.
+     *
+     * @member {Player}
+     * @readonly
+     * @public
+     */
+    get player() {
+        return this._$player;
+    }
+    /**
+     * @description 現在のCanvasの高さをピクセル単位で指定します。
+     *              Specifies the height of the current Canvas in pixels.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get canvasHeight() {
+        return this._$player
+            ? this._$player._$height / $devicePixelRatio
+            : 0;
+    }
+    /**
+     * @description 現在のCanvasの幅をピクセル単位で指定します。
+     *              Specifies the width of the current Canvas in pixels.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get canvasWidth() {
+        return this._$player
+            ? this._$player._$width / $devicePixelRatio
+            : 0;
+    }
+    /**
+     * @description 現在のStageの高さをピクセル単位で指定します。
+     *              Specifies the height of the current Stage in pixels.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get currentStageHeight() {
+        return this._$player
+            ? this._$player.height * this._$player._$scale
+            : 0;
+    }
+    /**
+     * @description 現在のStageの幅をピクセル単位で指定します。
+     *              Specifies the width of the current Stage in pixels.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get currentStageWidth() {
+        return this._$player
+            ? this._$player.width * this._$player._$scale
+            : 0;
+    }
+    /**
+     * @description 初期設定したステージの高さをピクセル単位で指定します。
+     *              Specifies the height of the initially set stage in pixels.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get stageHeight() {
+        return this._$player ? this._$player.height : 0;
+    }
+    /**
+     * @description 初期設定したステージの幅をピクセル単位で指定します。
+     *              Specifies the width of the initially set stage in pixels.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get stageWidth() {
+        return this._$player ? this._$player.width : 0;
+    }
+    /**
+     * @description 表示リストをレンダリングする必要のある次の機会に、
+     *              表示オブジェクトに警告するようランタイムに通知します。
+     *              (例えば、再生ヘッドを新しいフレームに進める場合などです。)
+     *              Calling the invalidate() method signals runtimes
+     *              to alert display objects on the next opportunity
+     *              it has to render the display list.
+     *              (for example, when the playhead advances to a new frame)
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    invalidate() {
+        this._$invalidate = true;
+    }
+    /**
+     * @param  {DisplayObject} child
+     * @return {DisplayObject}
+     * @method
+     * @private
+     */
+    _$addChild(child) {
+        child._$stage = this;
+        child._$root = child;
+        return super._$addChild(child);
+    }
+}

package/dist/player/next2d/events/Event.d.ts

@@ -0,0 +1,424 @@
+import type { EventDispatcher } from "./EventDispatcher";
+/**
+ * Event クラスのメソッドは、イベントリスナー関数で使用してイベントオブジェクトの動作に影響を与えることができます。
+ * 一部のイベントにはデフォルトの動作が関連付けられています。
+ * 例えば、doubleClick イベントには、イベント時にマウスポインター位置の単語がハイライト表示されるというデフォルトの動作が関連付けられています。
+ * イベントリスナーで preventDefault() メソッドを呼び出してこの動作をキャンセルできます。
+ * また、stopPropagation() メソッドまたは stopImmediatePropagation() メソッドを呼び出すと、
+ * 現在のイベントリスナーを、イベントを処理する最後のイベントリスナーにすることができます。
+ *
+ * The methods of the Event class can be used in event listener functions to affect the behavior of the event object.
+ * Some events have an associated default behavior. For example,
+ * the doubleClick event has an associated default behavior that highlights the word under the mouse pointer at the time of the event.
+ * Your event listener can cancel this behavior by calling the preventDefault() method.
+ * You can also make the current event listener the last one to process
+ * an event by calling the stopPropagation() or stopImmediatePropagation() method.
+ *
+ * @class
+ * @memberOf next2d.events
+ */
+export declare class Event {
+    private readonly _$type;
+    private readonly _$bubbles;
+    private readonly _$cancelable;
+    private _$target;
+    private _$currentTarget;
+    private _$listener;
+    private _$eventPhase;
+    _$stopImmediatePropagation: boolean;
+    _$stopPropagation: boolean;
+    /**
+     * @param {string}  type
+     * @param {boolean} [bubbles=false]
+     * @param {boolean} [cancelable=false]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(type: string, bubbles?: boolean, cancelable?: boolean);
+    /**
+     * 指定されたクラスのストリングを返します。
+     * Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class Event]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @member  {string}
+     * @default next2d.events.Event
+     * @const
+     * @static
+     */
+    static get namespace(): string;
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return {string}
+     * @method
+     * @public
+     */
+    toString(): string;
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @member  {string}
+     * @default next2d.events.Event
+     * @const
+     * @public
+     */
+    get namespace(): string;
+    /**
+     * @description ACTIVATE 定数は、type プロパティ（activate イベントオブジェクト）の値を定義します。
+     *              The ACTIVATE constant defines the value
+     *              of the type property of an activate event object.
+     *
+     * @return  {string}
+     * @default activate
+     * @const
+     * @static
+     */
+    static get ACTIVATE(): string;
+    /**
+     * @description Event.ADDED 定数は、added イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.ADDED constant defines the value
+     *              of the type property of an added event object.
+     *
+     * @return  {string}
+     * @default added
+     * @const
+     * @static
+     */
+    static get ADDED(): string;
+    /**
+     * @description Event.ADDED_TO_STAGE 定数は、type プロパティ（addedToStage イベントオブジェクト）の値を定義します。
+     *              The Event.ADDED_TO_STAGE constant defines the value
+     *              of the type property of an addedToStage event object.
+     *
+     * @return  {string}
+     * @default addedToStage
+     * @const
+     * @static
+     */
+    static get ADDED_TO_STAGE(): string;
+    /**
+     * @description Event.CHANGE 定数は、type プロパティ（change イベントオブジェクト）の値を定義します。
+     *              The Event.CHANGE constant defines the value
+     *              of the type property of a change event object.
+     *
+     * @return  {string}
+     * @default change
+     * @const
+     * @static
+     */
+    static get CHANGE(): string;
+    /**
+     * @description Event.COMPLETE 定数は、complete イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.COMPLETE constant defines the value
+     *              of the type property of a complete event object.
+     *
+     * @return  {string}
+     * @default complete
+     * @const
+     * @static
+     */
+    static get COMPLETE(): string;
+    /**
+     * @description Event.DEACTIVATE 定数は、deactivate イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.DEACTIVATE constant defines the value
+     *              of the type property of a deactivate event object.
+     *
+     * @return  {string}
+     * @default deactivate
+     * @const
+     * @static
+     */
+    static get DEACTIVATE(): string;
+    /**
+     * @description Event.ENTER_FRAME 定数は、enterFrame イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.ENTER_FRAME constant defines the value
+     *              of the type property of an enterFrame event object.
+     *
+     * @return  {string}
+     * @default enterFrame
+     * @const
+     * @static
+     */
+    static get ENTER_FRAME(): string;
+    /**
+     * @description Event.EXIT_FRAME 定数は、exitFrame イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.EXIT_FRAME constant defines the value
+     *              of the type property of an exitFrame event object.
+     *
+     * @return  {string}
+     * @default exitFrame
+     * @const
+     * @static
+     */
+    static get EXIT_FRAME(): string;
+    /**
+     * @description Event.FRAME_CONSTRUCTED 定数は、frameConstructed イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.FRAME_CONSTRUCTED constant defines the value
+     *              of the type property of an frameConstructed event object.
+     *
+     * @return  {string}
+     * @default frameConstructed
+     * @const
+     * @static
+     */
+    static get FRAME_CONSTRUCTED(): string;
+    /**
+     * @description Event.FRAME_LABEL 定数は、frameLabel イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.FRAME_LABEL constant defines the value
+     *              of the type property of an frameLabel event object.
+     *
+     * @return  {string}
+     * @default frameLabel
+     * @const
+     * @static
+     */
+    static get FRAME_LABEL(): string;
+    /**
+     * @description Event.INIT 定数は、init イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.INIT constant defines the value
+     *              of the type property of an init event object.
+     *
+     * @return  {string}
+     * @default frameConstructed
+     * @const
+     * @static
+     */
+    static get INIT(): string;
+    /**
+     * @description Event.LOAD 定数は、load イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.LOAD constant defines the value
+     *              of the type property of an load event object.
+     *
+     * @return  {string}
+     * @default frameConstructed
+     * @const
+     * @static
+     */
+    static get LOAD(): string;
+    /**
+     * @description Event.MOUSE_LEAVE 定数は、mouseLeave イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.MOUSE_LEAVE constant defines the value
+     *              of the type property of a mouseLeave event object.
+     *
+     * @return  {string}
+     * @default mouseLeave
+     * @const
+     * @static
+     */
+    static get MOUSE_LEAVE(): string;
+    /**
+     * @description Event.REMOVED 定数は、removed プロパティ（paste イベントオブジェクト）の値を定義します。
+     *              The Event.REMOVED constant defines the value
+     *              of the type property of a removed event object.
+     *
+     * @return  {string}
+     * @default removed
+     * @const
+     * @static
+     */
+    static get REMOVED(): string;
+    /**
+     * @description Event.REMOVED_FROM_STAGE 定数は、removedFromStage イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.REMOVED_FROM_STAGE constant defines the value
+     *              of the type property of a removedFromStage event object.
+     *
+     * @return  {string}
+     * @default removedFromStage
+     * @const
+     * @static
+     */
+    static get REMOVED_FROM_STAGE(): string;
+    /**
+     * @description Event.RENDER 定数は、render イベントオブジェクトの
+     *              type プロパティの値を定義します。
+     *              The Event.RENDER constant defines the value
+     *              of the type property of a render event object.
+     *
+     * @return {string}
+     * @default render
+     * @const
+     * @static
+     */
+    static get RENDER(): string;
+    /**
+     * @description Event.RESIZE 定数は、resize イベントオブジェクトの
+     *              type プロパティの値を定義します。
+     *              The Event.RESIZE constant defines the value
+     *              of the type property of a resize event object.
+     *
+     * @return {string}
+     * @default resize
+     * @const
+     * @static
+     */
+    static get RESIZE(): string;
+    /**
+     * @description Event.SCROLL 定数は、render イベントオブジェクトの
+     *              type プロパティの値を定義します。
+     *              The Event.SCROLL constant defines the value
+     *              of the type property of a render event object.
+     *
+     * @return {string}
+     * @default scroll
+     * @const
+     * @static
+     */
+    static get SCROLL(): string;
+    /**
+     * @description Event.OPEN 定数は、render イベントオブジェクトの
+     *              type プロパティの値を定義します。
+     *              The Event.OPEN constant defines the value
+     *              of the type property of a render event object.
+     *
+     * @return {string}
+     * @default open
+     * @const
+     * @static
+     */
+    static get OPEN(): string;
+    /**
+     * @description Event.STOP 定数は、render イベントオブジェクトの
+     *              type プロパティの値を定義します。
+     *              The Event.STOP constant defines the value
+     *              of the type property of a render event object.
+     *
+     * @return {string}
+     * @default stop
+     * @const
+     * @static
+     */
+    static get STOP(): string;
+    /**
+     * @description Event.SOUND_COMPLETE 定数は、soundComplete イベントオブジェクトの type プロパティの値を定義します。
+     *              The Event.SOUND_COMPLETE constant defines the value
+     *              of the type property of a soundComplete event object.
+     *
+     * @return {string}
+     * @default render
+     * @const
+     * @static
+     */
+    static get SOUND_COMPLETE(): string;
+    /**
+     * @description Event.UPDATE 定数は、render イベントオブジェクトの
+     *              type プロパティの値を定義します。
+     *              The Event.STOP constant defines the value
+     *              of the type property of a render event object.
+     *
+     * @return {string}
+     * @default update
+     * @const
+     * @static
+     */
+    static get UPDATE(): string;
+    /**
+     * @description イベントがバブリングイベントかどうかを示します。
+     *              Indicates whether an event is a bubbling event.
+     *
+     * @member {boolean}
+     * @readonly
+     * @public
+     */
+    get bubbles(): boolean;
+    /**
+     * @description イベントに関連付けられた動作を回避できるかどうかを示します。
+     *              Indicates whether the behavior associated
+     *              with the event can be prevented.
+     *
+     * @member {boolean}
+     * @readonly
+     * @public
+     */
+    get cancelable(): boolean;
+    /**
+     * @description イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
+     *              The object that is actively processing the Event object
+     *              with an event listener.
+     *
+     * @member {EventDispatcher|null}
+     * @public
+     */
+    get currentTarget(): EventDispatcher | null;
+    set currentTarget(current_target: EventDispatcher | null);
+    /**
+     * @description イベントフローの現在の段階です。
+     *              The current phase in the event flow.
+     *
+     * @member {number}
+     * @public
+     */
+    get eventPhase(): number;
+    set eventPhase(event_phase: number);
+    /**
+     * @description 現在コールされている関数
+     *              Function currently being called.
+     *
+     * @member {function}
+     * @public
+     */
+    get listener(): Function | null;
+    set listener(listener: Function | null);
+    /**
+     * @description イベントターゲットです。
+     *              The event target.
+     *
+     * @member {EventDispatcher|null}
+     * @public
+     */
+    get target(): any;
+    set target(target: any);
+    /**
+     * @description イベントのタイプです。
+     *              The type of event.
+     *
+     * @member {string}
+     * @readonly
+     * @public
+     */
+    get type(): string;
+    /**
+     * @description カスタム ActionScript 3.0 Event クラスに
+     *              toString() メソッドを実装するためのユーティリティ関数です。
+     *              A utility function for implementing the toString() method
+     *              in custom ActionScript 3.0 Event classes.
+     *
+     * @return {string}
+     * @method
+     * @public
+     */
+    formatToString(...args: string[]): string;
+    /**
+     * @description イベントフローの現在のノードおよび後続するノードで、
+     *              イベントリスナーが処理されないようにします。
+     *              Prevents processing of any event listeners in the current node
+     *              and any subsequent nodes in the event flow.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    stopImmediatePropagation(): void;
+    /**
+     * @description イベントフローの現在のノードに後続するノードで
+     *              イベントリスナーが処理されないようにします。
+     *              Prevents processing of any event listeners in nodes subsequent
+     *              to the current node in the event flow.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    stopPropagation(): void;
+}