@next2d/display 1.18.11 → 2.0.0

package/src/MovieClip/service/MovieClipAddFrameLabelService.js

@@ -0,0 +1,16 @@
+/**
+ * @description ラベル情報をマップに追加
+ *              Add label information to map
+ *
+ * @param  {MovieClip} movei_clip
+ * @param  {FrameLabel} frame_label
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movei_clip, frame_label) => {
+    if (!movei_clip.$labels) {
+        movei_clip.$labels = new Map();
+    }
+    movei_clip.$labels.set(frame_label.frame, frame_label);
+};

package/src/MovieClip/service/MovieClipAddLabelsService.d.ts

@@ -0,0 +1,13 @@
+import type { IMovieClipLabelObject } from "../../interface/IMovieClipLabelObject";
+import { FrameLabel } from "../../FrameLabel";
+/**
+ * @description ラベル情報をマップに追加
+ *              Add label information to map
+ *
+ * @param  {Map} label_map
+ * @param  {array} labels
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (label_map: Map<number, FrameLabel>, labels: IMovieClipLabelObject[]) => void;

package/src/MovieClip/service/MovieClipAddLabelsService.js

@@ -0,0 +1,20 @@
+import { FrameLabel } from "../../FrameLabel";
+/**
+ * @description ラベル情報をマップに追加
+ *              Add label information to map
+ *
+ * @param  {Map} label_map
+ * @param  {array} labels
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (label_map, labels) => {
+    for (let idx = 0; idx < labels.length; ++idx) {
+        const label = labels[idx];
+        if (!label) {
+            continue;
+        }
+        label_map.set(label.frame, new FrameLabel(label.name, label.frame));
+    }
+};

package/src/MovieClip/service/MovieClipBuildSoundsService.d.ts

@@ -0,0 +1,15 @@
+import type { MovieClip } from "../../MovieClip";
+import type { IMovieClipSoundObject } from "../../interface/IMovieClipSoundObject";
+import { Sound } from "@next2d/media";
+/**
+ * @description 指定tagの情報を元に、MovieClipにサウンドを追加
+ *              Add sound to MovieClip based on specified tag information
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {Map} sound_map
+ * @param  {array} sound_objects
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export declare const execute: (movie_clip: MovieClip, sound_map: Map<number, Sound[]>, sound_objects: IMovieClipSoundObject[]) => Promise<void>;

package/src/MovieClip/service/MovieClipBuildSoundsService.js

@@ -0,0 +1,47 @@
+import { $getArray } from "../../DisplayObjectUtil";
+import { Sound, SoundMixer } from "@next2d/media";
+/**
+ * @description 指定tagの情報を元に、MovieClipにサウンドを追加
+ *              Add sound to MovieClip based on specified tag information
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {Map} sound_map
+ * @param  {array} sound_objects
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export const execute = async (movie_clip, sound_map, sound_objects) => {
+    const loaderInfo = movie_clip.loaderInfo;
+    if (!loaderInfo) {
+        return;
+    }
+    const data = loaderInfo.data;
+    if (!data) {
+        return;
+    }
+    const characters = data.characters;
+    for (let idx = 0; idx < sound_objects.length; ++idx) {
+        const object = sound_objects[idx];
+        if (!object) {
+            continue;
+        }
+        const sounds = $getArray();
+        for (let idx = 0; idx < object.sound.length; ++idx) {
+            const tag = object.sound[idx];
+            if (!tag) {
+                continue;
+            }
+            const character = characters[tag.characterId];
+            if (!character) {
+                continue;
+            }
+            const sound = new Sound();
+            sound.loopCount = tag.loopCount | 0;
+            sound.volume = Math.min(SoundMixer.volume, tag.volume);
+            await sound.$build(character);
+            sounds.push(sound);
+        }
+        sound_map.set(object.frame, sounds);
+    }
+};

package/src/MovieClip/service/MovieClipCurrentFrameLabelService.d.ts

@@ -0,0 +1,12 @@
+import type { FrameLabel } from "../../FrameLabel";
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description 現在のフレームラベルがあれば返却、なければnullを返却
+ *              Returns the current frame label if it exists, otherwise returns null.
+ *
+ * @param  {MovieClip} movei_clip
+ * @return {FrameLabel | null}
+ * @method
+ * @protected
+ */
+export declare const execute: (movei_clip: MovieClip) => FrameLabel | null;

package/src/MovieClip/service/MovieClipCurrentFrameLabelService.js

@@ -0,0 +1,19 @@
+/**
+ * @description 現在のフレームラベルがあれば返却、なければnullを返却
+ *              Returns the current frame label if it exists, otherwise returns null.
+ *
+ * @param  {MovieClip} movei_clip
+ * @return {FrameLabel | null}
+ * @method
+ * @protected
+ */
+export const execute = (movei_clip) => {
+    if (!movei_clip.$labels) {
+        return null;
+    }
+    const frame = movei_clip.currentFrame;
+    if (!movei_clip.$labels.has(frame)) {
+        return null;
+    }
+    return movei_clip.$labels.get(frame) || null;
+};

package/src/MovieClip/service/MovieClipCurrentLabelsService.d.ts

@@ -0,0 +1,12 @@
+import type { FrameLabel } from "../../FrameLabel";
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description 指定のMovieClipのフレームラベルを全て返却、なければnullを返却
+ *              Returns all frame labels of the specified MovieClip, otherwise returns null.
+ *
+ * @param {MovieClip} movei_clip
+ * @return {FrameLabel[] | null}
+ * @method
+ * @protected
+ */
+export declare const execute: (movei_clip: MovieClip) => FrameLabel[] | null;

package/src/MovieClip/service/MovieClipCurrentLabelsService.js

@@ -0,0 +1,14 @@
+/**
+ * @description 指定のMovieClipのフレームラベルを全て返却、なければnullを返却
+ *              Returns all frame labels of the specified MovieClip, otherwise returns null.
+ *
+ * @param {MovieClip} movei_clip
+ * @return {FrameLabel[] | null}
+ * @method
+ * @protected
+ */
+export const execute = (movei_clip) => {
+    return !movei_clip.$labels || !movei_clip.$labels.size
+        ? null
+        : Array.from(movei_clip.$labels.values());
+};

package/src/MovieClip/service/MovieClipDispatchFrameLabelEventService.d.ts

@@ -0,0 +1,13 @@
+import type { MovieClip } from "../../MovieClip";
+import type { FrameLabel } from "../../FrameLabel";
+/**
+ * @description MovieClipのフレームラベルイベントを実行
+ *              Execute the frame label event of MovieClip
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {Map} [labels=null]
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip, labels?: Map<number, FrameLabel> | null) => void;

package/src/MovieClip/service/MovieClipDispatchFrameLabelEventService.js

@@ -0,0 +1,24 @@
+import { Event } from "@next2d/events";
+/**
+ * @description MovieClipのフレームラベルイベントを実行
+ *              Execute the frame label event of MovieClip
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {Map} [labels=null]
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip, labels = null) => {
+    if (!labels || !labels.size) {
+        return;
+    }
+    const frame = movie_clip.currentFrame;
+    if (!labels.has(frame)) {
+        return;
+    }
+    const frameLabel = labels.get(frame);
+    if (frameLabel.willTrigger(Event.FRAME_LABEL)) {
+        frameLabel.dispatchEvent(new Event(Event.FRAME_LABEL));
+    }
+};

package/src/MovieClip/service/MovieClipGetChildrenService.d.ts

@@ -0,0 +1,13 @@
+import type { DisplayObject } from "../../DisplayObject";
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description MovieClipの現在のフレームに設置されている子要素の取得
+ *              Get the child elements placed on the current frame of MovieClip
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {DisplayObject[]} children
+ * @return {DisplayObject[]}
+ * @method
+ * @public
+ */
+export declare const execute: <D extends DisplayObject>(movie_clip: MovieClip, children: D[]) => D[];

package/src/MovieClip/service/MovieClipGetChildrenService.js

@@ -0,0 +1,133 @@
+import { execute as movieClipBuildDictionaryCharacterUseCase } from "../usecase/MovieClipBuildDictionaryCharacterUseCase";
+import { execute as displayObjectContainerRemovedToStageService } from "../../DisplayObjectContainer/service/DisplayObjectContainerRemovedToStageService";
+import { $cacheStore } from "@next2d/cache";
+import { Event } from "@next2d/events";
+/**
+ * @description MovieClip の子要素で次のフレームに移動するDisplayObjectの格納マップ
+ *              Storage map of DisplayObjects that move to the next frame in the child elements of MovieClip
+ *
+ * @type {Map<number, IDisplayObject<any>>}
+ * @private
+ */
+const $stayDisplayObjectMap = new Map();
+/**
+ * @description MovieClipの現在のフレームに設置されている子要素の取得
+ *              Get the child elements placed on the current frame of MovieClip
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {DisplayObject[]} children
+ * @return {DisplayObject[]}
+ * @method
+ * @public
+ */
+export const execute = (movie_clip, children) => {
+    const loaderInfo = movie_clip.loaderInfo;
+    if (!loaderInfo || !loaderInfo.data) {
+        return children;
+    }
+    const character = loaderInfo.data.characters[movie_clip.characterId];
+    if (!character) {
+        return children;
+    }
+    const frame = movie_clip.currentFrame;
+    const controller = character.controller[frame];
+    if (!controller) {
+        return children;
+    }
+    const caches = [];
+    const dictionary = character.dictionary;
+    if (!children.length) {
+        for (let idx = 0; idx < controller.length; ++idx) {
+            if (!(idx in controller)) {
+                continue;
+            }
+            const dictionaryId = controller[idx];
+            if (typeof dictionaryId !== "number") {
+                continue;
+            }
+            const tag = dictionary[dictionaryId];
+            if (!tag) {
+                continue;
+            }
+            const character = loaderInfo.data.characters[tag.characterId];
+            if (!character) {
+                continue;
+            }
+            const displayObject = movieClipBuildDictionaryCharacterUseCase(dictionaryId, tag, character, movie_clip, idx);
+            if (!displayObject) {
+                continue;
+            }
+            children.push(displayObject);
+            if (displayObject.isContainerEnabled) {
+                caches.push(displayObject);
+            }
+        }
+        movie_clip.$container = caches;
+        return children;
+    }
+    for (let idx = 0; idx < children.length; ++idx) {
+        const displayObject = children[idx];
+        if (!displayObject) {
+            continue;
+        }
+        const startFrame = displayObject.startFrame;
+        const endFrame = displayObject.endFrame;
+        if (startFrame === 1 && endFrame === 0
+            || startFrame <= frame && endFrame > frame) {
+            $stayDisplayObjectMap.set(displayObject.dictionaryId, displayObject);
+            continue;
+        }
+        // remove
+        if (displayObject.uniqueKey && $cacheStore.has(displayObject.uniqueKey)) {
+            $cacheStore.removeTimer(displayObject.uniqueKey);
+        }
+        if (displayObject.willTrigger(Event.REMOVED)) {
+            displayObject.dispatchEvent(new Event(Event.REMOVED, true));
+        }
+        if (displayObject.willTrigger(Event.REMOVED_FROM_STAGE)) {
+            displayObject.dispatchEvent(new Event(Event.REMOVED_FROM_STAGE, true));
+        }
+        if (displayObject.isVideo) {
+            displayObject.pause();
+        }
+        if (displayObject.isContainerEnabled) {
+            displayObjectContainerRemovedToStageService(displayObject);
+        }
+    }
+    children.length = 0;
+    for (let idx = 0; idx < controller.length; ++idx) {
+        if (!(idx in controller)) {
+            continue;
+        }
+        const dictionaryId = controller[idx];
+        if (typeof dictionaryId !== "number") {
+            continue;
+        }
+        if ($stayDisplayObjectMap.has(dictionaryId)) {
+            const displayObject = $stayDisplayObjectMap.get(dictionaryId);
+            displayObject.placeId = idx;
+            displayObject.placeObject = null;
+            children.push(displayObject);
+            continue;
+        }
+        const tag = dictionary[dictionaryId];
+        if (!tag) {
+            continue;
+        }
+        const character = loaderInfo.data.characters[tag.characterId];
+        if (!character) {
+            continue;
+        }
+        const displayObject = movieClipBuildDictionaryCharacterUseCase(dictionaryId, tag, character, movie_clip, idx);
+        if (!displayObject) {
+            continue;
+        }
+        children.push(displayObject);
+        if (displayObject.isContainerEnabled) {
+            caches.push(displayObject);
+        }
+    }
+    movie_clip.$container = caches;
+    $stayDisplayObjectMap.clear();
+    return children;
+};

package/src/MovieClip/service/MovieClipGetFrameForLabelService.d.ts

@@ -0,0 +1,12 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description ラベル名に対応するフレーム番号を取得します。
+ *              Get the frame number corresponding to the label name.
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {string} name
+ * @return {number}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip, name: string) => number;

package/src/MovieClip/service/MovieClipGetFrameForLabelService.js

@@ -0,0 +1,22 @@
+/**
+ * @description ラベル名に対応するフレーム番号を取得します。
+ *              Get the frame number corresponding to the label name.
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {string} name
+ * @return {number}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip, name) => {
+    if (!movie_clip.$labels || !movie_clip.$labels.size) {
+        return 0;
+    }
+    for (const [frame, frameLabel] of movie_clip.$labels) {
+        if (frameLabel.name !== name) {
+            continue;
+        }
+        return frame;
+    }
+    return 0;
+};

package/src/MovieClip/service/MovieClipSetActionService.d.ts

@@ -0,0 +1,12 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description MovieClipのアクションを配列にセット
+ *              Set the action of MovieClip to an array
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {Map} [actions=null]
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip, actions?: Map<number, Function[]> | null) => void;

package/src/MovieClip/service/MovieClipSetActionService.js

@@ -0,0 +1,21 @@
+import { $actions } from "../../DisplayObjectUtil";
+/**
+ * @description MovieClipのアクションを配列にセット
+ *              Set the action of MovieClip to an array
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {Map} [actions=null]
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip, actions = null) => {
+    if (!actions || !actions.size) {
+        return;
+    }
+    const frame = movie_clip.currentFrame;
+    if (!actions.has(frame)) {
+        return;
+    }
+    $actions.push(movie_clip);
+};

package/src/MovieClip/service/MovieClipSetSoundsService.d.ts

@@ -0,0 +1,13 @@
+import type { MovieClip } from "../../MovieClip";
+import type { Sound } from "@next2d/media";
+/**
+ * @description MovieClipのサウンドを配列にセット
+ *              Set the sound of MovieClip to an array
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {Map} [sounds=null]
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip, sounds?: Map<number, Sound[]> | null) => void;

package/src/MovieClip/service/MovieClipSetSoundsService.js

@@ -0,0 +1,21 @@
+import { $sounds } from "../../DisplayObjectUtil";
+/**
+ * @description MovieClipのサウンドを配列にセット
+ *              Set the sound of MovieClip to an array
+ *
+ * @param  {MovieClip} movie_clip
+ * @param  {Map} [sounds=null]
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip, sounds = null) => {
+    if (!sounds || !sounds.size) {
+        return;
+    }
+    const frame = movie_clip.currentFrame;
+    if (!sounds.has(frame)) {
+        return;
+    }
+    $sounds.push(movie_clip);
+};

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

@@ -0,0 +1,11 @@
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description フレームを進める
+ *              Advance the frame
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip) => void;

package/src/MovieClip/usecase/MovieClipAdvanceFrameUseCase.js

@@ -0,0 +1,36 @@
+import { execute as displayObjectApplyChangesService } from "../../DisplayObject/service/DisplayObjectApplyChangesService";
+import { execute as movieClipPrepareActionUseCase } from "./MovieClipPrepareActionUseCase";
+import { execute as movieClipPrepareSoundUseCase } from "./MovieClipPrepareSoundUseCase";
+/**
+ * @description フレームを進める
+ *              Advance the frame
+ *
+ * @param  {MovieClip} movie_clip
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip) => {
+    if (movie_clip.totalFrames === 1 || !movie_clip.isPlaying) {
+        return;
+    }
+    // 待機でなければフレームを進める
+    if (!movie_clip.$wait) {
+        ++movie_clip.currentFrame;
+        if (movie_clip.currentFrame > movie_clip.totalFrames) {
+            movie_clip.currentFrame = 1;
+        }
+    }
+    // フラグをリセット
+    movie_clip.$wait = false;
+    movie_clip.$canSound = true;
+    movie_clip.$canAction = true;
+    movie_clip.$hasTimelineHeadMoved = true;
+    movie_clip.$container = null;
+    // サウンドがあればセット
+    movieClipPrepareSoundUseCase(movie_clip);
+    // アクションがあればセット
+    movieClipPrepareActionUseCase(movie_clip);
+    // 表示オブジェクトの変更を適用
+    displayObjectApplyChangesService(movie_clip);
+};

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

@@ -0,0 +1,17 @@
+import type { IDictionaryTag } from "../../interface/IDictionaryTag";
+import type { ICharacter } from "../../interface/ICharacter";
+import type { DisplayObject } from "../../DisplayObject";
+import { MovieClip } from "../../MovieClip";
+/**
+ * @description cahracterを元にDisplayObjectを構築
+ *              Build DisplayObject based on character
+ *
+ * @param  {number} dictionary_id
+ * @param  {object} tag
+ * @param  {object} character
+ * @param  {MovieClip} parent
+ * @return {DisplayObject}
+ * @method
+ * @protected
+ */
+export declare const execute: <D extends DisplayObject>(dictionary_id: number, tag: IDictionaryTag, character: ICharacter, parent: MovieClip, placeId?: number) => D;

package/src/MovieClip/usecase/MovieClipBuildDictionaryCharacterUseCase.js

@@ -0,0 +1,51 @@
+import { MovieClip } from "../../MovieClip";
+import { Shape } from "../../Shape";
+import { TextField } from "@next2d/text";
+import { Video } from "@next2d/media";
+import { execute as displayObjectBaseBuildService } from "../../DisplayObject/service/DisplayObjectBaseBuildService";
+/**
+ * @description cahracterを元にDisplayObjectを構築
+ *              Build DisplayObject based on character
+ *
+ * @param  {number} dictionary_id
+ * @param  {object} tag
+ * @param  {object} character
+ * @param  {MovieClip} parent
+ * @return {DisplayObject}
+ * @method
+ * @protected
+ */
+export const execute = (dictionary_id, tag, character, parent, placeId = -1) => {
+    switch (character.extends) {
+        case MovieClip.namespace:
+            {
+                const movieClip = new MovieClip();
+                displayObjectBaseBuildService(movieClip, dictionary_id, tag, parent, placeId);
+                movieClip.$sync(character);
+                return movieClip;
+            }
+        case Shape.namespace:
+            {
+                const shape = new Shape();
+                displayObjectBaseBuildService(shape, dictionary_id, tag, parent, placeId);
+                shape.$sync(character);
+                return shape;
+            }
+        case TextField.namespace:
+            {
+                const textField = new TextField();
+                displayObjectBaseBuildService(textField, dictionary_id, tag, parent, placeId);
+                textField.$sync(character);
+                return textField;
+            }
+        case Video.namespace:
+            {
+                const video = new Video();
+                displayObjectBaseBuildService(video, dictionary_id, tag, parent, placeId);
+                video.$sync(character);
+                return video;
+            }
+        default:
+            throw new Error(`Character extends not found: ${character.extends}`);
+    }
+};

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

@@ -0,0 +1,12 @@
+import type { IMovieClipCharacter } from "../../interface/IMovieClipCharacter";
+import type { MovieClip } from "../../MovieClip";
+/**
+ * @description MovieClipのキャラクター情報を元に、MovieClipを構築
+ *              Build MovieClip based on character information of MovieClip
+ * @param  {MovieClip} movie_clip
+ * @param  {object} character
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (movie_clip: MovieClip, character: IMovieClipCharacter) => void;

package/src/MovieClip/usecase/MovieClipBuildFromCharacterUseCase.js

@@ -0,0 +1,33 @@
+import { execute as movieClipAddActionsService } from "../service/MovieClipAddActionsService";
+import { execute as movieClipAddLabelsService } from "../service/MovieClipAddLabelsService";
+import { execute as movieClipBuildSoundsService } from "../service/MovieClipBuildSoundsService";
+/**
+ * @description MovieClipのキャラクター情報を元に、MovieClipを構築
+ *              Build MovieClip based on character information of MovieClip
+ * @param  {MovieClip} movie_clip
+ * @param  {object} character
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (movie_clip, character) => {
+    if (character.actions) {
+        if (!movie_clip.$actions) {
+            movie_clip.$actions = new Map();
+        }
+        movieClipAddActionsService(movie_clip.$actions, character.actions);
+    }
+    if (character.sounds) {
+        if (!movie_clip.$sounds) {
+            movie_clip.$sounds = new Map();
+        }
+        movieClipBuildSoundsService(movie_clip, movie_clip.$sounds, character.sounds);
+    }
+    if (character.labels) {
+        if (!movie_clip.$labels) {
+            movie_clip.$labels = new Map();
+        }
+        movieClipAddLabelsService(movie_clip.$labels, character.labels);
+    }
+    movie_clip.totalFrames = character.totalFrame || 1;
+};

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

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