Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs/localization: 利点の説明を追加、その他改善 #535

Merged
merged 9 commits into from
Oct 7, 2023
17 changes: 14 additions & 3 deletions .docs/content/docs/reference/freeze-blendshape/index.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,23 @@ weight: 25

# Freeze BlendShape

ブレンドシェイプをメッシュに固定し、除去することが出来ます。
BlendShapeをメッシュに固定し、除去することが出来ます。

このコンポーネントは[Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component)であるため、SkinnedMeshRendererコンポーネントのあるGameObjectに追加してください。
このコンポーネントは、SkinnedMeshRendererコンポーネントのあるGameObjectに追加してください。(分類: [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component))

## 利点 {#benefits}

BlendShapeの固定・除去には以下の効果があります。
Sayamame-beans marked this conversation as resolved.
Show resolved Hide resolved

- BlendShapeの値が0以外のときは処理負荷が発生するため、値をアニメーション等で変更しないBlendShapeは固定すると負荷が軽くなります。
- 値が常に0である場合でも、固定することでアバターの容量を削減することができます。

## 備考 {#notes}

固定すると、アニメーションでの値変更は出来なくなります。

## 設定 {#settings}

![component.png](component.png)

ブレンドシェイプの一覧が表示されるので、固定・除去対象のブレンドシェイプを選択してください
BlendShapeの一覧が表示されるので、固定・除去対象のBlendShapeを選択してください
13 changes: 12 additions & 1 deletion .docs/content/docs/reference/freeze-blendshape/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,18 @@ weight: 25

Freeze & remove BlendShape from the mesh.

This component is [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component), so this should be added to a GameObject which has a SkinnedMeshRenderer component.
This component should be added to a GameObject which has a SkinnedMeshRenderer component. (Kind: [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component))

## Benefits

Freezing & removing BlendShapes has the following benefits.

- For BlendShapes with non-zero weight, freezing BlendShapes will reduce processing cost.
- Even if the weight is zero, removing BlendShapes will reduce the size of avatars.

## Notes

By freezing BlendShape, the weights cannot be changed on Animation.

## Settings

Expand Down
31 changes: 20 additions & 11 deletions .docs/content/docs/reference/merge-skinned-mesh/index.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,17 +7,26 @@ weight: 21

1つ以上のSkinnedMeshRendererやMeshRendererを1つのSkinnedMeshRendererに統合することが出来ます。

このコンポーネントは[Source Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#source-component)であるため、メッシュを指定していないSkinnedMeshRendererコンポーネントがある新規GameObjectに追加してください。
このコンポーネントは、メッシュを指定していないSkinnedMeshRendererコンポーネントがある新規GameObjectに追加してください。(分類: [Source Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#source-component))

このコンポーネントはメッシュ・ボーン・マテリアル・BlendShape・Boundsを統合しますが、その他の設定については変更しないため、AnchorOverride等の設定を行うには、MergeSkinnedMeshのあるGameObject上のSkinnedMeshRendererを編集してください。
## 利点 {#benefits}

このコンポーネントは、服のメッシュや体のメッシュを統合するのには適していますが、顔のメッシュを統合するのには適していません。
ブレンドシェイプは、頂点とブレンドシェイプの数に比例して負荷が大きくなる機能です。
顔のメッシュは一般的に多くのブレンドシェイプを持っており、メッシュの統合はその頂点数を増加させるため、負荷を大きくしてしまいます。
そのため、顔のメッシュは統合するべきではありません。
SkinnedMeshRendererを統合することでメッシュを変形させる処理の回数が減り、負荷が軽くなります。
また、同じマテリアルを使用しているマテリアルスロットも統合することができるので、描画負荷も減らす事ができます。

同様に、体や服のメッシュのブレンドシェイプは固定・除去することを推奨します。
[Freeze BlendShape](../freeze-blendshape)コンポーネントを統合対象・統合先のSkinnedMeshRendererのいずれか(または両方)に追加して、ブレンドシェイプを固定・除去することが出来ます。
## 備考 {#notes}
アニメーションでメッシュのオン・オフを個別に切り替えたりすることはできなくなりますが、マテリアルに関するアニメーションは統合前のものがそのまま機能します。

このコンポーネントはメッシュ・マテリアル・BlendShape・Boundsを設定しますが、その他の設定については変更しません。
AnchorOverride等の設定を行うには、MergeSkinnedMeshのあるGameObject上のSkinnedMeshRendererを編集してください。

また、このコンポーネントは、服のメッシュや体のメッシュを統合するのには適していますが、顔のメッシュを統合するのには適していません。
BlendShapeは、頂点とBlendShapeの数に比例して負荷が大きくなる機能です。
顔のメッシュは一般的に多くのBlendShapeを持っているため、統合対象に含めると頂点数の増加により負荷が大きくなってしまいます。

同様に、体や服のメッシュのBlendShapeは固定・除去することを推奨します。
[Freeze BlendShape](../freeze-blendshape)コンポーネントを統合対象・統合先のSkinnedMeshRendererのいずれか(または両方)に追加して、BlendShapeを固定・除去することが出来ます。
[Trace and Optimize](../trace-and-optimize)コンポーネントの`BlendShapeを自動的に固定・削除する`によっても同様の効果を得ることが出来ます。

## 設定 {#settings}

Expand All @@ -29,19 +38,19 @@ weight: 21

一番下の"None"と書いてある要素にドラッグ&ドロップすることにより対象を追加し、Noneに戻すことにより対象を一覧から取り除きます。

## 静的レンダラー {#static-renderers}
### 静的レンダラー {#static-renderers}

統合対象のMeshRendererの一覧です。

静的メッシュの移動・回転・変形をボーンで再現します。

一番下の"None"と書いてある要素にドラッグ&ドロップすることにより対象を追加し、Noneに戻すことにより対象を一覧から取り除きます。

## 空のレンダラーオブジェクトを削除する {#remove-empty-renderer-gameobject}
### 空のレンダラーオブジェクトを削除する {#remove-empty-renderer-gameobject}

統合対象のSkinnedMeshRendererが属しているGameObjectにSkinnedMeshRenderer以外のコンポーネントが無い場合、そのGameObjectをヒエラルキーから取り除くオプションです。

## マテリアルの統合 {#merge-materials}
### マテリアルの統合 {#merge-materials}

複数の(Skinned)MeshRendererで使用されているマテリアルがある場合、ここに一覧で表示されます。

Expand Down
20 changes: 15 additions & 5 deletions .docs/content/docs/reference/merge-skinned-mesh/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,18 @@ weight: 21

Merges one or more SkinnedMeshRenderer and MeshRenderers into one SkinnedMeshRenderer.

This component is [Source Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#source-component), so this should be added to a new GameObject which has a SkinnedMeshRenderer component without Mesh specified.
This component should be added to a new GameObject which has a SkinnedMeshRenderer component without Mesh specified. (Kind: [Source Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#source-component))

This component will merge mesh, bones, Materials, BlendShapes, and Bounds but other settings will not be modified.
## Benefits

Merging SkinnedMeshRenderer will reduce number of deforming mesh (skinning).
Also, it can reduce material slots using the same material, so we can reduce rendering cost.

## Notes

This component makes it impossible to turn meshes on and off individually on animations, but material-related animations will work without modification.

This component will configure Meshes, Materials, BlendShapes, and Bounds but other settings will not be modified.
Please edit SkinnedMeshRenderer component attached to same GameObject as MergeSkinnedMesh to set AnchorOverride or else.

This component is good for merging your cloth meshes and body meshes but not good for face meshes because BlendShape can cause performance impact.
Expand All @@ -20,6 +29,7 @@ That's why it's not good to merge face meshes.
In addition, because of same reasons, you should freeze & remove unchanging BlendShapes for body / cloth meshes.
You can freeze & remove BlendShape using [Freeze BlendShape](../freeze-blendshape) component.
Add this component to both/either merge source SkinnedMeshRenderer and/or merged SkinnedMeshRenderer to freeze & remove BlendShapes.
Also, you can use `Automatically Freeze Blend Shape` of [Trace and Optimize](../trace-and-optimize) component to get the same benefits.

## Settings

Expand All @@ -31,20 +41,20 @@ The list of SkinnedMeshRenderers to be merged.

Drop to None element at the bottom to add renderer and reset to None to remove from the list.

## Static Renderers
### Static Renderers

The list of MeshRenderers (without mesh transform).

Those meshes are transformed to polygons weighted to one bone, the GameObject that MeshRenderer belongs to.

Drop to None element at the bottom to add renderer and reset to None to remove from the list.

## Remove Empty Renderer GameObject
### Remove Empty Renderer GameObject

If this checkbox is checked and the GameObject SkinnedMeshRenderer belongs to does not have
any other components than SkinnedMeshRenderer, the GameObject will be removed from Hierarchy.

## Merge Materials
### Merge Materials

If MergeSkinnedMesh component found some Materials used in multiple renderers, the Materials will be listed here.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 25

手動でテクスチャを並び替えることにより、`VRChat/Mobile/Toon Lit`のマテリアルを1つのマテリアルに統合します。

このコンポーネントは[Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component)であるため、SkinnedMeshRendererコンポーネントのあるGameObjectに追加してください。
このコンポーネントは、SkinnedMeshRendererコンポーネントのあるGameObjectに追加してください。(分類: [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component))

現在、このコンポーネントは大きな需要があると見られる`VRChat/Mobile/Toon Lit`シェーダーのみをサポートしています。
他のシェーダーのサポートも追加する可能性があります。(サードパーティシェーダーでも対応します)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 25

Merge `VRChat/Mobile/Toon Lit` materials to one material by packing texture manually.

This component is [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component), so this should be added to a GameObject which has a SkinnedMeshRenderer component.
This component should be added to a GameObject which has a SkinnedMeshRenderer component. (Kind: [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component))

This component currently only supports `VRChat/Mobile/Toon Lit` because I believe there are big demands
but I may add support for other shaders. (also for third-party shaders)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,18 @@ weight: 25

# Remove Mesh By BlendShape

指定されたブレンドシェイプによって動かされる頂点とそのポリゴンを削除します
指定されたBlendShapeによって動かされる頂点とそのポリゴンを削除します。

このコンポーネントは[Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component)であるため、SkinnedMeshRendererコンポーネントのあるGameObjectに追加してください。
このコンポーネントは、SkinnedMeshRendererコンポーネントのあるGameObjectに追加してください。(分類: [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component))

## 利点 {#benefits}

服で隠れていたりして見えないような部分のメッシュを削除すると、見た目に影響させずに描画負荷やBlendShapeの処理負荷などを減らして軽量化することができます。
このコンポーネントを使用すると、多くの素体に含まれている貫通防止用のBlendShapeを利用して簡単にメッシュを削除することができます。

## 設定 {#settings}

![component.png](component.png)

ブレンドシェイプの一覧が表示されるので、ブレンドシェイプを選択してください
もし選択されたブレンドシェイプが頂点を`許容差`より大きく動かしていたら、その頂点を削除します。
BlendShapeの一覧が表示されるので、BlendShapeを選択してください
もし選択されたBlendShapeが頂点を`許容差`より大きく動かしていたら、その頂点を削除します。
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,12 @@ weight: 25

Remove vertices transformed by specified BlendShape and their polygons.

This component is [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component), so this should be added to a GameObject which has a SkinnedMeshRenderer component.
This component should be added to a GameObject which has a SkinnedMeshRenderer component. (Kind: [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component))

## Benefits

By removing polygons which are hidden by clothes or something, you can reduce rendering cost, BlendShape processing cost, etc. without affecting the appearance so much.
You can use this component to easily remove polygons with BlendShapes for shrinking parts of the body, which many avatars have.

## Settings

Expand Down
6 changes: 5 additions & 1 deletion .docs/content/docs/reference/remove-mesh-in-box/index.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,11 @@ weight: 25

箱で指定した範囲内のポリゴンを削除します。

このコンポーネントは[Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component)であるため、SkinnedMeshRendererコンポーネントのあるGameObjectに追加してください。
このコンポーネントは、SkinnedMeshRendererコンポーネントのあるGameObjectに追加してください。(分類: [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component))

## 利点 {#benefits}

服で隠れていたりして見えないような部分のメッシュを削除すると、見た目に影響させずに描画負荷やBlendShapeの処理負荷などを減らして軽量化することができます。

## 設定 {#settings}

Expand Down
6 changes: 5 additions & 1 deletion .docs/content/docs/reference/remove-mesh-in-box/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,11 @@ weight: 25

Remove some polygons in any of specified boxes.

This component is [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component), so this should be added to a GameObject which has a SkinnedMeshRenderer component.
This component should be added to a GameObject which has a SkinnedMeshRenderer component. (Kind: [Modifying Edit Skinned Mesh Component](../../component-kind/edit-skinned-mesh-components#modifying-component))

## Benefits

By removing polygons which are hidden by clothes or something, you can reduce rendering cost, BlendShape processing cost, etc. without affecting the appearance so much.

## Settings

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ aliases:
このコンポーネントは、アバターを走査して自動的にできる限りの最適化を行います。
チェックボックスで自動的に行う最適化を選択することが出来ます。

このコンポーネントは[Avatar Global Component](../../component-kind/avatar-global-components)であるため、アバターのルートに追加してください。
このコンポーネントはアバターのルートに追加してください。(分類: [Avatar Global Component](../../component-kind/avatar-global-components))

現在、以下の機能を使った自動最適化が可能です。
- [FreezeBlendShape](../freeze-blendshape)
Expand Down
2 changes: 1 addition & 1 deletion .docs/content/docs/reference/trace-and-optimize/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ aliases:
This component will trace your avatar and optimize your avatar automatically.
You can enable/disable some automatic optimization features with checkboxes.

This component is [Avatar Global Component](../../component-kind/avatar-global-components), so this should be added to an avatar root.
This component should be added to an avatar root. (Kind: [Avatar Global Component](../../component-kind/avatar-global-components))

Currently the following optimizations are applied automatically.
- [FreezeBlendShape](../freeze-blendshape)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 11

EditorOnlyなメッシュからしか参照がないボーンをEditorOnlyにします。

このコンポーネントは[Avatar Global Component](../../component-kind/avatar-global-components)であるため、アバターのルートに追加してください。
このコンポーネントはアバターのルートに追加してください。(分類: [Avatar Global Component](../../component-kind/avatar-global-components))

{{< hint warning >}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 11

Marks it as EditorOnly that bones referenced only from EditorOnly meshes.

This component is [Avatar Global Component](../../component-kind/avatar-global-components), so this should be added to an avatar root.
This component should be added to an avatar root. (Kind: [Avatar Global Component](../../component-kind/avatar-global-components))

{{< hint warning >}}

Expand Down
2 changes: 1 addition & 1 deletion .docs/content/docs/tutorial/basic-usage/index.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ Anchor Overrideには素体で用いられているものを、Root BoneにはHi

素体のメッシュに`Remove Mesh By BlendShape`コンポーネントを追加しましょう!

想定外の部位が削除されてしまわないかを確認するために`プレビューのために切り替えたブレンドシェイプの値を自動的に変更する`にチェックし、
想定外の部位が削除されてしまわないかを確認するために`プレビューのために切り替えたBlendShapeの値を自動的に変更する`にチェックし、
削除したい部位の貫通防止用BlendShapeを下の一覧から選択しましょう!

![remove mesh by BlendShape](./remove-mesh-by-blendshape.png)
1 change: 1 addition & 0 deletions CHANGELOG-PRERELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ The format is based on [Keep a Changelog].
### Added

### Changed
- Change Japanese Translation of "BlendShape" `#535`

### Deprecated

Expand Down
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ The format is based on [Keep a Changelog].
- You may use `Use Legacy GC` to use legacy algotythm for Remove Unused Objects in `Advanced Settings` (`#419`)
- Performance: Share MeshInfo2 between SkinnedMesh processing and MergeBone `#421`
- Declare compatible with VRCSDK 3.4.x `#513`
- Change Japanese Translation of "BlendShape" `#535`

### Deprecated
- UnusedBonesByReferenceTool component is now obsolete `#430`
Expand Down
Loading