From 4354817134e57bf82f10d16296ab2455ad803389 Mon Sep 17 00:00:00 2001 From: bd_ Date: Sat, 16 Nov 2024 19:45:05 -0800 Subject: [PATCH 1/2] fix: incorrect item name in mesh settings JP docs Closes: #1314 --- .../current/reference/mesh-settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/mesh-settings.md b/docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/mesh-settings.md index 6d828753..8f8677ec 100644 --- a/docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/mesh-settings.md +++ b/docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/mesh-settings.md @@ -28,7 +28,7 @@ Mesh Settingsコンポーネントを使用すると、特定のゲームオブ - 継承:このコンポーネントはこの設定に対して何もしません。親のMesh Settingsで設定された値を継承します。 - 設定:このコンポーネントは、そのゲームオブジェクトとその子にあるメッシュの対応する設定を設定します。 - 設定しない:このコンポーネントは、親のMesh Settingsの影響を受けないようにします。メッシュはデフォルトの設定のままです。 -- 親が継承された時は継承、それ以外では設定:親のMesh Settingsが設定モードにある場合、それが使用されます。親のMesh +- 親で指定されている時は継承、それ以外では設定:親のMesh Settingsが設定モードにある場合、それが使用されます。親のMesh Settingsが適用されない場合、 このコンポーネントの設定が使用されます。衣装プレハブなどに、アバター全体の設定が優先されるようにするために便利です。 From 904c66975aecc8ed5921312cf290833629c32569 Mon Sep 17 00:00:00 2001 From: bd_ Date: Sun, 16 Feb 2025 16:02:56 -0800 Subject: [PATCH 2/2] docs: update outdated VHA docs Closes: #1444 --- docs~/docs/reference/visible-head-accessory.md | 12 ++++++++---- .../current/reference/visible-head-accessory.md | 11 +++++++---- 2 files changed, 15 insertions(+), 8 deletions(-) diff --git a/docs~/docs/reference/visible-head-accessory.md b/docs~/docs/reference/visible-head-accessory.md index e6383ce1..02b24ade 100644 --- a/docs~/docs/reference/visible-head-accessory.md +++ b/docs~/docs/reference/visible-head-accessory.md @@ -14,11 +14,15 @@ This component cannot be used as the child of a PhysBone chain (you can add it i Using this component on _all_ children of the Head can be distracting, as your bangs continually get in the way. -Finally, the processing involved in this component is somewhat heavyweight, and may result in slower build times. - ## Setting up Visible Head Accessory Just attach a Visible Head Accessory component under a child of the Head bone. There are no configuration options to set. -The component will automatically generate a clone of the Head bone, which is connected to the real head bone using a parent constraint. -Only one constraint will be generated, even if multiple Visible Head Accessory components are used. As such, the performance impact of this component is the same whether you use one or dozens. +## How it works + +On VRChat, the component uses VRCHeadChop to make the selected bones visible. The main difference between this and +simply using VRCHeadChop, is that it adjusts the mesh to ensure that triangles don't clip through the player viewpoint. + +This is done by looking for triangles that have some vertices weighted to a visible bone, and some weighted to a hidden +bone, such as the root `Head` bone. The component then adjusts the mesh, adding new proxy bones and switching the weights +over to ensure that the triangle is fully visible. \ No newline at end of file diff --git a/docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/visible-head-accessory.md b/docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/visible-head-accessory.md index 8f2d2dcf..b3b57d3d 100644 --- a/docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/visible-head-accessory.md +++ b/docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/visible-head-accessory.md @@ -14,11 +14,14 @@ Head以下のすべての子で使うと、前髪が邪魔になることがあるので要注意。 -また、このコンポーネントは処理が若干重いので、ビルド処理が数秒伸びることがあります。 - ## セットアップ方法 Headボーンの子にVisible Head Accessoryコンポーネントを付けるだけです。設定はありません。 -このコンポーネントは自動的にHeadボーンを複製し、Parent Constraintで本物のHeadボーンに追従させます。 -複数のVisible Head Accessoryコンポーネントを使っても、Constraintは一つだけです。なので、複数のボーンを指定しても、その分重くなることはありません。 +## 動作原理 + +VRChatでは、このコンポーネントはVRCHeadChopを使って選択したボーンを表示します。VRCHeadChopを使うのとの主な違いは、メッシュを調整し、 +三角形がプレイヤーの視点を通り抜けることがないようにすることです。 + +この問題を対処するには、一部の頂点が表示されるボーンにウェイトがかかっていて、一部が非表示のボーンにウェイトがかかっている +三角形を探し出し、新しいプロキシボーンを追加して、ウェイトをそちらに切り替えることで三角形が完全に表示されるようにする処理となっています。