Blender : Add-on 取説 ～ KenJin Eye Look Driver ～ 黒目をCamera方向に自動的に動かす自作アドオン

Apply / Clear This Pupil

Apply Driver to Right Side Pupil

Right Side PupilにDriverを設定します。

以下を変更した場合は、再度Applyが必要です。

• Camera Object
• Pupil Object
• Reference Object
• Mode
• Forward Axis
• Invert X
• Invert Z

一方、Offset、Range、Sensitivity、Min、MaxはリアルタイムでPupilのCustom Propertyに反映されるため、通常は再Apply不要です。

Clear Driver from Right Side Pupil

Right Side PupilのLocation X/Zに設定されたDriverを削除します。

黒目の動きを一度リセットしたい場合に使います。

Copy Right Side Pupil Params to Left Side Pupil

Right Sideの黒目パラメータをLeft Sideへコピーします。

コピーされるのは、Offset、Range、Sensitivity、Min、MaxなどのPupilパラメータです。

Camera、Reference、Mode、Forward Axis、Invert設定はコピーされません。

Left Side Settingsの設定

Left Sideは、基本的に .L のPupilとReferenceを設定する場所です。

項目	指定するもの
Left Side Pupil Object	pupil.L
Left Side Reference Object	reference.L

Right Sideと同じ流れで設定します。

右側から自動設定された場合は、内容を確認してからApplyします。

基本操作の流れ

最小限の使い方は、以下の流れです。

1. pupil.R、pupil.L、reference.R、reference.L を用意する
2. Nメニューの KJ Mirror から KenJin Eye Look Driver を開く
3. CommonでCamera Objectを指定する
4. Right Side Pupil Objectに pupil.R を指定する
5. Right Side Reference Objectに reference.R を指定する
6. .L 側が自動設定されたか確認する
7. Right Side Modeを World Normalized にする
8. Right Side Forward Axisを +Y Forward にする
9. Apply Driver to Right Side Pupil を押す
10. Left Side側も同様にApplyする
11. Cameraを動かして黒目の動きを確認する
12. 動きが逆ならInvert XまたはInvert Zを調整する
13. 黒目の中心がずれていればBase X/Z Offsetを調整する
14. 黒目が動きすぎる場合はLive Limitsを狭める

推奨初期設定

まずは以下の設定から始めると分かりやすいです。

項目	Right Side	Left Side
Mode	World Normalized	World Normalized
Forward Axis	+Y Forward	+Y Forward
Invert X	OFF	OFF
Invert Z	OFF	OFF
X Range	0.030	0.030
Z Range	0.020	0.020
X Sensitivity	0.350	0.350
Z Sensitivity	0.350	0.350
X Min / Max	-0.030 / 0.030	-0.030 / 0.030
Z Min / Max	-0.020 / 0.020	-0.020 / 0.020

左右コピーの使い方

片側で黒目の動きを調整した後、反対側へ値をコピーできます。

右から左へコピー

Right Side側のApply / Clear欄にある次のボタンを使います。

Copy Right Side Pupil Params to Left Side Pupil

左から右へコピー

Left Side側のApply / Clear欄にある次のボタンを使います。

Copy Left Side Pupil Params to Right Side Pupil

Mirror X Offset on Copy がONの場合、Base X Offsetだけ左右反転されます。

左右対称の目ではONが自然です。

Last Apply Result / Warningsの見方

Apply後は、Last Apply Result / Warningsに結果が表示されます。

確認すべき項目は以下です。

表示	確認内容
Target Side	Right SideまたはLeft Sideが正しいか
Target Pupil	目的のPupilが指定されているか
Reference	目的のReferenceが指定されているか
Camera	正しいCameraが指定されているか
Mode	意図したModeになっているか
X initial / Z initial	初期位置がLimitに張り付いていないか

Warningが出た場合は、特に .R / .L の指定ミスを確認します。

よくあるトラブルと対処法

黒目が動かない

以下を確認します。

原因	対処
Applyしていない	Apply Driverを押す
Camera Objectが未指定	CommonでCameraを指定
Referenceが未指定	Reference Objectを指定
Pupilが未指定	Pupil Objectを指定
DriverをClearしたまま	再Applyする
RangeまたはSensitivityが0	値を上げる

左右が逆に動く

Invert X を切り替えます。

Cameraを右へ動かしたとき、黒目が左へ動く場合は Invert X をONにします。

上下が逆に動く

Invert Z を切り替えます。

Cameraを上へ動かしたとき、黒目が下へ動く場合は Invert Z をONにします。

黒目が目の外に出る

Live Limitsを狭くします。

例えば、以下のように小さくします。

項目	例
X Min	-0.020
X Max	0.020
Z Min	-0.015
Z Max	0.015

片側だけ動きが違う

左右のReferenceの向きが違う可能性があります。

以下を確認します。

• .R と .L のReferenceの位置
• Referenceのローカル軸
• Forward Axis
• Invert X / Z
• Offset / Range / Sensitivity
• Limit値

.Rを指定しても.Lが自動設定されない

以下を確認します。

原因	対処
反対側オブジェクトが存在しない	pupil.L などを作成
名前が一致していない	.R / .L の前後を同じにする
Right / Left という単語だけで命名している	.R / .L 形式にする
Blender上でオブジェクト名が .001 などでずれている	対応名をそろえる