雨雪と浮上
ユーザーズマニュアル

01 / はじめに

できること

「雨雪と浮上」は、映像へ雨や雪を降らせたり、泡や好きなPNG画像を動かしたりする映像エフェクトです。最上段の「種類」から、使いたい表現を選びます。

種類と見た目ごとに個別の設定があります。丸から水滴へ切り替えて戻ると、大きさ・量・動き・色・Animationなども戻ります。初めて選ぶ見た目には専用の初期値を使います。雪用PNGとカスタムPNGの選択も別々に保持します。

02 / はじめに

導入とエフェクトの追加

ライセンス

本プラグインはMozilla Public License 2.0（MPL-2.0）で提供します。同梱のLICENSE.txtを参照してください。対応ソースの入手先は、同梱のSOURCE_CODE.txtを参照してください。登録するPNGには、それぞれの権利者の条件が適用されます。

動作環境

動作確認済みの環境はYMM4 Lite 4.56.1.0です。他の版は未確認です。ビルド対象は.NET 10、Windowsビルド19041以降であり、すべての対象環境での実機確認を意味しません。

.ymmeから導入する

1. 配布された YMM4Rainfall.ymme を保存します。
2. ファイルをダブルクリックし、起動したインストーラーの案内に従います。
3. YMM4を起動します。

インストーラーが起動しない場合は、YMM4の「ヘルプ」→「YMM4用拡張子の関連付け」→「登録する」を実行してから、もう一度 .ymme ファイルを開いてください。

DLLを手動で配置する

1. YMM4を終了します。
2. YMM4のフォルダー内に user\plugin\YMM4Rainfall を作ります。
3. YMM4Rainfall.dll を入れます。
4. YMM4を起動します。

同じDLLを複数のプラグインフォルダーへ配置しないでください。カスタムPNGの標準ブタは登録せずに使えます。ご自身のPNG素材を使う場合は、別途ライブラリへ登録します。

エフェクトを追加する

1. 映像または画像のアイテムをタイムラインへ置き、選択します。
2. 「映像エフェクト」の追加から、カテゴリ「描画」の「雨雪と浮上」を選びます。
3. 「種類」を選び、プレビューを再生します。

03 / はじめに

まず雨を降らせる

YMM4側でこのエフェクトのデフォルトを変更していない場合、新しく追加すると「雨」の「線」が選ばれます。出現開始と20秒の立ち上がりが有効なので、追加直後は雨が少なく見えます。

1. 雨を見分けやすい暗めの映像または画像を、25秒程度の長さで用意します。
2. 「雨雪と浮上」を追加し、「種類」が「雨」、「見た目」が「線」であることを確認します。
3. 設定を変えずに先頭から20秒程度プレビューし、雨の量が徐々に増える様子を確認します。
4. 好みに合わせて「量」「移動速度」「不透明度」を調整します。

表は横へスクロールできます。

線が下方向へ少し傾いて流れます。細さは「太さ」、筋の長さは「長さ」で調整します。ばらつきや色は、それぞれのグループで調整します。使わないグループは見出し左の矢印で折りたためます。

04 / はじめに

目的別の設定例

「設定例（プリセット）」は、静かな細雪、ぼたん雪、吹雪、渦などの調整値をまとめて適用する機能です。候補は選択中の種類に合わせて表示されます。選択は内容の確認で、「適用」を押すと現在の設定へ反映します。

1. アイテムを1つ選び、使う種類を選びます。
2. 設定例を選び、適用対象と数値を確認します。選ぶだけでは現在の設定は変わりません。
3. 「適用」で反映します。反映後は通常の設定として自由に調整できます。

適用する数値項目は、時間とともに値が変わる設定（Animation）を解除し、一覧の値に固定します。粒は適用後の速度や回転の設定に従って動きます。適用前の一覧で対象を確認してください。色、乱数シード、出現開始、PNG参照、他種類の設定は変更しません。雪のPNGを選択している場合は、その画像の見た目を保持して動きを適用します。

表は横へスクロールできます。

「背景を映す水泡」は水泡Bの設定例です。実際に参照できる映像は、エフェクトへ入力された映像に限られます。

全ての設定例で「大きさ・動き連動」を有効にし、「進行方向追従」「上下維持」「補正時左右反転」を無効にします。モーションブラーは「風に流れる雨」「風に流れる雪」「吹雪」で後方・強さ25%、それ以外で無効です。泡の初期角度と回転速度のばらつきは0%にします。出現開始は保持するため、立ち上がり途中では粒が少なく見える場合があります。

05 / 種類ごとの調整

雨の量と見た目

「種類」を「雨」にすると、線、丸、水滴を選べます。線は長さと太さ、丸と水滴は「大きさ」で寸法を調整します。

表は横へスクロールできます。

「方向」は0°で下です。「風」を有効にすると、基本の移動へ風を加え、線も合成した移動方向へ傾きます。風を強くしても筋の長さは自動では変わりません。

大きい粒ほど基本移動を速くする

ばらつきの「大きさ・動き連動」を有効にします。「大きさばらつき」で粒の寸法差を作り、「速度ばらつき」で小粒と大粒の速度差を調整します。全種類で使用でき、線では太さ、それ以外では粒ごとの相対的な大きさに連動します。PNG倍率や全粒の基準サイズだけでは速度は変わりません。大きさばらつき・速度ばらつきのどちらかが0%なら連動による速度差はなく、基準速度0では基本移動を作りません。

雨で風への反応にも差を付ける場合は、「風」を有効にし、風の「反応ばらつき」を0%より大きくします。小さい粒ほど風による追加速度が大きくなります。新規追加時の反応ばらつきは、線と丸が10%、水滴が100%です。

新規追加時の連動は、雪用PNGのみ無効で、それ以外の見た目は有効です。雨では、大きさばらつき0%なら風への反応差もなくなります。反応ばらつき0%では風への反応差がなくなります。雪の風の反応差はこの連動の対象外です。

まとめて試す場合は、設定例（プリセット）の「風に流れる雨」を適用します。この例では、大きさと動きの連動、横風、粒ごとの反応差を有効にします。

06 / 種類ごとの調整

雪を降らせる

1. 「種類」を「雪」にします。
2. 「見た目」で雪の形を選びます。
3. 「量」「大きさ」「落下速度」「不透明度」を調整します。
4. 必要に応じて「風」「漂い」や「動き」を調整します。

表は横へスクロールできます。

各形状で量や風などの設定を個別に保持し、戻すとその形状の設定が復元されます。柔らかさは0%で縁が明瞭になり、100%で広く薄くなります。この欄は玉雪とぼたん雪に表示します。「静かな細雪」「吹雪」の設定例は玉雪を6 px・柔らかさ0%にします。

結晶を見せたいときは「大きさ」を大きめに調整します。小さくすると細かな枝は見えにくくなります。「混在」でも粒ごとの形は移動中に変わりません。

初期設定では落下速度60 px/秒、漂い有効、回転速度20°/秒です。完全に止めたいときは、落下速度に加え、漂い、風、局所的な動き、回転も止めます。

07 / 種類ごとの調整

風・漂い・局所的な動き

雨と雪に共通の風

「風」を有効にし、「風向」と「風強度」を調整します。風向90°で右、270°で左へ流れます。強さは画面上の追加速度で、落下速度とは別の値です。

「風変動」は風の強弱、「変動速度」は変化する速さです。変動0%または速さ0倍では、基準の強さで吹きます。「反応ばらつき」を大きくすると、粒ごとに風を受ける強さが変わります。

雪の漂い

「漂い」は、粒を横へゆっくり揺らす動きです。幅は基準軌道から片側への最大距離、速さは時間変化の倍率です。速さ0倍では漂いを止めます。

「不規則さ」0%では規則的に往復し、大きくすると複数の滑らかな波を組み合わせた動きになります。出現開始を指定した場合は、出発直後の幅を0から徐々に増やします。

渦と巻き上がり

雪の「動き」で方式を選びます。どちらも落下、風、漂いへ動きを加えます。

表は横へスクロールできます。

「吹き上げ強度」は中央での上向きの追加速度です。落下速度より大きくすると、中央付近の粒が上昇します。粒ごとの速度差や風、漂いも重なるため、全ての粒が同じ高さまで上がるわけではありません。

中心の原点は入力画像の中心です。Xは右が正、Yは下が正です。範囲を出たあとも、それまでに生じた位置の差は残ります。巻き上がりは空中の範囲を使う表現で、地面の検出や積雪は行いません。

08 / 種類ごとの調整

泡を浮かべる

1. 「種類」を「泡」にします。
2. 「見た目」で「水泡A」または「水泡B」を選びます。
3. 「大きさ」「浮上速度」「不透明度」を調整します。
4. 輪郭を薄くしたい場合は「輪郭濃度」を下げます。

方向の初期値は180°で上向きです。水泡Aは透明な中央、色付きの輪郭、白い反射光を描きます。「輪郭濃度」0%では輪郭を消し、反射光と内部の薄い色を残します。全体を薄くする場合は「不透明度」を使います。

水泡Bの映り込み

水泡Bは周囲の入力映像を上下左右反転して0.6倍に縮小し、泡の内側へ合成します。「映り込み」はその強さです。輪郭の濃さとは独立して調整できます。球面の屈折を計算する表現ではありません。

09 / 種類ごとの調整

PNG画像を登録して動かす

カスタムPNGは最初から「ブタ（標準画像）」を表示します。標準画像はDLL内にあり、画像ライブラリの登録上限には含めません。標準画像は置換・削除できませんが、別のPNGを追加して切り替えられます。従来の保存データの画像選択や未指定状態は維持します。

画像を登録する

1. 「種類」を「カスタムPNG」にするか、雪の「見た目」を「PNG」にします。
2. 登録名を入力し、「PNGを追加」で画像を選びます。
3. 登録済みの画像は一覧から選び、「使用」で選択中の種類へ適用します。
4. 「倍率」、移動速度または落下速度を調整します。

登録時にPNGを専用ライブラリへコピーします。原本を移動してもコピーから表示できます。縦横比と透明部分を保ち、100%で元画像の縦横サイズ、200%で縦横2倍になります。「倍率」は1～1000%で調整でき、透明な余白も寸法に含みます。

雪用とカスタム用の選択は別々です。共通ライブラリから同じ画像を選ぶこともできます。

表は横へスクロールできます。

追加・置換・削除などのライブラリ操作はYMM4のUndo対象外です。置換・削除時は画面に表示される影響を確認してください。

対応画像は縦横各2048 px以下、16 MB以下のPNGです。複数フレームの画像は先頭フレームを使います。未選択、欠落、破損、管理情報と内容の不一致では入力映像だけを表示し、「画像解像度」で知らせます。

10 / 詳しい調整と保存

移動方向と速度

雨、泡、カスタムPNGは「方向」で進む向きを選びます。雪の基本方向は下向きで、風や局所的な動きで変化を加えます。

表は横へスクロールできます。

方向と回転角度は数値入力で360°を超える値も指定できます。例えば方向を0°から720°へAnimationで変えると、移動方向が2回転します。

「大きさ・動き連動」が無効のとき、速度のばらつき0%では均一、40%では基準速度の0.6～1.4倍、100%ではほぼ0～2倍になります。大きさのばらつきは速度と独立して決まります。連動を有効にすると、基本速度の差を相対的な粒の大きさに合わせます。雨だけは風への反応も連動します。雪の風・漂い・渦・巻き上がりや泡・PNGの揺らめきの計算は維持するため、合成後の速さが粒の大小順になるとは限りません。方向追従が有効な場合、合成方向の変化は画像の向きにも反映します。

基準速度0でも、風や漂いなどを有効にしていれば粒は動きます。画面外へ出た粒は外側で循環します。途中でばらつきを0へ戻しても、それまでに開いた位置の差は残ります。

11 / 詳しい調整と保存

揺らめきと回転

泡とカスタムPNGの揺らめき

「揺らめき」を有効にすると、進行方向と直角に往復します。揺れ幅は片側の最大距離、揺れ周期は一往復の秒数です。雪では「漂い」を使います。

揺らめきだけでは画像の向きを変えません。速度0でも動くので、止めるには無効にするか幅を0にします。出現開始を指定した場合は、最初の一周期で幅を滑らかに増やします。

移動方向にぼかす

「モーションブラー」のグループで「モーションブラー」を有効にし、「方式」と「強さ」を調整します。「前後」は両側へぼかし、「後方」は先頭の像を残して後ろへ薄い尾を伸ばします。新規追加時の方式は、雪の結晶と雪用PNGが「前後」、それ以外は「後方」です。既存データは保存された方式を保持し、方式が省略されている場合は「前後」で読み込みます。alpha.6ではぼけ幅への換算を4倍に調整しました。25%が従来の100%相当で、保存済み設定にも適用されます。ぼけ幅の上限や画面外余白による制限に達すると、長さは4倍未満になります。速い粒ほど移動方向へ長くぼけます。風、雪の漂い・渦・巻き上がり、泡やPNGの揺らめきにも追従します。「方向追従」を有効にする必要はありません。

新規追加時の有効状態・方式・強さは見た目別です。設定は見た目ごとに保持し、強さにはAnimationを設定できます。無効または強さ0%では通常の描画になります。背景にはかからず、水泡Bは輪郭と映り込みをまとめてぼかします。

対象は粒の中心の移動です。回転だけの動き、アイテム自体の移動、曲線全体の残像はぼかしません。速さを上げてもぼけ幅には上限があります。粒数が多いと再生負荷が増えるため、必要な見た目で有効にしてください。

回転と向き

「回転」のグループで調整します。「回転角度」は基準角度、「回転速度」は1秒あたりの回転です。正で時計回り、負で反時計回りです。線には適用しません。

「初期角度ばらつき」は粒ごとの向き、「回転速度ばらつき」は回転の速さの差を調整します。基準の回転速度0では、回転速度のばらつきを付けても自転しません。

「進行方向追従」は移動方向へ向きを合わせます。雪の漂いによる瞬間的な方向も含みます。「上下維持」は角度が±90°を超える区間で180°補正し、「補正時左右反転」はその区間だけ左右を反転します。切替点では向きが瞬時に反転するため、絵柄と動きに合わせて選んでください。

12 / 詳しい調整と保存

出現開始

「出現開始」のグループで「出現開始指定」を有効にします。「開始時間」で流れ始める時刻、「立ち上がり時間」で粒の発生ペースが設定量へ達するまでの時間を指定します。

表は横へスクロールできます。

粒は画面外から流れ込み、立ち上がり後もそのまま降り続けます。下向きなら上側、上向きなら下側から入ります。立ち上がり時間がある場合は、最初の1粒を開始時刻から画面端のすぐ外で動かし、残りを指定のペースで増やします。見え始めるまでの時間は粒の大きさ、PNGの透明な余白、回転、移動速度によって変わります。雨や雪が開始時から斜めに流れる場合は、先行する1粒を除き、その進行方向に沿って一つの面から広がります。降り続けている間は横側からも流れ込みます。開始時に画面内の粒を突然表示することはありません。風や漂いなどを加えた場合の到達位置と時間は、動きの設定によって変わります。

立ち上がり時間0秒では、最初から通常の発生ペースで流し始めます。画面全体に行き渡るまでの時間は、画面の寸法と移動速度にも左右されます。全ての移動を止めていると画面内には現れません。繰り返しの増減やフェードには「量」と「不透明度」のAnimationを使います。

13 / 詳しい調整と保存

Animationと色

Animationに対応する項目では、YMM4の各項目のAnimation設定を使って先頭、途中、終点の値を調整できます。例えば「量」を増やしながら「風強度」を上げると、途中から天候を強くできます。

種類、見た目、動きの方式、有効／無効の切替は固定設定です。Animationの対象は設定表を参照してください。

色を変える

「開始色」のパレットはRGBの先頭値を編集します。パレットを操作しても途中点や終点は保持します。パレットの表示は再生位置によらず先頭の色です。途中から色を変える場合は「赤強度」「緑強度」「青強度」のAnimationを編集します。

PNGでは元のRGBへ設定色を掛け合わせます。元の色を保つには白、RGB各100%にします。画像を透けずに表示するには、不透明度100%、不透明度のばらつき0%、パレットのアルファ255にします。PNG自体の透明度は残ります。

14 / 詳しい調整と保存

保存とバックアップ

非選択の見た目の設定も保存します。同じ種類でも、ある見た目で変更した風や色は、別の見た目には反映しません。設定例が見た目を切り替える場合は、切替先の設定へ一覧の項目だけを適用します。

プロジェクトには、選択中の種類と4種類分の設定を保存します。表示していない種類のAnimationと、雪用・カスタム用のPNG参照も保存します。

PNG本体はプロジェクトに埋め込みません。ライブラリはYMM4設定フォルダーの YMM4Rainfall/images/ にあり、コピー画像と images.json を保存しています。

1. YMM4を終了します。
2. プロジェクトとライブラリフォルダー全体をバックアップします。
3. 別のPCで使う場合は、プロジェクトに加え、対応する設定フォルダーへライブラリ全体をコピーします。

コピー先にライブラリがある場合は、既存の登録内容を保護して扱ってください。PNGをライブラリ内で直接上書きせず、画面の「置換」で更新します。

15 / 困ったときと資料

困ったとき

表は横へスクロールできます。

16 / 困ったときと資料

動作確認範囲と制限

YMM4 Lite 4.56.1.0で、既存プロジェクトの読み込み、雨・雪・PNGの表示と短時間再生を確認しています。保存と再読み込み、Undo/Redo、短い動画出力は代表的な条件で確認しています。水泡Bによる別アイテムの映り込みも、基本表示、位置とサイズの変更、動く背景でのシーク、短い動画出力を確認しています。

他のYMM4バージョン、実再生FPS、最大粒数付近での性能、長時間連続再生の安定性は確認していません。粒数や画面サイズ、同時に使うエフェクトが増えると処理が重くなる場合があります。

• 画面外を含め、1エフェクトで最大4000粒です。量は画面内の粒数を直接指定する値ではありません。
• 大きな粒や回転のため、画面外に配置の余白を取ります。
• 映り込み用画像の長辺は最大4096 pxです。入力が大きい場合は映り込み用画像を縮小します。
• 積雪、地面との衝突、溶解、雨音SEや音声との自動連動は行いません。

17 / 困ったときと資料

設定範囲と初期値

新しいエフェクトでの初期値です。種類を切り替えても初期値へ戻らず、調整した設定を保持します。条件に合う項目だけを表示します。

見た目別の初期値

YMM4側でこのエフェクトのデフォルトを変更していない場合の、新規追加時の初期値です。雨・泡・カスタムPNGは出現開始と量の増加が有効です。線は20秒、他は10秒をかけて増えるため、追加直後は粒が少なく見えます。カスタムPNGの初期画像はブタ（標準画像）、回転速度は−100°/秒です。雪の初期選択はぼたん雪です。雪用PNGは画像を別途選択してください。

範囲と表示条件

表は横へスクロールできます。

PNGの登録と状態表示は、雪でPNGを選んだ場合とカスタムPNGで表示します。角度のスライダーは−360～360°、数値入力では複数回転を指定できます。

18 / 困ったときと資料

ライセンスとソースコード

対象バージョンは1.0.0です。ライセンスはMPL-2.0です。第三者ライブラリの情報は同梱のTHIRD_PARTY_NOTICES.md、対応ソースの入手先は同梱のSOURCE_CODE.txtを参照してください。

内蔵の雨、雪、泡はコードで描く形状です。利用者が登録するPNGは、用途に応じた利用条件を確認して用意してください。