@next2d/display 1.18.12 → 2.0.0

package/src/MovieClip/usecase/MovieClipGoToFrameUseCase.js

@@ -0,0 +1,58 @@
+import { execute as movieClipGetFrameForLabelService } from "../service/MovieClipGetFrameForLabelService";
+import { execute as displayObjectApplyChangesService } from "../../DisplayObject/service/DisplayObjectApplyChangesService";
+import { execute as movieClipPrepareActionUseCase } from "./MovieClipPrepareActionUseCase";
+/**
+ * @description 指定フレームに移動する
+ *              Move to the specified frame
+ *
+ * @param {MovieClip} movie_clip
+ * @param {string | number} value
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip, value) => {
+    if (movie_clip.totalFrames === 1) {
+        return;
+    }
+    let frame = +value;
+    if (isNaN(frame)) {
+        frame = movieClipGetFrameForLabelService(movie_clip, `${value}`);
+    }
+    if (1 > frame) {
+        frame = 1;
+    }
+    // 移動先が現在のフレームと同じ場合は何もしない
+    if (movie_clip.currentFrame === frame) {
+        return;
+    }
+    // 最大フレーム数を超えた場合
+    if (frame > movie_clip.totalFrames) {
+        if (movie_clip.currentFrame === movie_clip.totalFrames) {
+            return;
+        }
+        // フラグを更新
+        movie_clip.$wait = true;
+        movie_clip.$canSound = true;
+        movie_clip.$canAction = true;
+        movie_clip.$hasTimelineHeadMoved = true;
+        // fixed logic
+        movie_clip.currentFrame = movie_clip.totalFrames;
+        // アクション準備
+        movieClipPrepareActionUseCase(movie_clip);
+        // 更新
+        displayObjectApplyChangesService(movie_clip);
+        return;
+    }
+    // フレームをセット
+    movie_clip.currentFrame = frame;
+    // フラグを更新
+    movie_clip.$wait = true;
+    movie_clip.$canSound = true;
+    movie_clip.$canAction = true;
+    movie_clip.$hasTimelineHeadMoved = true;
+    // 更新
+    displayObjectApplyChangesService(movie_clip);
+    // アクション準備
+    movieClipPrepareActionUseCase(movie_clip);
+};

package/src/MovieClip/usecase/MovieClipGotoAndPlayUseCase.d.ts

@@ -0,0 +1,12 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description 指定フレームに移動して再生する
+ *              Move to the specified frame and play
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {string | number} frame
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip, frame: string | number) => void;

package/src/MovieClip/usecase/MovieClipGotoAndPlayUseCase.js

@@ -0,0 +1,15 @@
+import { execute as movieClipGoToFrameUseCase } from "./MovieClipGoToFrameUseCase";
+/**
+ * @description 指定フレームに移動して再生する
+ *              Move to the specified frame and play
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {string | number} frame
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip, frame) => {
+    movie_clip.play();
+    movieClipGoToFrameUseCase(movie_clip, frame);
+};

package/src/MovieClip/usecase/MovieClipGotoAndStopUseCase.d.ts

@@ -0,0 +1,12 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description 指定フレームに移動して停止する
+ *              Move to the specified frame and stop
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {string | number} frame
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip, frame: string | number) => void;

package/src/MovieClip/usecase/MovieClipGotoAndStopUseCase.js

@@ -0,0 +1,16 @@
+import { execute as movieClipGoToFrameUseCase } from "./MovieClipGoToFrameUseCase";
+/**
+ * @description 指定フレームに移動して停止する
+ *              Move to the specified frame and stop
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {string | number} frame
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip, frame) => {
+    movie_clip.stop();
+    movieClipGoToFrameUseCase(movie_clip, frame);
+    movie_clip.$wait = false;
+};

package/src/MovieClip/usecase/MovieClipNextFrameUseCase.d.ts

@@ -0,0 +1,11 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description 次のフレームに移動して停止する
+ *              Move to the next frame and stop
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip) => void;

package/src/MovieClip/usecase/MovieClipNextFrameUseCase.js

@@ -0,0 +1,17 @@
+import { execute as movieClipGoToFrameUseCase } from "./MovieClipGoToFrameUseCase";
+/**
+ * @description 次のフレームに移動して停止する
+ *              Move to the next frame and stop
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip) => {
+    if (movie_clip.totalFrames <= movie_clip.currentFrame) {
+        return;
+    }
+    movie_clip.stop();
+    movieClipGoToFrameUseCase(movie_clip, movie_clip.currentFrame + 1);
+};

package/src/MovieClip/usecase/MovieClipPrepareActionUseCase.d.ts

@@ -0,0 +1,11 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description MovieClipのFrameLabel Eventを発火して、アクションを登録
+ *              Fire the FrameLabel Event of MovieClip and register the action
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip) => void;

package/src/MovieClip/usecase/MovieClipPrepareActionUseCase.js

@@ -0,0 +1,21 @@
+import { execute as movieClipDispatchFrameLabelEventService } from "../service/MovieClipDispatchFrameLabelEventService";
+import { execute as movieClipSetActionService } from "../service/MovieClipSetActionService";
+/**
+ * @description MovieClipのFrameLabel Eventを発火して、アクションを登録
+ *              Fire the FrameLabel Event of MovieClip and register the action
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip) => {
+    if (!movie_clip.$canAction) {
+        return;
+    }
+    movie_clip.$canAction = false;
+    // dispatch frame label event
+    movieClipDispatchFrameLabelEventService(movie_clip, movie_clip.$labels);
+    // set frame action
+    movieClipSetActionService(movie_clip, movie_clip.$actions);
+};

package/src/MovieClip/usecase/MovieClipPrepareSoundUseCase.d.ts

@@ -0,0 +1,11 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description MovieClipの現在のフレームのサウンドを登録
+ *              Register the sound of the current frame of MovieClip
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip) => void;

package/src/MovieClip/usecase/MovieClipPrepareSoundUseCase.js

@@ -0,0 +1,18 @@
+import { execute as movieClipSetSoundsService } from "../service/MovieClipSetSoundsService";
+/**
+ * @description MovieClipの現在のフレームのサウンドを登録
+ *              Register the sound of the current frame of MovieClip
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip) => {
+    if (!movie_clip.$canSound) {
+        return;
+    }
+    movie_clip.$canSound = false;
+    // set frame sound
+    movieClipSetSoundsService(movie_clip, movie_clip.$sounds);
+};

package/src/MovieClip/usecase/MovieClipPrevFrameUseCase.d.ts

@@ -0,0 +1,11 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description ムービークリップの再生を一つ前のフレームに移動させる
+ *              Moves the playback of a movie clip to the previous frame.
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip) => void;

package/src/MovieClip/usecase/MovieClipPrevFrameUseCase.js

@@ -0,0 +1,17 @@
+import { execute as movieClipGoToFrameUseCase } from "./MovieClipGoToFrameUseCase";
+/**
+ * @description ムービークリップの再生を一つ前のフレームに移動させる
+ *              Moves the playback of a movie clip to the previous frame.
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip) => {
+    if (2 > movie_clip.currentFrame) {
+        return;
+    }
+    movie_clip.stop();
+    movieClipGoToFrameUseCase(movie_clip, movie_clip.currentFrame - 1);
+};

package/{dist → src}/MovieClip.d.ts

@@ -1,95 +1,159 @@
+import type { IDisplayObject } from "./interface/IDisplayObject";
+import type { ICharacter } from "./interface/ICharacter";
+import type { LoaderInfo } from "./LoaderInfo";
 import { Sprite } from "./Sprite";
 import { FrameLabel } from "./FrameLabel";
 import { Sound } from "@next2d/media";
-import type { LoopConfigImpl, ParentImpl, MovieClipCharacterImpl, DictionaryTagImpl, Character } from "@next2d/interface";
 /**
- * MovieClip クラスは、Sprite、DisplayObjectContainer、InteractiveObject、DisplayObject
- * および EventDispatcher クラスを継承します。
- * MovieClip オブジェクトには、Sprite オブジェクトとは違ってタイムラインがあります。
- * タイムラインの再生ヘッドが停止されても、その MovieClip オブジェクトの子 MovieClip オブジェクトの再生ヘッドは停止しません。
+ * @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.
+ *              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 declare class MovieClip extends Sprite {
-    private _$labels;
-    _$currentFrame: number;
-    _$stopFlag: boolean;
-    _$canAction: boolean;
-    _$canSound: boolean;
-    _$actionProcess: boolean;
-    _$actions: Map<number, Function[]>;
-    _$frameCache: Map<string, any>;
-    _$sounds: Map<number, Sound[]>;
-    _$actionOffset: number;
-    _$actionLimit: number;
-    _$totalFrames: number;
-    _$isPlaying: boolean;
-    _$loopConfig: LoopConfigImpl | null;
-    private _$tweenFrame;
     /**
-     * @constructor
+     * @description フレーム毎のラベルマップ
+     *              Label map per frame
+     *
+     * @type {Map<number, FrameLabel>}
+     * @default null
+     * @private
+     */
+    $labels: Map<number, FrameLabel> | null;
+    /**
+     * @description フレーム毎のアクションマップ
+     *              Action map per frame
+     *
+     * @type {Map<number, Function[]>}
+     * @default null
+     * @private
+     */
+    $actions: Map<number, Function[]> | null;
+    /**
+     * @description フレーム毎のサウンドマップ
+     *              Sound map per frame
+     *
+     * @type {Map<number, Sound[]>}
+     * @default null
+     * @private
+     */
+    $sounds: Map<number, Sound[]> | null;
+    /**
+     * @description アクション実行フラグ
+     *              Action execution flag
+     *
+     * @type {boolean}
+     * @default true
+     * @private
+     */
+    $canAction: boolean;
+    /**
+     * @description 待機フラグ
+     *              Wait flag
+     *
+     * @type {boolean}
+     * @default false
+     * @private
+     */
+    $wait: boolean;
+    /**
+     * @description MovieClip インスタンス内のフレーム総数です。
+     *              The total number of frames in the MovieClip instance.
+     *
+     * @member  {number}
+     * @default 1
+     * @readonly
      * @public
      */
-    constructor();
+    totalFrames: number;
     /**
-     * @description 指定されたクラスのストリングを返します。
-     *              Returns the string representation of the specified class.
+     * @description MovieClipのタイムライン内の再生ヘッドが置かれているフレームの番号を示します。
+     *              Specifies the number of the frame in which the playhead is located
      *
-     * @return  {string}
-     * @default [class MovieClip]
-     * @method
-     * @static
+     * @member {number}
+     * @default 1
+     * @readonly
+     * @public
+     */
+    currentFrame: number;
+    /**
+     * @description 停止フラグ
+     *              Stop flag
+     *
+     * @type {boolean}
+     * @default false
+     * @private
+     */
+    private _$stopFlag;
+    /**
+     * @description サウンド実行フラグ
+     *              Sound execution flag
+     *
+     * @type {boolean}
+     * @default true
+     * @private
+     */
+    $canSound: boolean;
+    /**
+     * @description タイムラインヘッドが移動したかどうか
+     *              Whether the timeline head has moved
+     *
+     * @type {boolean}
+     * @default true
+     * @private
      */
-    static toString(): string;
+    $hasTimelineHeadMoved: boolean;
+    /**
+     * @description MovieClipの機能を所持しているかを返却
+     *              Returns whether the display object has MovieClip functionality.
+     *
+     * @type {boolean}
+     * @readonly
+     * @public
+     */
+    readonly isTimelineEnabled: boolean;
+    /**
+     * @constructor
+     * @public
+     */
+    constructor();
     /**
      * @description 指定されたクラスの空間名を返します。
      *              Returns the space name of the specified class.
      *
-     * @return  {string}
-     * @default next2d.display.MovieClip
+     * @return {string}
      * @const
      * @static
      */
     static get namespace(): string;
-    /**
-     * @description 指定されたオブジェクトのストリングを返します。
-     *              Returns the string representation of the specified object.
-     *
-     * @return  {string}
-     * @default [object MovieClip]
-     * @method
-     * @public
-     */
-    toString(): string;
     /**
      * @description 指定されたオブジェクトの空間名を返します。
      *              Returns the space name of the specified object.
      *
-     * @return  {string}
-     * @default next2d.display.MovieClip
+     * @return {string}
      * @const
      * @public
      */
     get namespace(): string;
     /**
-     * @description MovieClip インスタンスのタイムライン内の再生ヘッドが置かれているフレームの番号を示します。
-     *              Specifies the number of the frame in which the playhead is located
-     *              in the timeline of the MovieClip instance.
+     * @description コンテナのアクティブな子要素を返却
+     *              Returns the active child elements of the container.
      *
-     * @member {number}
-     * @default 1
-     * @readonly
-     * @public
+     * @return {array}
+     * @method
+     * @protected
      */
-    get currentFrame(): number;
+    get children(): IDisplayObject<any>;
     /**
      * @description MovieClip インスタンスのタイムライン内の現在のフレームにあるラベルです。
      *              The label at the current frame in the timeline of the MovieClip instance.
@@ -103,7 +167,7 @@ export declare class MovieClip extends Sprite {
      * @description 現在のシーンの FrameLabel オブジェクトの配列を返します。
      *              Returns an array of FrameLabel objects from the current scene.
      *
-     * @member  {array|null}
+     * @member  {FrameLabel[]|null}
      * @readonly
      * @public
      */
@@ -118,16 +182,6 @@ export declare class MovieClip extends Sprite {
      * @public
      */
     get isPlaying(): boolean;
-    /**
-     * @description MovieClip インスタンス内のフレーム総数です。
-     *              The total number of frames in the MovieClip instance.
-     *
-     * @member  {number}
-     * @default 1
-     * @readonly
-     * @public
-     */
-    get totalFrames(): number;
     /**
      * @description MovieClipのフレームヘッダーの移動方法の設定オブジェクトを返します。
      *              Returns a configuration object for how MovieClip's frame headers are moved.
@@ -136,13 +190,11 @@ export declare class MovieClip extends Sprite {
      * @default null
      * @public
      */
-    get loopConfig(): LoopConfigImpl | null;
-    set loopConfig(loop_config: LoopConfigImpl | null);
     /**
      * @description 指定されたフレームで SWF ファイルの再生を開始します。
      *              Starts playing the SWF file at the specified frame.
      *
-     * @param  {number|string} frame
+     * @param  {string|number} frame
      * @return {void}
      * @method
      * @public
@@ -199,111 +251,20 @@ export declare class MovieClip extends Sprite {
      * @description タイムラインに対して動的にLabelを追加できます。
      *              Labels can be added dynamically to the timeline.
      *
-     * @example <caption>Example1 usage of addFrameLabel.</caption>
-     * // case 1
-     * const {MovieClip, FrameLabel} = next2d.display;
-     * const movieClip = new MovieClip();
-     * movieClip.addFrameLabel(new FrameLabel(1, "start"));
-     *
      * @param  {FrameLabel} frame_label
      * @return {void}
      * @public
      */
     addFrameLabel(frame_label: FrameLabel): void;
     /**
-     * @description 指定のフレームのアクションを追加できます
-     *              You can add an action for a given frame.
-     *
-     * @example <caption>Example1 usage of addFrameScript.</caption>
-     * // case 1
-     * const {MovieClip} = next2d.display;
-     * const movieClip = new MovieClip();
-     * movieClip.addFrameScript(1 , function ()
-     * {
-     *     this.stop();
-     * });
+     * @description character 情報を元に DisplayObject を構築
+     *              Build DisplayObject based on character
      *
-     * @example <caption>Example3 usage of addFrameScript.</caption>
-     * // case 2
-     * const {MovieClip} = next2d.display;
-     * const movieClip = new MovieClip();
-     * movieClip.addFrameScript(1, method_1, 2, method_2, 10, method_10);
-     *
-     * @return {void}
-     * @method
-     * @public
-     */
-    addFrameScript(...args: any[]): void;
-    /**
-     * @param  {string} name
-     * @return {number}
-     * @private
-     */
-    _$getFrameForLabel(name: string): number;
-    /**
-     * @param  {number}   frame
-     * @param  {function} script
+     * @param  {ICharacter} character
+     * @param  {LoaderInfo} [loader_info=null]
      * @return {void}
      * @method
-     * @private
-     */
-    _$addAction(frame: number, script: Function): void;
-    /**
-     * @return {void}
-     * @private
-     */
-    _$setAction(): void;
-    /**
-     * @param  {number|string} value
-     * @return {void}
-     * @private
-     */
-    _$goToFrame(value: string | number): void;
-    /**
-     * @return {void}
-     * @method
-     * @private
-     */
-    _$prepareActions(): void;
-    /**
-     * @return {boolean}
-     * @method
-     * @private
-     */
-    _$nextFrame(): boolean;
-    /**
-     * @param  {LoopConfig} loop_config
-     * @return {number}
-     * @method
-     * @private
-     */
-    _$getLoopFrame(loop_config: LoopConfigImpl): number;
-    /**
-     * @param  {object} character
-     * @return {void}
-     * @method
-     * @private
-     */
-    _$buildCharacter(character: MovieClipCharacterImpl): void;
-    /**
-     * @param  {object} character
-     * @return {void}
-     * @method
-     * @private
-     */
-    _$sync(character: Character<MovieClipCharacterImpl>): void;
-    /**
-     * @param  {object} tag
-     * @param  {DisplayObjectContainer} parent
-     * @return {object}
-     * @method
-     * @private
-     */
-    _$build(tag: DictionaryTagImpl, parent: ParentImpl<any>): MovieClipCharacterImpl;
-    /**
-     * @return {void}
-     * @method
-     * @private
+     * @protected
      */
-    _$soundPlay(): void;
+    $sync(character: ICharacter, loader_info?: LoaderInfo | null): void;
 }