phaser4-rex-plugins
Version:
943 lines (770 loc) • 26.3 kB
JavaScript
(function (global, factory) {
typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
typeof define === 'function' && define.amd ? define(factory) :
(global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.rexsoundfadeplugin = factory());
})(this, (function () { 'use strict';
var EventEmitterMethods = {
setEventEmitter(eventEmitter, EventEmitterClass) {
if (EventEmitterClass === undefined) {
EventEmitterClass = Phaser.Events.EventEmitter; // Use built-in EventEmitter class by default
}
this._privateEE = (eventEmitter === true) || (eventEmitter === undefined);
this._eventEmitter = (this._privateEE) ? (new EventEmitterClass()) : eventEmitter;
return this;
},
destroyEventEmitter() {
if (this._eventEmitter && this._privateEE) {
this._eventEmitter.shutdown();
}
return this;
},
getEventEmitter() {
return this._eventEmitter;
},
on() {
if (this._eventEmitter) {
this._eventEmitter.on.apply(this._eventEmitter, arguments);
}
return this;
},
once() {
if (this._eventEmitter) {
this._eventEmitter.once.apply(this._eventEmitter, arguments);
}
return this;
},
off() {
if (this._eventEmitter) {
this._eventEmitter.off.apply(this._eventEmitter, arguments);
}
return this;
},
emit(event) {
if (this._eventEmitter && event) {
this._eventEmitter.emit.apply(this._eventEmitter, arguments);
}
return this;
},
addListener() {
if (this._eventEmitter) {
this._eventEmitter.addListener.apply(this._eventEmitter, arguments);
}
return this;
},
removeListener() {
if (this._eventEmitter) {
this._eventEmitter.removeListener.apply(this._eventEmitter, arguments);
}
return this;
},
removeAllListeners() {
if (this._eventEmitter) {
this._eventEmitter.removeAllListeners.apply(this._eventEmitter, arguments);
}
return this;
},
listenerCount() {
if (this._eventEmitter) {
return this._eventEmitter.listenerCount.apply(this._eventEmitter, arguments);
}
return 0;
},
listeners() {
if (this._eventEmitter) {
return this._eventEmitter.listeners.apply(this._eventEmitter, arguments);
}
return [];
},
eventNames() {
if (this._eventEmitter) {
return this._eventEmitter.eventNames.apply(this._eventEmitter, arguments);
}
return [];
},
};
const SceneClass = Phaser.Scene;
var IsSceneObject = function (object) {
return (object instanceof SceneClass);
};
var GetSceneObject = function (object) {
if ((object == null) || (typeof (object) !== 'object')) {
return null;
} else if (IsSceneObject(object)) { // object = scene
return object;
} else if (object.scene && IsSceneObject(object.scene)) { // object = game object
return object.scene;
} else if (object.parent && object.parent.scene && IsSceneObject(object.parent.scene)) { // parent = bob object
return object.parent.scene;
} else {
return null;
}
};
const GameClass = Phaser.Game;
var IsGame = function (object) {
return (object instanceof GameClass);
};
var GetGame = function (object) {
if ((object == null) || (typeof (object) !== 'object')) {
return null;
} else if (IsGame(object)) {
return object;
} else if (IsGame(object.game)) {
return object.game;
} else if (IsSceneObject(object)) { // object = scene object
return object.sys.game;
} else if (IsSceneObject(object.scene)) { // object = game object
return object.scene.sys.game;
}
};
const GetValue$5 = Phaser.Utils.Objects.GetValue;
class ComponentBase {
constructor(parent, config) {
this.setParent(parent); // gameObject, scene, or game
this.isShutdown = false;
// Event emitter, default is private event emitter
this.setEventEmitter(GetValue$5(config, 'eventEmitter', true));
// Register callback of parent destroy event, also see `shutdown` method
if (this.parent) {
if (this.parent === this.scene) { // parent is a scene
this.scene.sys.events.once('shutdown', this.onEnvDestroy, this);
} else if (this.parent === this.game) { // parent is game
this.game.events.once('shutdown', this.onEnvDestroy, this);
} else if (this.parent.once) { // parent is game object or something else
this.parent.once('destroy', this.onParentDestroy, this);
}
// bob object does not have event emitter
}
}
shutdown(fromScene) {
// Already shutdown
if (this.isShutdown) {
return;
}
// parent might not be shutdown yet
if (this.parent) {
if (this.parent === this.scene) { // parent is a scene
this.scene.sys.events.off('shutdown', this.onEnvDestroy, this);
} else if (this.parent === this.game) { // parent is game
this.game.events.off('shutdown', this.onEnvDestroy, this);
} else if (this.parent.once) { // parent is game object or something else
this.parent.off('destroy', this.onParentDestroy, this);
}
// bob object does not have event emitter
}
this.destroyEventEmitter();
this.parent = undefined;
this.scene = undefined;
this.game = undefined;
this.isShutdown = true;
}
destroy(fromScene) {
this.shutdown(fromScene);
}
onEnvDestroy() {
this.destroy(true);
}
onParentDestroy(parent, fromScene) {
this.destroy(fromScene);
}
setParent(parent) {
this.parent = parent; // gameObject, scene, or game
this.scene = GetSceneObject(parent);
this.game = GetGame(parent);
return this;
}
}
Object.assign(
ComponentBase.prototype,
EventEmitterMethods
);
const GetValue$4 = Phaser.Utils.Objects.GetValue;
class TickTask extends ComponentBase {
constructor(parent, config) {
super(parent, config);
this._isRunning = false;
this.isPaused = false;
this.tickingState = false;
this.setTickingMode(GetValue$4(config, 'tickingMode', 1));
// boot() later
}
// override
boot() {
if ((this.tickingMode === 2) && (!this.tickingState)) {
this.startTicking();
}
}
// override
shutdown(fromScene) {
// Already shutdown
if (this.isShutdown) {
return;
}
this.stop();
if (this.tickingState) {
this.stopTicking();
}
super.shutdown(fromScene);
}
setTickingMode(mode) {
if (typeof (mode) === 'string') {
mode = TICKINGMODE[mode];
}
this.tickingMode = mode;
}
// override
startTicking() {
this.tickingState = true;
}
// override
stopTicking() {
this.tickingState = false;
}
get isRunning() {
return this._isRunning;
}
set isRunning(value) {
if (this._isRunning === value) {
return;
}
this._isRunning = value;
if ((this.tickingMode === 1) && (value != this.tickingState)) {
if (value) {
this.startTicking();
} else {
this.stopTicking();
}
}
}
start() {
this.isPaused = false;
this.isRunning = true;
return this;
}
pause() {
// Only can ba paused in running state
if (this.isRunning) {
this.isPaused = true;
this.isRunning = false;
}
return this;
}
resume() {
// Only can ba resumed in paused state (paused from running state)
if (this.isPaused) {
this.isPaused = false;
this.isRunning = true;
}
return this;
}
stop() {
this.isPaused = false;
this.isRunning = false;
return this;
}
complete() {
this.isPaused = false;
this.isRunning = false;
this.emit('complete', this.parent, this);
}
}
const TICKINGMODE = {
'no': 0,
'lazy': 1,
'always': 2
};
const GetValue$3 = Phaser.Utils.Objects.GetValue;
class SceneUpdateTickTask extends TickTask {
constructor(parent, config) {
super(parent, config);
// scene update : update, preupdate, postupdate, prerender, render
// game update : step, poststep,
// If this.scene is not available, use game's 'step' event
var defaultEventName = (this.scene) ? 'update' : 'step';
this.tickEventName = GetValue$3(config, 'tickEventName', defaultEventName);
this.isSceneTicker = !IsGameUpdateEvent(this.tickEventName);
}
startTicking() {
super.startTicking();
if (this.isSceneTicker) {
this.scene.sys.events.on(this.tickEventName, this.update, this);
} else {
this.game.events.on(this.tickEventName, this.update, this);
}
}
stopTicking() {
super.stopTicking();
if (this.isSceneTicker && this.scene) { // Scene might be destoryed
this.scene.sys.events.off(this.tickEventName, this.update, this);
} else if (this.game) {
this.game.events.off(this.tickEventName, this.update, this);
}
}
// update(time, delta) {
//
// }
}
var IsGameUpdateEvent = function (eventName) {
return (eventName === 'step') || (eventName === 'poststep');
};
const GetValue$2 = Phaser.Utils.Objects.GetValue;
const Clamp = Phaser.Math.Clamp;
class Timer {
constructor(config) {
this.resetFromJSON(config);
}
resetFromJSON(o) {
this.state = GetValue$2(o, 'state', IDLE);
this.timeScale = GetValue$2(o, 'timeScale', 1);
this.delay = GetValue$2(o, 'delay', 0);
this.repeat = GetValue$2(o, 'repeat', 0);
this.repeatCounter = GetValue$2(o, 'repeatCounter', 0);
this.repeatDelay = GetValue$2(o, 'repeatDelay', 0);
this.duration = GetValue$2(o, 'duration', 0);
this.nowTime = GetValue$2(o, 'nowTime', 0);
this.justRestart = GetValue$2(o, 'justRestart', false);
}
toJSON() {
return {
state: this.state,
timeScale: this.timeScale,
delay: this.delay,
repeat: this.repeat,
repeatCounter: this.repeatCounter,
repeatDelay: this.repeatDelay,
duration: this.duration,
nowTime: this.nowTime,
justRestart: this.justRestart,
}
}
destroy() {
}
setTimeScale(timeScale) {
this.timeScale = timeScale;
return this;
}
setDelay(delay) {
if (delay === undefined) {
delay = 0;
}
this.delay = delay;
return this;
}
setDuration(duration) {
this.duration = duration;
return this;
}
setRepeat(repeat) {
this.repeat = repeat;
return this;
}
setRepeatInfinity() {
this.repeat = -1;
return this;
}
setRepeatDelay(repeatDelay) {
this.repeatDelay = repeatDelay;
return this;
}
start() {
this.nowTime = (this.delay > 0) ? -this.delay : 0;
this.state = (this.nowTime >= 0) ? COUNTDOWN : DELAY;
this.repeatCounter = 0;
return this;
}
stop() {
this.state = IDLE;
return this;
}
update(time, delta) {
if (this.state === IDLE || this.state === DONE ||
delta === 0 || this.timeScale === 0
) {
return;
}
this.nowTime += (delta * this.timeScale);
this.justRestart = false;
if (this.nowTime >= this.duration) {
if ((this.repeat === -1) || (this.repeatCounter < this.repeat)) {
this.repeatCounter++;
this.justRestart = true;
this.nowTime -= this.duration;
if (this.repeatDelay > 0) {
this.nowTime -= this.repeatDelay;
this.state = REPEATDELAY;
}
} else {
this.nowTime = this.duration;
this.state = DONE;
}
} else if (this.nowTime >= 0) {
this.state = COUNTDOWN;
}
}
get t() {
var t;
switch (this.state) {
case IDLE:
case DELAY:
case REPEATDELAY:
t = 0;
break;
case COUNTDOWN:
t = this.nowTime / this.duration;
break;
case DONE:
t = 1;
break;
}
return Clamp(t, 0, 1);
}
set t(value) {
value = Clamp(value, -1, 1);
if (value < 0) {
this.state = DELAY;
this.nowTime = -this.delay * value;
} else {
this.state = COUNTDOWN;
this.nowTime = this.duration * value;
if ((value === 1) && (this.repeat !== 0)) {
this.repeatCounter++;
}
}
}
setT(t) {
this.t = t;
return this;
}
get isIdle() {
return this.state === IDLE;
}
get isDelay() {
return this.state === DELAY;
}
get isCountDown() {
return this.state === COUNTDOWN;
}
get isRunning() {
return this.state === DELAY || this.state === COUNTDOWN;
}
get isDone() {
return this.state === DONE;
}
get isOddIteration() {
return (this.repeatCounter & 1) === 1;
}
get isEvenIteration() {
return (this.repeatCounter & 1) === 0;
}
}
const IDLE = 0;
const DELAY = 1;
const COUNTDOWN = 2;
const REPEATDELAY = 3;
const DONE = -1;
class TimerTickTask extends SceneUpdateTickTask {
constructor(parent, config) {
super(parent, config);
this.timer = new Timer();
// boot() later
}
// override
shutdown(fromScene) {
// Already shutdown
if (this.isShutdown) {
return;
}
super.shutdown(fromScene);
this.timer.destroy();
this.timer = undefined;
}
start() {
this.timer.start();
super.start();
return this;
}
stop() {
this.timer.stop();
super.stop();
return this;
}
complete() {
this.timer.stop();
super.complete();
return this;
}
}
const GetValue$1 = Phaser.Utils.Objects.GetValue;
const GetAdvancedValue$1 = Phaser.Utils.Objects.GetAdvancedValue;
const GetEaseFunction = Phaser.Tweens.Builders.GetEaseFunction;
class EaseValueTaskBase extends TimerTickTask {
resetFromJSON(o) {
this.timer.resetFromJSON(GetValue$1(o, 'timer'));
this.setEnable(GetValue$1(o, 'enable', true));
this.setTarget(GetValue$1(o, 'target', this.parent));
this.setDelay(GetAdvancedValue$1(o, 'delay', 0));
this.setDuration(GetAdvancedValue$1(o, 'duration', 1000));
this.setEase(GetValue$1(o, 'ease', 'Linear'));
this.setRepeat(GetValue$1(o, 'repeat', 0));
return this;
}
setEnable(e) {
if (e == undefined) {
e = true;
}
this.enable = e;
return this;
}
setTarget(target) {
if (target === undefined) {
target = this.parent;
}
this.target = target;
return this;
}
setDelay(time) {
this.delay = time;
// Assign `this.timer.setRepeat(repeat)` manually
return this;
}
setDuration(time) {
this.duration = time;
return this;
}
setRepeat(repeat) {
this.repeat = repeat;
// Assign `this.timer.setRepeat(repeat)` manually
return this;
}
setRepeatDelay(repeatDelay) {
this.repeatDelay = repeatDelay;
// Assign `this.timer.setRepeatDelay(repeatDelay)` manually
return this;
}
setEase(ease) {
if (ease === undefined) {
ease = 'Linear';
}
this.ease = ease;
this.easeFn = GetEaseFunction(ease);
return this;
}
// Override
start() {
// Ignore start if timer is running, i.e. in DELAY, o RUN state
if (this.timer.isRunning) {
return this;
}
super.start();
return this;
}
restart() {
this.timer.stop();
this.start.apply(this, arguments);
return this;
}
stop(toEnd) {
if (toEnd === undefined) {
toEnd = false;
}
super.stop();
if (toEnd) {
this.timer.setT(1);
this.updateTarget(this.target, this.timer);
this.complete();
}
return this;
}
update(time, delta) {
if (
(!this.isRunning) ||
(!this.enable) ||
(this.parent.hasOwnProperty('active') && !this.parent.active)
) {
return this;
}
var target = this.target,
timer = this.timer;
timer.update(time, delta);
// isDelay, isCountDown, isDone
if (!timer.isDelay) {
this.updateTarget(target, timer);
}
this.emit('update', target, this);
if (timer.isDone) {
this.complete();
}
return this;
}
// Override
updateTarget(target, timer) {
}
}
const SoundObjectClass = Phaser.Sound.BaseSound;
var IsSoundObject = function (object) {
return (object instanceof SoundObjectClass);
};
const GetValue = Phaser.Utils.Objects.GetValue;
const GetAdvancedValue = Phaser.Utils.Objects.GetAdvancedValue;
const Linear = Phaser.Math.Linear;
class Fade extends EaseValueTaskBase {
constructor(scene, sound, config) {
if (IsSoundObject(scene)) {
config = sound;
sound = scene;
scene = undefined;
}
sound.active = true;
sound.scene = scene;
sound.game = sound.manager.game;
super(sound, config);
// this.parent = parent
// this.timer
this.volume = {};
this.resetFromJSON(config);
}
resetFromJSON(o) {
super.resetFromJSON(o);
this.setMode(GetValue(o, 'mode', 0));
this.setEnable(GetValue(o, 'enable', true));
this.setVolumeRange(
GetAdvancedValue(o, 'volume.start', this.parent.volume),
GetAdvancedValue(o, 'volume.end', 0)
);
return this;
}
setMode(m) {
if (typeof (m) === 'string') {
m = MODE[m];
}
this.mode = m;
return this;
}
setVolumeRange(start, end) {
this.volume.start = start;
this.volume.end = end;
return this;
}
start() {
if (this.timer.isRunning) {
return this;
}
this.parent.setVolume(this.volume.start);
this.timer
.setDelay(this.delay)
.setDuration(this.duration);
super.start();
return this;
}
updateTarget(parent, timer) {
parent.volume = Linear(this.volume.start, this.volume.end, timer.t);
}
complete() {
super.complete();
switch (this.mode) {
case 1:
this.parent.stop();
break;
case 2:
this.parent.stop();
this.parent.destroy();
break;
}
return this;
}
}
const MODE = {
stop: 1,
destroy: 2
};
var FadeIn = function (scene, sound, duration, endVolume, startVolume) {
if (IsSoundObject(scene)) {
startVolume = endVolume;
endVolume = duration;
duration = sound;
sound = scene;
scene = undefined;
}
if (endVolume === undefined) {
endVolume = 1;
}
if (startVolume === undefined) {
startVolume = 0;
}
var config = {
mode: 0,
volume: {
start: startVolume,
end: endVolume
},
duration: duration
};
// create sound instance by key
if (typeof (sound) === 'string') {
sound = scene.sys.sound.add(sound);
}
var fade;
if (sound.hasOwnProperty('_fade')) {
fade = sound._fade;
fade.stop().resetFromJSON(config);
} else {
fade = new Fade(scene, sound, config);
sound._fade = fade;
}
fade.start();
if (!sound.isPlaying) {
sound.setVolume(startVolume).play();
}
return sound;
};
var FadeOut = function (scene, sound, duration, destroy) {
if (IsSoundObject(scene)) {
destroy = duration;
duration = sound;
sound = scene;
scene = undefined;
}
if (destroy === undefined) {
destroy = true;
}
var config = {
mode: ((destroy) ? 2 : 1), // 1: stop, 2: destroy
volume: {
start: sound.volume,
end: 0
},
duration: duration
};
var fade;
if (sound.hasOwnProperty('_fade')) {
fade = sound._fade;
fade.stop().resetFromJSON(config);
} else {
fade = new Fade(scene, sound, config);
sound._fade = fade;
}
fade.start();
if (!sound.isPlaying) {
sound.play();
}
return sound;
};
var SoundFade = {
fadeIn: FadeIn,
fadeOut: FadeOut
};
class SoundFadePlugin extends Phaser.Plugins.BasePlugin {
constructor(pluginManager) {
super(pluginManager);
}
start() {
var eventEmitter = this.game.events;
eventEmitter.on('destroy', this.destroy, this);
}
}
// mixin
Object.assign(
SoundFadePlugin.prototype,
SoundFade
);
return SoundFadePlugin;
}));