diff --git a/docs/docs/reference/mesh-settings.md b/docs/docs/reference/mesh-settings.md new file mode 100644 index 00000000..b506fb1f --- /dev/null +++ b/docs/docs/reference/mesh-settings.md @@ -0,0 +1,33 @@ +# Mesh Settings + +![Mesh Settings](mesh-settings.png) + +The Mesh Settings component lets you set certain mesh settings (anchor override and bounds) for all meshes +under a particular game object. + +## When should I use it? + +You can place this component at the top level of your avatar to ensure that bounds and light probe anchors +are consistent for all meshes in your avatar. + +The "Setup Outfit" feature will also automatically configure a Mesh Settings component on newly added outfits. + +Finally, Mesh Settings can be used to _exclude_ meshes from the influence of Mesh Settings higher up on the +hierarchy. + +## When shouldn't I use it? + +Setting bounds or light probes on assets for distribution requires some care, as these configurations +might be inconsistent with the avatar they are applied to. Generally, these should only be set on assets +designed for a specific avatar. + +## Manually configuring Mesh Settings + +When you add Mesh Settings to a game object, initially it is configured to do nothing. By setting either +"Anchor Override Mode" or "Bounds Override Mode" to "Set", you can configure the anchor override or bounds +for all meshes under that game object. Alternately, by setting the mode to "Don't set", you can exclude +these meshes from the influence of Mesh Settings higher up on the hierarchy. + +When configuring bounds, the bounding box will be determined relative to the transform you specify as the +"Root Bone". Note that bounds only affects Skinned Mesh Renderers, but Anchor Override also impacts other +types of renderers like Mesh Renderers or Line Renderers. diff --git a/docs/docs/reference/mesh-settings.png b/docs/docs/reference/mesh-settings.png new file mode 100644 index 00000000..64d6777e Binary files /dev/null and b/docs/docs/reference/mesh-settings.png differ 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 new file mode 100644 index 00000000..e0d96bf7 --- /dev/null +++ b/docs/i18n/ja/docusaurus-plugin-content-docs/current/reference/mesh-settings.md @@ -0,0 +1,30 @@ +# Mesh Settings + +![Mesh Settings](mesh-settings.png) + +Mesh Settingsコンポーネントを使用すると、特定のゲームオブジェクトの配下にあるすべてのメッシュに対して、特定のメッシュ設定 +(アンカーオーバーライドとバウンズ)を設定できます。 + +## いつ使うべきか + +このコンポーネントをアバターの最上位レベルに配置すると、アバター内のすべてのメッシュに対してバウンズとライトプローブアンカーが +一貫して設定されるようになります。 + +「Setup Outfit」機能は、新しく追加されたアウトフィットに自動的にMesh Settingsコンポーネントを自動的に設定します。 + +最後に、Mesh Settingsは、階層の上位にあるMesh Settingsの影響を受けないように、メッシュを除外するためにも使用できます。 + +## いつ使うべきでないか + +配布用のアセットにバウンズやライトプローブを設定する時は注意が必要です。なぜなら、これらの設定がアバターと一致しない可能性が +あります。一般的に、特定のアバター用に設計されたアセットの場合のみ設定を推奨します。 + +## Mesh Settingsの手動設定 + +ゲームオブジェクトにMesh Settingsを追加すると、最初は何も効果がありません。Anchor Overrideの設定モードまたはBounds Override +の設定モードを「設定」に設定することで、そのゲームオブジェクトの下にあるすべてのメッシュのアンカーオーバーライドまたはバウンズ +を設定できます。また、モードを「設定しない」に設定することで、これらのメッシュを階層の上位にあるMesh Settingsの影響から除外できます。 + +バウンズを設定する場合、バウンディングボックスは「Root Bone」として指定したトランスフォームに対して相対的に決定されます。 +また、バウンズはSkinned Mesh Rendererのみに影響しますが、Anchor OverrideはMesh RendererやLine Rendererなどの他のタイプの +Rendererにも設定されます。 \ No newline at end of file diff --git a/docs/i18n/ja/docusaurus-plugin-content-docs/current/reference/mesh-settings.png b/docs/i18n/ja/docusaurus-plugin-content-docs/current/reference/mesh-settings.png new file mode 100644 index 00000000..890f9ce2 Binary files /dev/null and b/docs/i18n/ja/docusaurus-plugin-content-docs/current/reference/mesh-settings.png differ