ピクチャモーション - PictureMotion.js

シェア用テキスト：

▼ピクチャモーション（フェルミウム湾様作） - PictureMotion.js
https://plugin.fungamemake.com/archives/23523
任意のパターンでピクチャの移動を行います。

ふりがな：ぴくちゃもーしょん

機能概要： 任意のパターンでピクチャの移動を行います。

利用規約（ライセンス）：
パブリックドメイン
・著作権：放棄

作者：フェルミウム湾

作者サイト：https://fermiumbay13.hatenablog.com/

直接ダウンロード：Zipファイル

ダウンロードページ：https://fermiumbay13.hatenablog.com/entry/2017/12/03/11…

ファイル名：PictureMotion.js

プラグインのヘルプ：

/*:
 * @plugindesc ピクチャモーションプラグイン
 * 任意のパターンでピクチャの移動を行います。
 * @author フェルミウム湾
 * 
 * @help ピクチャの移動を好きなパターンで行うプラグインです。
 * 通常のピクチャの移動は線形に移動しますが、
 * 本プラグイン導入によって様々なパターンで移動出来るようになります。
 * サンプルとしていくつかのパターンが予め搭載されていますが、
 * スクリプトを利用することによって、新規のパターンを自由に作成出来ます。
 * 
 * ピクチャの移動を行う前に、パターンをプラグインコマンドで指定します。
 * 例えば、x座標, y座標ともにスムーズに動かす場合は、
 * 次のようにイベントコマンドを設定します。
 * 
 * ◆プラグインコマンド：モーション_位置x smooth
 * ◆プラグインコマンド：モーション_位置y smooth
 * ピクチャの移動：～～～
 *
 * モーションパターンをプラグインで指定すると、その後のすべての
 * ピクチャの移動コマンドにおいて、指定した移動パターンが採用されます。
 * 初期化する（すべて線形に戻す）際には次のコマンドを指定します。
 * 
 * ◆プラグインコマンド：モーション_初期化
 * 
 * モーションパターンを指定可能なパラメータは、次の5つです。
 * 位置x, 位置y, 拡大率x, 拡大率y, 不透明度
 * 
 * 
 * ======================================================================
 * コマンド『モーション_初期化』
 * コマンド『Motion_Initialize』
 * --------------------------------------------------------
 * モーションを初期化し、すべて線形移動に戻します。
 * ======================================================================
 * コマンド『モーション_位置x』
 * コマンド『Motion_patternX』
 * --------------------------------------------------------
 * 座標xのモーションパターンを変更します。
 * --------------------------------------------------------
 * 引数1）変更するモーションパターンの名前
 * 引数2以降）モーションパターンで使用するパラメータの指定
 * ======================================================================
 * コマンド『モーション_位置y』
 * コマンド『Motion_patternY』
 * --------------------------------------------------------
 * 座標yのモーションパターンを変更します。
 * --------------------------------------------------------
 * 引数1）変更するモーションパターンの名前
 * 引数2以降）モーションパターンで使用するパラメータの指定
 * ======================================================================
 * コマンド『モーション_拡大率x』
 * コマンド『Motion_patternScaleX』
 * --------------------------------------------------------
 * 拡大率xのモーションパターンを変更します。
 * --------------------------------------------------------
 * 引数1）変更するモーションパターンの名前
 * 引数2以降）モーションパターンで使用するパラメータの指定
 * ======================================================================
 * コマンド『モーション_拡大率y』
 * コマンド『Motion_patternScaleY』
 * --------------------------------------------------------
 * 拡大率yのモーションパターンを変更します。
 * --------------------------------------------------------
 * 引数1）変更するモーションパターンの名前
 * 引数2以降）モーションパターンで使用するパラメータの指定
 * ======================================================================
 * コマンド『モーション_不透明度』
 * コマンド『Motion_patternOpacity』
 * --------------------------------------------------------
 * 不透明度のモーションパターンを変更します。
 * --------------------------------------------------------
 * 引数1）変更するモーションパターンの名前
 * 引数2以降）モーションパターンで使用するパラメータの指定
 * ======================================================================
 * 
 * -----------------------------------
 * ★ サンプルパターン ★
 * -----------------------------------
 * 「linear」線形
 * 
 * 通常の移動です。
 * -----------------------------------
 * 「smooth」スムーズな移動
 * 
 * sin関数を使ったスムーズな移動です。
 * 引数不要で、線形よりは滑らかな移動が行えます。
 * -----------------------------------
 * 「jump p1」放物線
 * 
 * 放物線移動をします。ジャンプを実現出来ます。
 * 引数p1にはジャンプ頂点の高さを相対的に指定します。
 * 例）
 * y座標 300 から y座標 300 へのジャンプ移動で、
 * 途中y座標 100 になるまでジャンプする場合、
 * jump -200 を指定します。
 * -----------------------------------
 * 「triangle p1」三角波
 * 
 * 三角波移動をします。ジャンプ移動が線形になったものです。
 * 引数p1にはジャンプ頂点の高さを相対的に指定します。
 * 例）
 * y座標 300 から y座標 300 へのジャンプ移動で、
 * 途中y座標 100 になるまでジャンプする場合、
 * triangle -200 を指定します。
 * -----------------------------------
 * 「bezier p1 p2」ベジエ曲線
 * 
 * ベジエ曲線移動をします。
 * ベジエ曲線には4つの制御点が必要ですが、それぞれ順番に
 * 移動前座標, 引数p1, 引数p2, 移動後座標 の値となります。
 * jumpやtriangleと異なり、相対的な値ではなく
 * 絶対座標を指定することに注意してください。
 * 例）
 * y座標 600 から y座標 600 へのベジエ曲線移動で、
 * 制御点座標値を 600, 0, 550, 660 にするには
 * bezier 0 550 を指定します。
 * -----------------------------------
 * 「wave p1 p2」振動
 * 
 * 振動します。引数p1は振幅a, 引数p2は周波数fとなり、
 * y = asin(2πft) （0≦t≦1）の振動を行います。
 * 周波数は整数値またはその半分の値を指定すると、
 * 端から端までの連続な振動になります。
 * 例）
 * 振幅200, 周波数1.5にするには
 * wave 200 1.5 を指定します。
 * -----------------------------------
 * 「damped p1 p2 p3 p4 p5」減衰振動
 * 
 * 減衰振動します。引数p1～p4をそれぞれ定数a, b, c, dとして
 * y = ae^(-bt)sin(ct + d) の振動を行います。
 * ピクチャ移動が完了する頃に減衰が止まるものと判断するために
 * 振動が引数p5以下まで減衰したら終了というように指定します。
 * 上式のtは減衰までの時間によって伸縮します。
 * aは振幅、bは減衰スピード、cは振動スピード、dは位相に相当します。
 * 例）
 * damped 200 -0.3 4 0 50 を指定すると、3周期で振動します。
 * -----------------------------------
 * 「spline p1 p2 p3 ...」スプライン補間
 * 
 * 与えられた座標を滑らかに補間しながら始点から終点まで移動します。
 * 要は滑らかに好きなようにピクチャを移動出来るということです。
 * このコマンドにおいては、ピクチャの移動前と移動後の値を使用しません。
 * 引数p1, p2, p3, ……に順に通過点を入れてください。
 * 例）
 * x座標を0～815の線形にし、y座標はスプライン補間で
 * spline 623 100 500 300 500 0 623 として指定すれば、
 * 移動前(0, 623)から順に
 * (815／6, 100), 
 * (815／6×2, 500), 
 * (815／6×3, 300), 
 * (815／6×4, 500), 
 * (815／6×5, 0), 
 * (815, 623) の点をそれぞれ通ります。
 * -----------------------------------
 * 
 * 
 * ======================================================================
 * 
 * すべてのモーションパターンはcurveFunctionsオブジェクトに格納されます。
 * モーションパターンを自作するには、curveFunctionsの持つ
 * 連想配列funcに、モーション名を添えて関数を代入してください。
 * 例えば、線形移動とまったく逆方向に動くパターンは
 * 下記のようにスクリプトとして作成します。
 * 
 * curveFunctions.func[”reverse”] = function(){
 *     return function(y1, y2, t) {
 *         return this.linear(y2, y1, t);
 *     };
 * };
 * 
 * モーションのパラメータを指定する場合は、最も外側のfunctionに
 * 引数として与えてください。移動関数はその戻り値として与えます。
 * 移動関数の引数は(y1, y2, t)で決まっており、それぞれ
 * 移動前の値、移動後の値、移動時間の割合（0≦t≦1）となっています。
 * 線形移動の関数としてlinear(y1, y2, t)だけは予め登録されているので、
 * 自作の際にはよく使われることから、活用してください。
 * 上記のように登録を終えると、プラグインコマンドから実行可能です。
 * 
 * ======================================================================
 * 
 * 【利用規約】
 *  どうでもいいです。著作権を放棄するので勝手にぐちゃぐちゃにしてください。
 *  改変も再配布も、アダルト利用も構いません。連絡も不要です。
 * 
 * -------------------
 * 2017/2/27追記：説明書の誤字を訂正しました。
 */