Blender : Add-on取説 ～ KJ Shape Key Current Value Tools ～ 現在の全Shape Key状態を1つのshape keyに詰め込む

概要

KJ Shape Key Current Value Tools (Add-on)は、現在のShape Key状態を新しくに作ったshape keyに詰め込むAdd-onです。

Blender標準のShape Key操作では、選択Shape KeyをBasis化したり、Basisへ反映したりできますが、Value=1.0以外の状態を反映することはできません．そこで，どのような状態のshape (0<Value <1.0)であっても1つのshape keyに収める(下表No.3の機能)ためのAdd-onです。

このAdd-onでは、次のような処理ができます。

No.	機能	内容
1	選択Shape Keyの現在Valueを新規Shape Key化	Value=0.3や0.6など、現在値の形を新しいShape Key(自動生成)にする
2	選択Shape Keyの現在ValueをBasisへ反映	Value=1.0ではなく、現在Value分だけBasisへ焼き込む
3	全Shape Keyの現在状態を1つに統合	複数Shape Keyの現在Valueを1つの新しいShape Keyに押し込める
4	元Valueの記録(補助機能)	統合前に、どのShape KeyがどのValueだったか記録する
5	元Valueの復元(補助機能)	統合後でも、元のShape Key Value状態へ戻して再調整できる

Blender公式マニュアルでは、Shape Keyはオブジェクトを別形状へ変形するための機能であり、Morph TargetやBlend Shapeとも呼ばれると説明されています。また、BasisはShape Keyの基準形状として扱われます。

---

対応環境

項目	内容
Add-on名	KJ Shape Key Current Value Tools
バージョン	v0.1.2
作者	KenJin
対応想定	Blender 5.1
対象	Mesh Object
表示場所	3D Viewport > N Menu > KJ Shape

---

インストール方法

1. Blenderを起動します。
2. 上部メニューから Edit > Preferences を開きます。
3. Add-ons を選択します。
4. 右上の Install を押します。
5. kj_shape_key_current_value_tools.py を選択します。
6. Add-on一覧で KJ Shape Key Current Value Tools にチェックを入れます。
7. 3D Viewportで Nキー を押します。
8. サイドバーに KJ Shape タブが表示されれば準備完了です。

---

基本的な考え方

通常のShape Key

Shape Keyは、Basisを基準として別の形状を記録する仕組みです。

例：

Shape Key(名)	内容
Basis	通常の顔
Smile	笑顔
Blink	まばたき
Eye_Adjust	目の補正

各Shape KeyにはValueがあります。

Smile = 0.40
Blink = 0.25
Eye_Adjust = 0.60

この場合、画面に表示される形は、これらのShape Keyが現在Valueで合成された状態です。

---

このAdd-onでできること

1. Active Current Value -> New Shape Key (No.1機能)

選択中のShape Keyの現在Value状態を、新しいShape Keyとして保存します。

たとえば、Smile のValueが 0.40 のときに実行すると、Smileの40%分だけ変形した形が新しいShape Keyになります。

使用例

操作前	内容
Active Shape Key	Smile
Smile Value	0.40

実行後、新しいShape Keyとして Current_Value などが作成されます。

この新しいShape Keyは、Smileの100%変形ではなく、Smile 0.40相当の形です。

使いどころ

• 変形が強すぎるShape Keyから中間形状を作りたい場合
• Value=1.0ではなく、現在表示されている程度の変形を保存したい場合
• 顔の表情、まぶた、口、黒目位置などの中間状態をShape Key化したい場合

---

2. Active Current Value -> Basis / Keep Residual (No.2機能)

選択中Shape Keyの現在Value分をBasisへ反映します。
ただし、元のShape Keyは削除せず残します。

使用例

操作前	内容
Active Shape Key	Eye_Adjust
Eye_Adjust Value	0.60

この状態で実行すると、Eye_Adjustの60%分だけBasisへ反映されます。
その後、Eye_Adjust自体は残ります。

使いどころ

• 基本形状を少しだけ補正したい場合
• ただし、元Shape Keyは削除せず後で再調整したい場合
• 作業の安全性を優先したい場合

---

3. Active Current Value -> Basis / Delete Active (補助機能)

選択中Shape Keyの現在Value分をBasisへ反映し、そのShape Keyを削除します。

使用例

操作前	内容
Active Shape Key	Face_Correction
Face_Correction Value	0.50

実行すると、Face_Correctionの50%分がBasisへ反映され、Face_Correctionは削除されます。

使いどころ

• 補正用Shape Keyを恒久的にBasisへ取り込みたい場合
• そのShape Keyをもうスライダーとして使わない場合

注意

削除すると元に戻しにくくなるため、通常は先に Keep Residual を使う方が安全です。

---

4. Current Mix -> New Shape Key (No.3機能)

現在の全Shape Key Valueの合成状態を、新しいShape Keyとして作成します。

ただし、この機能では元Shape KeyのValueはリセットしません(表示は合成させることになる)。
そのため、新しく作ったShape KeyをValue=1.0にすると、元のShape Keyと重なって二重変形になる。

使いどころ

• 現在の見た目だけを新しいShape Keyとして保存したい場合
• 元のShape Key Valueはそのまま残したい場合

---

5. Pack All Current Values -> New Shape Key (No.3機能)

このAdd-onの中心機能です。

現在存在する全Shape KeyのValue状態を、1つの新しいShape Keyに統合します。
同時に、元になったShape Key名とValueを記録します。

例

操作前：

Shape Key	Value
Smile	0.40
Blink	0.25
Eye_Adjust	0.60
Mouth_Correction	0.30

この状態で Pack All Current Values -> New Shape Key を押すと、これら全ての現在状態が Packed_Current_All などの新しいShape Keyに統合されます。

推奨設定では、実行後は次のようになります。

Shape Key	Value
Smile	0.00
Blink	0.00
Eye_Adjust	0.00
Mouth_Correction	0.00
Packed_Current_All	1.00

この状態でも、見た目はPack前と同じになります。
つまり、複数Shape Keyの現在状態を、1つのShape Keyだけで再現できます。

---