diff --git a/README.md b/README.md index e69de29..54858f2 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,230 @@ +# Blender Add-on : Petit Armature Tools + +![](assets/images/pat-000.png) + +## Petit Armature Toolsについて + +『Petit Armature Tools』は、Blenderでアーマチュアとボーン作成を少し便利にするアドオンです。 + +### アドオンの機能 + +#### ボーンを作成 +- [選択した順序で辺の位置にボーンを作成](#選択した順序で辺の位置にボーンを作成) +- [選択した順序で辺ループの中点にボーンを作成](#選択した順序で辺ループの中点にボーンを作成) + +## 動作対象のBlenderバージョン + +- Blender 2.79b +- Blender 2.83.x LTS +- Blender 2.92.x + +## ダウンロード + +[最新バージョンをダウンロードする](https://github.com/samia-done/Petit-Armature-Tools/releases/latest/download/petit_armature_tools.zip) + +## インストール方法 + +1. Blenderの[編集]メニュー→[プリファレンス]の順にクリックして、[Blenderプリファレンス]画面を開きます。 +![](assets/images/pat-001.png) +1. ナビゲーションバーにある[アドオン]をクリックして、アドオンセクションを表示します。 +![](assets/images/pat-002.png) +1. [インストール]ボタンをクリックして[Blenderファイルビュー]の画面を開きます。 +1. ダウンロードした[Petit Armature Tools]のZipファイルを選択し、[アドオンをインストール]ボタンをクリックします。 +![](assets/images/pat-003.png) +1. [Petit Armature Tools]の左にある[アドオンを有効化]にチェックをつけて、アドオンを有効にします。 +![](assets/images/pat-005.png) + +## 使い方 + +アドオンをインストールすると、メッシュの[編集モード]の[編集]タブに、[Petit Armature Tools]パネルが追加されます。 +![](assets/images/pat-009.png) + +このアドオンは、辺の選択のみの状態でしか機能しません。 +[Petit Armature Tools]パネルのボタンが押せない状態ときは、[辺選択]のみを有効にしてください。 + +![](assets/images/pat-030.png) + +### 選択した順序で辺の位置にボーンを作成 + +選択した辺の順序で、辺と同じ位置にボーンを作成します。 + +1. メッシュの[編集モード]で、[辺選択]のみを有効にします。 +![](assets/images/pat-010.png) +2. ボーンを作成したい位置にある辺を1つ以上選択します。 +3. [編集]タブにある[選択した順序で辺の位置にボーンを作成]ボタンをクリックします。 +![](assets/images/pat-011.png) +4. 新しくアーマチュアオブジェクトとボーンが作成されました。 +[自動ウェイト]オプションが有効な場合、メッシュのオブジェクトにアーマチュアモディファイアが設定されます。 +![](assets/images/pat-013.png) +5. ボーンを動かしてみると、メッシュにウェイトが設定されていることを確認できます。 +![](assets/images/pat-014.png) + +#### 注意-1 + +- Ctrl + Clickや、Alt + Clickで選択した辺などは1つとしてカウントされます。Shift + Clickで複数の辺を選択するようにしてください。 + +- [自動ウェイト]が有効のときに、オブジェクトにボーン名と同じ名前の頂点グループが既に作成されている場合は、エラーが表示され終了します。(同じ名前の頂点グループは作成できないため) +その場合、以下のいずれかの方法で対処するようにしてください。 + - [自動ウェイト]をオフにする + - 設定オプションで別のボーン名に変更する + - 頂点グループが不要ならば、オブジェクトから頂点グループを削除する + +#### 設定オプション-1 + +![](assets/images/pat-015.png) + +ベース名 +: ボーンのベース名 + +区切り文字 +: ボーン名の区切り文字 + +接頭辞 +: ボーン名の先頭につける文字 + +接尾辞 +: ボーン名の末尾につける文字。 + +連番の開始番号 +: 自動で割り振られる連番の開始番号。 + +連番の桁数 +: 自動で割り振られる連番の桁数。 + +自動ボーンロール +: 自動でボーンロールを設定する機能を有効にします + +自動ウェイト +: 自動でウェイトを設定する機能を有効にします + +自動インクリメント +: 開始番号の自動インクリメントを有効にします + +ペアレント(親) +: 一つ前に作成したボーンを、親ボーンに設定します。 + +接続 +: ボーンに親があるとき、ボーンのヘッドを親ボーンのテールの位置に接続します。 + +オフセット +: ボーンを作成するとき、位置のオフセットを有効にします。 +[オフセット値]ボックスに辺の位置から離す距離を入力します。 + +### 選択した順序で辺ループの中点にボーンを作成 + +2つ以上選択した辺ループの順序で、辺ループの中点にボーンを作成します + +1. メッシュの[編集モード]で、[辺選択]のみを有効にします。 +![](assets/images/pat-016.png) +2. ボーンを作成したい位置にあるループ辺を2つ以上選択します。 +![](assets/images/pat-018.png) +3. チューブのような形状のループ辺を連続で選択したいときは、[選択]メニューにある[選択の拡大]から[次のアクティブ]を実行します。 +![](assets/images/pat-019.png) +4. 次のループ辺を選択できました。 +![](assets/images/pat-020.png) +5. キーボードのShift + Rを押すと、先ほどと同じ操作(ここでは、[次のアクティブ])を繰り返すことができます。 +![](assets/images/pat-021.png) +6. ボーンを作成したい位置までループ辺を選択したら、[編集]タブにある[選択した順序で辺の位置にボーンを作成]ボタンをクリックします。 +![](assets/images/pat-022.png) +7. 新しくアーマチュアオブジェクトとボーンが作成されました。 +[自動ウェイト]オプションが有効な場合、メッシュのオブジェクトにアーマチュアモディファイアが設定されます。 +![](assets/images/pat-023.png) +8. ボーンを動かしてみると、メッシュにウェイトが設定されていることを確認できます。 +![](assets/images/pat-024.png) + +#### 注意-2 + +- Ctrl + Clickや、Alt + Clickで選択した辺などは1つとしてカウントされます。Shift + Clickで複数の辺を選択するようにしてください。 +- [自動ウェイト]が有効のときに、オブジェクトにボーン名と同じ名前の頂点グループが既に作成されている場合は、エラーが表示され終了します。(同じ名前の頂点グループは作成できないため) +その場合、以下のいずれかの方法で対処するようにしてください。 + - [自動ウェイト]をオフにする + - 設定オプションで別のボーン名に変更する + - 頂点グループが不要ならば、オブジェクトから頂点グループを削除する + +#### 設定オプション-2 + +![](assets/images/pat-025.png) + +ベース名 +: ボーンのベース名 + +区切り文字 +: ボーン名の区切り文字 + +接頭辞 +: ボーン名の先頭につける文字 + +接尾辞 +: ボーン名の末尾につける文字 + +連番の開始番号 +: 自動で割り振られる連番の開始番号 + +連番の桁数 +: 自動で割り振られる連番の桁数 + +自動ウェイト +: 自動でウェイトを設定する機能を有効にします + +ペアレント(親) +: 一つ前に作成したボーンを、親ボーンに設定します + +接続 +: ボーンに親があるとき、ボーンのヘッドを親ボーンのテールの位置に接続します + +## エラーメッセージ + +### 頂点グループはすでに作成されています + +- [自動ウェイト]が有効のときに、オブジェクトにボーン名と同じ名前の頂点グループが既に作成されている場合に表示されるエラーです。 +- メッシュに設定されている頂点グループとウェイトを維持したままボーンの作成のみをやり直したい場合には、[自動ウェイト]のチェックを外すことでこのエラーを回避できます。 + +### このメッシュには辺がありません +- メッシュに辺が無い状態で[選択した順序で辺の位置にボーンを作成]を実行した際に表示されるエラーです。 + +### 1つ以上辺を選択してください + +- 選択された辺が無い状態で[選択した順序で辺の位置にボーンを作成]を実行した際に表示されるエラーです。 + +### このメッシュには複数の辺がありません + +- メッシュに辺が2つ以上無い状態で、[選択した順序で辺ループの中点にボーンを作成]を実行した際に表示されるエラーです。 + +### 2つ以上ループ辺を選択してください + +- 選択されたループ辺が2つ以上無い状態で、[選択した順序で辺ループの中点にボーンを作成]を実行した際に表示されるエラーです。 + +### 空白の名前は使用できません + +- 作成するボーンの名前が、何らかの原因で空白になってしまった場合に出るエラーです。 +- パネルのオプション項目にあるボーン名が、適切に設定されているかどうか確認してください。 + +## アップデート方法 + +本アドオンは、[Blenderプリファレンス]画面からアドオンの最新バージョンに更新することができます。 +アドオンを更新する際には、Blenderを終了して開き直してから行うようにしてください。 + +1. Blenderの[編集]メニュー→[プリファレンス]の順にクリックして、[Blenderプリファレンス]画面を開きます。 +2. ナビゲーションバーにある[アドオン]をクリックして、アドオンセクションを表示します。 +![](assets/images/pat-026.png) +3. [Petit Armature Tools]の左にある[下向き三角]をクリックして、アドオンの設定パネルを開きます。 +4. [アドオンの更新を確認する]ボタンをクリックします。 +![](assets/images/pat-027.png) +5. アドオンに更新があった場合には、[最新リリースバージョンに更新する]ボタンが表示されます。 +[最新リリースバージョンに更新する]ボタンをクリックします。 +![](assets/images/pat-028.png) +6. アドオンが更新されました。Blenderを再起動してください。 +![](assets/images/pat-029.png) + +## ライセンス + +[GPL License](LICENSE) + +## 免責事項 + +- Samiaは、利用者が本アドオンを使用することによって生じるいかなる損害に対して一切責任を負いません。 + +## 著者 + +GitHub:[Samia](https://github.com/samia_done) +Twitter:[@samia_done](https://twitter.com/samia_done) diff --git a/assets/images/pat-000.png b/assets/images/pat-000.png new file mode 100644 index 0000000..6955bb9 Binary files /dev/null and b/assets/images/pat-000.png differ diff --git a/assets/images/pat-001.png b/assets/images/pat-001.png new file mode 100644 index 0000000..db3ccbf Binary files /dev/null and b/assets/images/pat-001.png differ diff --git a/assets/images/pat-002.png b/assets/images/pat-002.png new file mode 100644 index 0000000..84d4532 Binary files /dev/null and b/assets/images/pat-002.png differ diff --git a/assets/images/pat-003.png b/assets/images/pat-003.png new file mode 100644 index 0000000..03bf59f Binary files /dev/null and b/assets/images/pat-003.png differ diff --git a/assets/images/pat-005.png b/assets/images/pat-005.png new file mode 100644 index 0000000..e1282dc Binary files /dev/null and b/assets/images/pat-005.png differ diff --git a/assets/images/pat-009.png b/assets/images/pat-009.png new file mode 100644 index 0000000..05328cd Binary files /dev/null and b/assets/images/pat-009.png differ diff --git a/assets/images/pat-010.png b/assets/images/pat-010.png new file mode 100644 index 0000000..dddbe12 Binary files /dev/null and b/assets/images/pat-010.png differ diff --git a/assets/images/pat-011.png b/assets/images/pat-011.png new file mode 100644 index 0000000..9550d2e Binary files /dev/null and b/assets/images/pat-011.png differ diff --git a/assets/images/pat-013.png b/assets/images/pat-013.png new file mode 100644 index 0000000..dcbffaa Binary files /dev/null and b/assets/images/pat-013.png differ diff --git a/assets/images/pat-014.png b/assets/images/pat-014.png new file mode 100644 index 0000000..13f948c Binary files /dev/null and b/assets/images/pat-014.png differ diff --git a/assets/images/pat-015.png b/assets/images/pat-015.png new file mode 100644 index 0000000..c7d340f Binary files /dev/null and b/assets/images/pat-015.png differ diff --git a/assets/images/pat-016.png b/assets/images/pat-016.png new file mode 100644 index 0000000..6f39c45 Binary files /dev/null and b/assets/images/pat-016.png differ diff --git a/assets/images/pat-018.png b/assets/images/pat-018.png new file mode 100644 index 0000000..83b01ea Binary files /dev/null and b/assets/images/pat-018.png differ diff --git a/assets/images/pat-019.png b/assets/images/pat-019.png new file mode 100644 index 0000000..8a0821a Binary files /dev/null and b/assets/images/pat-019.png differ diff --git a/assets/images/pat-020.png b/assets/images/pat-020.png new file mode 100644 index 0000000..f095230 Binary files /dev/null and b/assets/images/pat-020.png differ diff --git a/assets/images/pat-021.png b/assets/images/pat-021.png new file mode 100644 index 0000000..4ea0c4c Binary files /dev/null and b/assets/images/pat-021.png differ diff --git a/assets/images/pat-022.png b/assets/images/pat-022.png new file mode 100644 index 0000000..4ab3325 Binary files /dev/null and b/assets/images/pat-022.png differ diff --git a/assets/images/pat-023.png b/assets/images/pat-023.png new file mode 100644 index 0000000..77f2092 Binary files /dev/null and b/assets/images/pat-023.png differ diff --git a/assets/images/pat-024.png b/assets/images/pat-024.png new file mode 100644 index 0000000..fa2c67a Binary files /dev/null and b/assets/images/pat-024.png differ diff --git a/assets/images/pat-025.png b/assets/images/pat-025.png new file mode 100644 index 0000000..218fe55 Binary files /dev/null and b/assets/images/pat-025.png differ diff --git a/assets/images/pat-026.png b/assets/images/pat-026.png new file mode 100644 index 0000000..c747433 Binary files /dev/null and b/assets/images/pat-026.png differ diff --git a/assets/images/pat-027.png b/assets/images/pat-027.png new file mode 100644 index 0000000..99b1509 Binary files /dev/null and b/assets/images/pat-027.png differ diff --git a/assets/images/pat-028.png b/assets/images/pat-028.png new file mode 100644 index 0000000..b9164a8 Binary files /dev/null and b/assets/images/pat-028.png differ diff --git a/assets/images/pat-029.png b/assets/images/pat-029.png new file mode 100644 index 0000000..249a6a0 Binary files /dev/null and b/assets/images/pat-029.png differ diff --git a/assets/images/pat-030.png b/assets/images/pat-030.png new file mode 100644 index 0000000..9c5844e Binary files /dev/null and b/assets/images/pat-030.png differ