鳶嶋式フキダシ拡張 - TF_BalloonEx.js

▼鳶嶋式フキダシ拡張(とんび@鳶嶋工房様作) - TF_BalloonEx.js
https://plugin.fungamemake.com/archives/23210
フキダシの配置やアニメーション制御を拡張します
ふりがな:とびしましきふきだしかくちょう
機能概要: フキダシの配置やアニメーション制御を拡張します
利用規約(ライセンス): MITライセンス
作者:とんび@鳶嶋工房
作者サイト:http://tonbi.jp
解説ページ:https://forum.tkool.jp/index.php?threads/3795/
ダウンロードページ:https://raw.githubusercontent.com/tonbijp/RPGMakerMV/ma…
ファイル名:TF_BalloonEx.js
備考:関連プラグイン
BalloonPlaySe.js https://plugin.fungamemake.com/archives/1076
EventEffects.js https://plugin.fungamemake.com/archives/2620
プラグインのヘルプ:
/*:ja * @plugindesc [フキダシアイコンの表示]の拡張 * @author とんび@鳶嶋工房 * * @param preset * @desc フキダシのアニメーション設定 * @type struct[] * @default ["{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}","{\"dx\":\"0\",\"dy\":\"0\",\"startPatterns\":\"2\",\"loopPatterns\":\"6\",\"endPatterns\":\"0\",\"loops\":\"1\",\"speed\":\"8\",\"waitTime\":\"12\"}"] * * @param baseDy * @desc フキダシの基本y座標差分 * @type Number * @default 0 * * * @help * ●基本的な使い方 * プラグインのパラメータの preset に[フキダシID]毎に設定を書いておきます。 * ・配置(dx,dy)、ループ回数(loops)、速度(speed)、終了時間(waitTime)などが設定できます。 * ・パターン数(startPatterns, loopPatterns,endPatterns)は合計で8以内に設定します。 * ・presetに設定する値について詳細は、それぞれの値入力時のヘルプ文を参照ください。 * 通常の[フキダシアイコンの表示]イベントコマンドを実行すると[フキダシID]に応じた設定でアニメが再生されます。 * トリアコンタンさんの BalloonPlaySe.js と組み合わせると、音も自動的に鳴るようにできて便利です。 * * * ●プラグインコマンド *------------------------------ * TF_START_BALLOON [イベントID] [フキダシID] [完了までウェイト] [dx] [dy] * フキダシの(ループ)アニメーションを開始。引数はすべて省略可能。 * [イベントID] 0:このイベント、-1:プレイヤー、-2〜-4:隊列メンバー、1〜:イベントID(規定値:0) * [フキダシID] img/system/balloon.png の上から1〜15(規定値:11) * [完了までウェイト] 真偽値(true:フキダシのアニメーション終了まで待つ false:待たない)(規定値:false) * [dx] 表示位置のx差分(規定値:プラグインパラメータでdxに設定した値) * [dy] 表示位置のy差分(規定値:プラグインパラメータでdyに設定した値) * * 例: TF_START_BALLOON -1 5 false 0 20 *------------------------------ * TF_SET_BALLOON [イベントID] [フキダシID] [パターン番号] [表示フレーム数] [完了までウェイト] [dx] [dy] * [パターン番号] フキダシ画像の左から 1〜8 のパターン(規定値:8) * [表示フレーム数] 表示するフレーム数(0:TF_STOP_BALLOONを実行するまでループ)(規定値:64フレーム) * * 例: TF_SET_BALLOON 0 9 2 60 true 10 -50 *------------------------------ * TF_LOCATE_BALLOON [イベントID] [dx] [dy] * フキダシ表示位置を変更。フキダシ表示中のみ可能。 * * 例: TF_LOCATE_BALLOON 15 0 10 *------------------------------ * TF_STOP_BALLOON [イベントID] [消滅アニメを表示] * フキダシのアニメーションを停止。 * TF_START_BALLOON で[ループ回数] 0 を指定した場合など、これを使って止める。 * [消滅アニメを表示] 真偽値(true:消滅アニメを表示 false:即終了)(規定値:false) * * 例: TF_STOP_BALLOON 0 true *------------------------------ * [イベントID][フキダシID][dx][dy]の数値は全てV[n]の形式で、変数を指定できます。 * * 例 : TF_LOCATE_BALLOON 0 V[1] V[2] *------------------------------ * * * ● [移動ルートの設定]で使えるスクリプト * * this.TF_startBalloon( [フキダシID], [完了までウエイト], [dx], [dy] ); * TF_START_BALLOONの機能 * [完了までウエイト], [dx], [dy] は省略できます。規定値は TF_START_BALLOON に準拠します。 * this.TF_startBalloon の代わりに this.balloon も使えます。 * ただし EventEffects.js と併用の際は EventEffects.js を、このプラグインの上に配置してください。 *------------------------------ * this.TF_setBalloon( [フキダシID], [パターン番号], [表示フレーム数], [完了までウェイト], [dx], [dy] ); * TF_SET_BALLOONの機能 *------------------------------ * this.TF_locateBalloon( [dx], [dy] ); * TF_LOCATE_BALLOONの機能 *------------------------------ * this.TF_stopBalloon( [消滅アニメを表示] ); * TF_STOP_BALLOON の機能 *------------------------------ * * * 利用規約 : MITライセンス */ /*~struct~BalloonParamJa: * * @param dx * @desc フキダシ表示座標のx差分。正の値で右に負の値で左にずれる。 * @type Number * @default 0 * @min -1000000 * * @param dy * @desc フキダシ表示座標のy差分。正の値で下に負の値で上にずれる。 * @type Number * @default 0 * @min 0 * @min -1000000 * * @param startPatterns * @desc 出現に使用するパターン数。 * @type Number * @default 2 * @min 0 * @max 7 * * @param loopPatterns * @desc ループに使用するパターン数。 * @type Number * @default 6 * @min 0 * @max 8 * * @param endPatterns * @desc 消滅に使用するパターン数。 * @type Number * @default 0 * @min 0 * @max 7 * * @param loops * @desc ループ回数(0:TF_STOP_BALLOONを実行するまでループ) * @type Number * @default 1 * @min 0 * * @param speed * @desc パターンの表示時間(フレーム) * @type Number * @default 8 * @min 0 * * @param waitTime * @desc 最終パターンの表示時間(フレーム) * @type Number * @default 12 * @min 0 */