{"id":13340833,"url":"https://github.com/chigirits/BlendShapeCombiner","last_synced_at":"2025-03-11T19:30:42.824Z","repository":{"id":184645066,"uuid":"285993854","full_name":"chigirits/BlendShapeCombiner","owner":"chigirits","description":"複数のブレンドシェイプを合成した新しいシェイプキーを追加し、新しいメッシュとして保存するUnityエディタ拡張です。Boothでも配布中👇","archived":false,"fork":false,"pushed_at":"2024-04-28T01:05:09.000Z","size":79,"stargazers_count":31,"open_issues_count":1,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-24T06:29:46.195Z","etag":null,"topics":["avatar","unity","unityeditor","vrchat"],"latest_commit_sha":null,"homepage":"https://chigiri.booth.pm/items/2394036","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chigirits.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-08T07:15:44.000Z","updated_at":"2024-10-11T02:43:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"3db211f2-78dc-4be1-a3bf-46ab72f3922f","html_url":"https://github.com/chigirits/BlendShapeCombiner","commit_stats":null,"previous_names":["chigirits/blendshapecombiner"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigirits%2FBlendShapeCombiner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigirits%2FBlendShapeCombiner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigirits%2FBlendShapeCombiner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chigirits%2FBlendShapeCombiner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chigirits","download_url":"https://codeload.github.com/chigirits/BlendShapeCombiner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243098641,"owners_count":20236064,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avatar","unity","unityeditor","vrchat"],"created_at":"2024-07-29T19:24:02.623Z","updated_at":"2025-03-11T19:30:42.519Z","avatar_url":"https://github.com/chigirits.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BlendShapeCombiner\n\n複数のブレンドシェイプを合成した新しいシェイプキーを追加し、新しいメッシュとして保存するUnityエディタ拡張です。\n\n係数を指定できるため、たとえば「瞳を小さくする」シェイプキーから「瞳を大きくする」シェイプキーを作ったり、0～100の範囲外に設定したウェイトを正規化することも可能です。\n\n開発経緯としては、VRChat Avatars 3.0 のまばたき用シェイプキーが1つしか指定できない問題への対策が発端ですが、他の用途にも汎用的に用いることができます。\n\n![image](https://repository-images.githubusercontent.com/285993854/facec380-fc27-11ea-9588-d9cd6b608ba7)\n\n## 動作環境\n\nUnity 2019.4 以降\n\n## インポート手順\n\n### unitypackageをインポートする方法\n\n[Releasesページ](https://github.com/chigirits/BlendShapeCombiner/releases) より最新版の `BlendShapeCombiner-vX.X.X.unitypackage` をダウンロードし、Unityにインポートする\n\n### パッケージマネージャを用いる方法\n\n1. インポート先プロジェクトの `Packages/manifest.json` をテキストエディタ等で開く\n2. `dependencies` オブジェクト内に以下の要素を追加\n   \n   ```\n   \"com.github.chigirits.blendshapecombiner\": \"https://github.com/chigirits/BlendShapeCombiner.git\",\n   ```\n\n## 使い方\n\n1. シーンにモデルを配置してください。\n2. 「メニュー/Chigiri/Create BlendShapeCombiner」を選択すると、ヒエラルキーのトップレベルに BlendShapeCombiner が配置されます。\n3. BlendShapeCombiner の `Target` に、操作対象となる SkinnedMeshRenderer（アバターの表情に適用する場合、一般的には Body オブジェクト）を指定してください。\u003cbr\u003e\n   このとき、対象にアタッチされているメッシュが `Source Mesh` に自動的にセットされ、`new_key` という新規シェイプキーが追加されます。\n   \n   ![usage-01](https://github.com/chigirits/BlendShapeCombiner/assets/61717977/aad1394a-a1da-41fd-a76a-b5c5c6c548bf)\n4. `New Keys` リストタブから一つの行（ここでは `new_key`）を選択すると、選択中の新規シェイプキーの詳細設定が下部（Detail of selected New Key）に表示されます。`Name` テキストフィールド（デフォルト値 `new_key` が入力されている箇所）を、これから作成したい新規シェイプキーの名前に変更してください。次に、その下の各プルダウンから合成元のシェイプキーを選択してください。\n   \n   - スケール係数（右端にあるテキストボックスの数値）を `1` 以外にすることで、効果のかかり具合を調整することができます（後述の[スケール係数](#スケール係数)を参照）。\n   - 合成元となるシェイプキーの数を増減するには、`Source Keys`  リストタブの右下にある `+` `-` を押してください（削除する際は事前に対象行を選択してください）。\n   - 作成する新規シェイプキー自体を増減するには、`New Keys` リストタブの右下にある `+` `-` を押してください（削除する際は事前に対象行を選択してください）。\n   \n   ![usage-02](https://github.com/chigirits/BlendShapeCombiner/assets/61717977/69ebd372-0373-49ad-aa61-4581eefcf533)\n5. `Process And Save As...` ボタンを押して、生成された新しいメッシュを保存してください。\n   \n   ![usage-03](https://github.com/chigirits/BlendShapeCombiner/assets/61717977/ee8b5c66-e57f-476b-8543-5c4aea387f42)\n\n   保存が完了すると、`Target` の SkinnedMeshRenderer に新しいメッシュがアタッチされます。\n   この差し替えられたメッシュに追加されている新しいシェイプキーの値を変更してみて、期待どおりの効果がかかることを確認してください。\n   \n   ![usage-04](https://github.com/chigirits/BlendShapeCombiner/assets/61717977/b1c78320-b1ef-4987-8e04-fd154015b9ff)\n\n## 全体オプション詳細\n\n以下では、インスペクタ上部に一行ずつ並んでいるチェックボックスのオプションについて説明します。\n\n### Use Text Field\n\n合成元となるシェイプキーを選択するインタフェースを、プルダウンではなくテキスト入力式にします。\nコピー＆ペースト等を活用したい場合や、プルダウンが長すぎて不便なときはONにしてみてください。\n\n### Use Percentage\n\nスケール係数を百分率で表示・指定します。Skinned Mesh Renderer のブレンドシェイプ値と同様に扱いたい場合はONにしてください（`Capture` / `Extract` ボタンを用いる場合に便利です）。\n\n### Clear Existing Keys\n\n既存のシェイプキーをすべて削除し、定義されている新規シェイプキーだけを持つメッシュを生成します。\n\n### Overwrite Existing Keys\n\n既存のシェイプキーと同名の新規シェイプキーを定義しているとき、既存のものを削除して上書きしたメッシュを生成します。\n\n### Clear Normal/Tangent\n\n新規シェイプキーの持つ法線・タンジェントの変化量を強制的に 0 にします。\n\n### Don't Clear Regex\n\n`Clear Existing Keys` で既存シェイプキーを削除するとき、ここに指定した正規表現に合致する名前のシェイプキーは削除せずに残します。\n\n### GroupBy Regex\n\n合成元シェイプキーをグループ分けし、新しく生成されるシェイプキーも同じ数だけグループ分けして出力します。キャプチャ名付きの正規表現を指定することで、マッチしたキャプチャ名をグループ名とするようにグループ分けされます（マッチしなかった場合はデフォルトと同じ名前になります）。\nたとえば新規シェイプキー `Smile` が定義されているとき、この項目に `(?\u003cMouth\u003e^mouth)` と指定して新しいメッシュを生成すると、`mouth` で始まるシェイプキーのみを合成した `Smile__Mouth` と、それ以外のシェイプキーのみを合成した `Smile` の2つの新規シェイプキーが生成されます。\n\n## 新規シェイプキーのオプション詳細\n\n### For Animation\n\n`Create Animation Clips` ボタン押下時にアニメーションクリップの出力対象とするかどうかを設定します。\n\n## 合成元シェイプキーのオプション詳細\n\n以下では、Detail of selected New Key 内 `Source Keys` リストタブの各行の右に並んでいるプルダウンやテキスト入力欄のオプションについて説明します。\n\n### 合成元シェイプキー\n\n合成元となるシェイプキーを選択します。`Use Text Field` がONのときは、シェイプキーの名称をテキストで入力できます。\n\n### LRプルダウン\n\n`LR` と表示されているプルダウンから `L` や `R` を選択すると、合成元シェイプキーが効果を及ぼす対象範囲を左右いずれかのみに限定することができます。\n\nたとえば、両目を閉じるシェイプキーを元として、片目だけを閉じるシェイプキーを作成することができます。\n\n### スケール係数\n\n一番右側にあるテキスト入力欄の数値で、合成元のシェイプキーのかかり具合を調節します。`1` 以外を指定することで、かかり具合を微量または極端にできます（`Use Percentage` がONのときの通常値は `100`）。\n\nマイナスの値を指定することで、かかり具合を逆方向にすることができます。たとえば、瞳を小さくするシェイプキーのスケール係数に `-1`（`Use Percentage` がONのときは `-100`）を指定することで、瞳を大きくするシェイプキーを作成することができます。\n\n他にも、たとえば「A:目を閉じる」と「B:目を閉じて口を開く」しかシェイプキーがないモデルに対して、Aの -1 スケール化シェイプキーをBに重ねがけすることで、口だけを開いた表情を作ることができるようになります。\n\n## ボタン機能\n\n以下では、インスペクタ下部に並んでいるボタンの機能について説明します。\n\n### Capture/Extract ボタン\n\n`Capture` ボタンを押すと、`Target` のメッシュに現在設定されているすべてのブレンドシェイプ値を合成する新規シェイプキーが追加されます（`Capture(Overwrite)` も同様ですが、選択中の新規シェイプキーに上書きします）。\n\n逆に `Extract` ボタンを押すと、現在選択中の新規シェイプキーに設定されているすべての合成元ブレンドシェイプ値を、`Target` のメッシュに個別に反映します。このとき、LRプルダウンの内容は反映されないことにご注意ください。\n\n### Sort Sources ボタン\n\n選択中の新規シェイプキーについて、合成元シェイプキーを名前順に並べ替えます。\n\n### Round Scale ボタン\n\n選択中の新規シェイプキーのスケール係数を、各ボタンに例示された精度になるよう四捨五入します。\n\n### Merge Down ボタン\n\n選択中の新規シェイプキーに含まれる合成元シェイプキーのリストを、すぐ下にある新規シェイプキーの同リストに合成します。選択中だった新規シェイプキーは削除されます。\n\n### Create VRC Shape Keys ボタン\n\n`Source Mesh` に定義されている `vrc.` で始まる名前の全シェイプキーを、新規シェイプキーとして再定義します。たとえば、`vrc.v_aa` のみを合成元とする同名の新規シェイプキーが追加されますので、スケール係数を変更することにより「あ」列発声時のリップシンクによる口の開き具合を調整することができます。この機能は、`Clear Existing Keys` または `Overwrite Existing Keys` と併用する必要があります。\n\n### Create Animation Clips\n\n新規シェイプキーのそれぞれを表情アニメーションとして使用するためのアニメーションクリップを自動生成します。ボタン押下後に表示されるダイアログで、保存先のフォルダを指定してください。出力されるファイル名は、それぞれの新規シェイプキーと同一です。`For Animation` がONの新規シェイプキーのみが出力対象となります。\n\n## ライセンス\n\n[MIT License](./LICENSE)\u003cbr\u003e\n©2020 TSUTSUMI Chigiri\n\n- このソフトウェアは商用・非商用問わず無償で利用できますが、無保証です。利用に際して発生する問題については、作者は一切の責任を負いません。\n- コードを再利用する際は、著作権表示と上記リンク先のライセンス条文を同梱する必要があります。詳しくは条文（英語）をお読みください。\n\n## 更新履歴\n\n- v1.5.0\n  - UIの改善\n    - リスト下の＋ボタン押下時に、末尾ではなく選択中の位置の次に新規レコードを追加\n    - 長すぎるリストのスクロール表示\n    - Expert機能のFoldout\n  - 新機能オプションの追加\n    - Bake Into Base\n    - For Animation\n    - Don't Clear Regex\n    - GroupBy Regex\n  - 新機能ボタンの追加\n    - Capture(Overwrite)\n    - Merge Down\n    - Create VRC Shape Keys\n    - Create Animation Clips\n  - 他\n    - LRプルダウンが正しく機能しない問題を修正\n    - 一部機能がUndoできない問題を修正\n- v1.4.1\n  - UIの改善\n    - 指定メッシュにシェイプキーが多いとUIが重くなる問題を修正\n  - 新機能オプションの追加\n    - Use Percentage\n  - 新機能ボタンの追加\n    - Round Scale\n    - (仕様変更) Sort Sources ボタンの効果を選択中の新規シェイプキーのみに限定\n- v1.3.0\n  - 新機能オプションの追加\n    - Use Text Field\n    - Clear/Overwrite Existing Keys\n    - Clear Normal/Tangent\n    - LRプルダウン\n  - 新機能ボタンの追加\n    - Capture/Extract\n    - Sort Sources\n- v1.2.1\n  - VCC対応\n- v1.2.0\n  - UIの改善\n    - カスタムUI実装\n    - Source Mesh を Target とは独立して保持し、リトライ時の手間を軽減\n    - 保存ダイアログの初期ディレクトリを Source Mesh と同一に\n    - Revert Target ボタンを追加\n    - ツールチップ表示\n- v1.1.0\n  - スケール係数プロパティを追加\n  - 複数シェイプキーの一括追加に対応\n- v1.0.0\n  - 初回リリース\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchigirits%2FBlendShapeCombiner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchigirits%2FBlendShapeCombiner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchigirits%2FBlendShapeCombiner/lists"}