UnlitWF 2.5.0 を追加

docs/unlitwf/CHANGELOG.md

@@ -3,6 +3,25 @@ toc_min_heading_level: 2
 toc_max_heading_level: 2
 ---
 
+## 2024/11/23 (2.5.0)
+https://github.com/whiteflare/Unlit_WF_ShaderSuite/releases/tag/UnlitWF_Shader_20241123
+
+### Added
+- Shader
+  - 逆光ライト機能を追加しました。従来のリムライト機能よりさらに明るい光を加算合成します。
+- GUI
+  - VRCSDK3 Avatars 向け、マテリアルの明るさ等を調整するメニューを追加する機能を追加しました。
+    - NDMFおよびModularAvatarと連携してExpressionメニューを追加します。それらが存在しないプロジェクトではメニュー追加機能のみ無効となります。
+    - UnlitWF のVPMパッケージ版に機能が含まれています。unitypackage版にはこの機能は含まれていません。
+
+### Changed
+- Shader
+  - エミッションでメインカラーを混合するToggleを追加しました。
+- Tool
+  - 「UnlitWFのマテリアルに変換する」にてエミッションの変換処理を改良しました。メインテクスチャが設定されているのにエミッションテクスチャが未設定のときにはエミッションをオフにするように変更しました。
+
+----
+
 ## 2024/10/14 (2.4.0)
 https://github.com/whiteflare/Unlit_WF_ShaderSuite/releases/tag/UnlitWF_Shader_20241014
 

docs/unlitwf/Manual-UnToon.md

@@ -189,6 +189,17 @@ ToonShade の詳細を ToonShade Advance から設定できます。
 
 ![Image](./img/untoon-man-35.png)
 
+### BackLight 逆光ライト {#BackLight}
+
+逆光ライトの設定です。逆光ライトはリムライトに近いですが、逆光条件にてより強い光量を加算することに特化した機能です。
+
+![Image](./img/untoon-man-38.png)
+
+- `強度` で強さをカスタマイズできます。0.0 は加算なし、1.0 で最大強度です。
+- `可視範囲` は逆光ライトをオンにする範囲を設定します。1.0 はモデル真横からでも逆光ライトが見えます。小さくするにつれて範囲が狭くなり、0.0 では完全な逆光でないと見えません。
+- 逆光ライトの描画範囲は `幅` で調整できます。幅に設定した範囲で逆光ライトを描画し、さらに追加で `ぼかし幅` に設定した範囲に逆光ライトを弱めに追加します。
+- `カメラ補正` では、光源方向と視点位置によって逆光ライトの掛かり方を調整します。1.0 では逆光ライトが広めに描画されます。-1.0 は逆光ライトが細めに描画されます。
+
 ### Overlay Texture オーバーレイテクスチャ {#OverlayTexture}
 
 質感を微調整するテクスチャを設定することができます。Detail Albedo やデカールテクスチャなどの詳細マップはここで設定してください。

docs/unlitwf/WF-AvatarMenu.md

@@ -0,0 +1,39 @@
+# UnlitWF アバターメニュー
+
+VRCSDK3 アバター向けに、マテリアルを微調整するExpressionメニューを追加できます。
+
+![Image](./img/avatarmenu-01.png)
+
+
+## アバターメニューの使い方
+
+- `ライトなし明度`
+	- ライト[^1]からの光がゼロのときの明るさを調整します。50% のときは標準値、値を大きくすると明るく、値を小さくすると暗くなります。
+- `ライト方向`
+	- ライト無しシーンでのライト方向を調整します。0% がワールド座標系 -Z 方向、50% がワールド座標系 +Z 方向で、ラジアルパペットで方向を調整できます。
+- `ライト無視`
+	- オンにすると、シーンにライトが合っても `ライト方向` をマテリアルに適用します。
+- `逆光ライト`
+	- アバターに逆光ライトを使用したマテリアルが含まれているときに項目が現れます。逆光ライトの強度を調整できます。
+
+数値はクライアント間で共有されます(Synced)。保存はされません(not Saved)。
+
+[^1]: リアルタイムライトとライトプローブを含む
+
+## アバターへの導入方法
+
+Hierarchy にてアバターを右クリックして `UnlitWF Shader` → `WFアバターメニュー追加` を選択して、コンポーネントをアバターに追加します。
+
+![Image](./img/avatarmenu-02.png)
+
+- コンポーネントはアバター内のどこに配置されていても動作します。
+- コンポーネントが複数設置されていてもひとつだけ設置されていたときと同じ動作となります。
+- アバター内に UnlitWF のマテリアルが見つからなかった場合、メニューは追加されません。
+
+
+## 依存パッケージについて
+
+アバターメニュー追加の処理は `Modular Avatar` を利用しています。
+https://modular-avatar.nadena.dev/ja
+
+ModularAvatar を未導入の環境では、アバターメニュー追加の処理は無視されます。また「WFアバターメニュー追加」のメニューも表示されません。

sidebars.js

@@ -73,6 +73,11 @@ const sidebars = {
           id: 'unlitwf/Material-Tools-Manual',
           label: 'マテリアル編集ツール',
         },
+        {
+          type: 'doc',
+          id: 'unlitwf/WF-AvatarMenu',
+          label: 'アバター向けメニュー',
+        },
         {
           type: 'doc',
           id: 'unlitwf/Redistribution',

static/vpm.json

@@ -320,6 +320,21 @@
 						"Assets\\Unlit_WF_ShaderSuite": ""
 					},
 					"legacyFiles": {}
+				},
+				"2.5.0": {
+					"name": "jp.whiteflare.unlitwf",
+					"version": "2.5.0",
+					"displayName": "UnlitWF Shader",
+					"description": "General Shader Pack for VRChat, Unity.",
+					"url": "https://github.com/whiteflare/Unlit_WF_ShaderSuite/releases/download/UnlitWF_Shader_20241123/jp.whiteflare.unlitwf-2.5.0.zip?",
+					"unity": "2019.1",
+					"vpmDependencies" : {
+						"jp.whiteflare.unlitwf.texpack" : "^1.1.0"
+					},
+					"legacyFolders": {
+						"Assets\\Unlit_WF_ShaderSuite": ""
+					},
+					"legacyFiles": {}
 				}
 			}
 		},