> For the complete documentation index, see [llms.txt](https://aventurine.gitbook.io/avalon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aventurine.gitbook.io/avalon/document/feature/face-binder.md).

# Face Binder

フェイスバインダー

コンパクトな非破壊表情改変ツール集です。

{% hint style="success" %}

#### こんな時に使えます

* [表情改変したい](/avalon/document/tutorial/04.md)
  {% endhint %}

***

## ✦ ジェスチャー表情のバインド <a href="#gesture" id="gesture"></a>

ハンドジェスチャーに対応した表情を割り当てる機能です。

<figure><img src="https://2315355677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe4sUmINysj52de3UGEbH%2Fuploads%2FxH0JW849QghMsoSTyfyT%2Fimage.png?alt=media&amp;token=6bb2c878-e8b2-4144-bd24-92a9629f1550" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**【対象アバター】**

アバタールート（一番親）を指定してください。

**【プリセット選択】**

表情を追加するハンドジェスチャーを「左手のみ」「右手のみ」「両手（右手優先）」から選択してください。

**【Fist/Open/Point…の欄】**

各ジェスチャー中に再生するAnimation Clip（.anim）を指定してください。

**【まばたきを許可】**

チェックを入れると、ジェスチャーによる表情再生中まばたきアニメーションを再生します。

まばたきアニメーションが乗算されると顔が破綻する場合はOFFにしてください。
{% endhint %}

**【表情を適用】**&#x30DC;タンをクリックすると、\
表情設定用のAnimator Controllerが生成され、Hierarchy上に以下のオブジェクトが生成されます。

```
アバタールート > FaceBinder > ジェスチャー表情
```

「ジェスチャー表情」オブジェクトにはMA Merge Animatorが設定されており、\
生成したAnimator Controllerをビルド時にFXにマージすることで表情を上書きしています。

適用を取り消したい場合は、「ジェスチャー表情」オブジェクトを削除してください。

{% hint style="danger" %}
デフォルト表情との干渉を防ぐため、デフォルトのまばたきがアニメーションで設定されている場合は、自動的に無効化されます。

デフォルトのまばたきアニメーションを使用したい場合は、[✦ まばたき設定](#mabataki)でデフォルトのアニメーションを適用してください。
{% endhint %}

***

## ✦ まばたき設定 <a href="#blink" id="blink"></a>

任意のアニメーションをまばたきに設定する機能です。

<figure><img src="https://2315355677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe4sUmINysj52de3UGEbH%2Fuploads%2FwuHPN2CiC8kYTLqT2S9L%2Fimage.png?alt=media&amp;token=a3349220-ceb4-4226-9292-45f0084d53a8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**【まばたきアニメーション】**

設定したいAnimation Clip（.anim）を指定してください。
{% endhint %}

**【まばたきを適用】**&#x30DC;タンをクリックすると、\
まばたき設定用のAnimator Controllerが生成され、Hierarchy上に以下のオブジェクトが生成されます。

```
アバタールート > FaceBinder > まばたき
```

「まばたき」オブジェクトにはMA Merge Animatorが設定されており、\
生成したAnimator Controllerをビルド時にFXにマージすることで表情を上書きしています。

適用を取り消したい場合は、「まばたき」オブジェクトを削除してください。

***

## ✦ 口干渉防止 <a href="#mouth" id="mouth"></a>

リップシンク中（発声中）に口の形状が破綻する現象を防止する機能です。

<figure><img src="https://2315355677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe4sUmINysj52de3UGEbH%2Fuploads%2Fzs3sIbg4XI7AsjTOqYVw%2Fimage.png?alt=media&amp;token=125dbbc3-32ce-4710-8390-767cadcb375c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**【検索】【カテゴリ】**

シェイプキー名やカテゴリで絞り込めます。

**【すべて選択】【全て選択解除】**

表示しているシェイプキーをすべて選択/選択解除できます。

絞り込み機能で表示されていないシェイプキーには影響しません。

**【シェイプキーリスト】**

口の形状に関わるシェイプキー（歯や舌を含む）をすべて選択してください。

クリックで選択、Shift+クリックで範囲選択でき、選択中のものは青くなります。
{% endhint %}

**【口干渉防止を適用】**&#x30DC;タンをクリックすると、\
口干渉防止用のAnimator Controllerが生成され、Hierarchy上に以下のオブジェクトが生成されます。

```
アバタールート > FaceBinder > 口干渉防止
```

「口干渉防止」オブジェクトにはMA Merge Animatorが設定されており、\
生成したAnimator Controllerをビルド時にFXにマージすることで表情を上書きしています。

適用を取り消したい場合は、「口干渉防止」オブジェクトを削除してください。

{% hint style="warning" %}

#### カテゴリ検出機能の精度向上にご協力ください！

カテゴリ検出がうまくいかない場合は、ぜひDiscordご報告ください！

下の参考画像のような、**カテゴリ分けの方法がわかるシェイプキー一覧のスクリーンショット**があると非常に助かります！

<p align="center"><img src="https://2315355677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe4sUmINysj52de3UGEbH%2Fuploads%2FORmVfJOxUi4ra78LahtW%2Fimage.png?alt=media&amp;token=5e04e875-a18c-43b6-a162-e8221bb0acbb" alt="" data-size="original"></p>
{% endhint %}
