summaryrefslogtreecommitdiff
path: root/Assets/MeshUtility/README.md
blob: c96f8f9052a5dabd9b1cb1189c1d841faf6ad912 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
# MeshUtility

Mesh processing tool in Unity platform.

## Utilities

### MeshSeparator

Separate the target mesh into different categories based on given conditions.

Currently support BlendShape mesh separation. See [documentation](Documentation/notes/MeshSeparator.md) for more details.

<img src="Documentation/images/blendshape_separator.jpg" width="300">

### MeshIntegrator

Integrate all the meshes of a Prefab (Project window).

### Integrate Static Mesh

Integrate all the static meshes in the Hierarchy (Root and its children).

### MeshNormalizer

Bake the Hierarchy. This is VRM normalize backend.
MeshNormalizer can do blendShape bake.

## Import MeshUtility

There are two ways to import MeshUtility into a Unity project.

### 1. Unity Package Manager (from Unity 2019)

You can add MeshUtility package via `UPM`. First click `Window` from menu on top, then select `Package Manager`.

<img src="Documentation/images/installation_1.jpg" width="200">

In `Package Manager`, click `Add package from git URL` and paste `https://github.com/vrm-c/UniVRM.git?path=/Assets/MeshUtility`.

<img src="Documentation/images/installation_2.jpg" width="200">

Now check your project window. You shall see MeshUtility in the `Packages` folder.

### 2. Add package name and its url in manifest.json

Another way of importing MeshUtility is manually adding necessary information in manifest.json, which is in the directory of `Package folder` in your Unity project. Open manifest.json with text editor and add the followings in `dependencies`:

```json
{
  "dependencies": {
    "com.vrmc.meshutility": "https://github.com/vrm-c/UniVRM.git?path=/Assets/MeshUtility",
  }
}
```

Go back to the Unity project. The system will automatically load the package.

<img src="Documentation/images/installation_3.jpg" width="200">