インストール方法
- アドオンコードを以下のような名前で保存します。
kenjin_eye_look_driver_v1_4_0.py
- Blender 5.1を開きます。
- 以下の順に進みます。
Edit
> Preferences
> Add-ons
> Install from Disk
- 保存した
.pyファイルを選択します。 - Add-on一覧で KenJin Eye Look Driver を有効化します。
- 3D Viewportで
Nキーを押し、右側サイドバーの Eye Driver タブを開きます。
Nメニュータブ名は Eye Driver です。
Nパネルの項目
Common
| 項目 | 内容 |
|---|---|
| Camera Object | 黒目が追随する対象。通常はCamera |
Left Eye / Right Eye
左目と右目は独立して設定できます。
Object設定
| 項目 | 内容 |
|---|---|
| Left / Right Pupil Object | 黒目Object |
| Left / Right Reference Object | 目の基準Object |
| Set Selected as Pupil | 現在選択中ObjectをPupilとして登録 |
| Set Selected as Reference | 現在選択中ObjectをReferenceとして登録 |
| Load Values From Pupil | Pupil Objectに保存済みの値をNパネルへ読み込み |
| Repair Properties | Pupil Objectに不足しているCustom Propertyをdefault値で再作成 |
Driver Structure
| 項目 | 内容 |
|---|---|
| Mode | 方向計算方式 |
| Forward Axis | 目の正面方向 |
| Invert X | 左右が逆に動く場合にON |
| Invert Z | 上下が逆に動く場合にON |
Modeの選び方
| Mode | 内容 | 向いている場面 |
|---|---|---|
| World Normalized | World座標のCamera-Reference方向を正規化して使用 | 顔やReferenceが大きく回転しない場合 |
| Reference Z Normalized | Reference ObjectのZ回転だけ補正 | 人体や頭部が主に左右方向へ回る場合 |
注意点として、Reference Z Normalized はReference ObjectのZ回転のみを補正します。頭部がX/Y/Zに複合的に大きく傾く場合は、完全なlocal変換ではありません。
Forward Axis
| 設定 | 意味 |
|---|---|
| +Y Forward | Reference Objectのlocal +Yを目の正面とみなす |
| -Y Forward | local -Yを目の正面とみなす |
| +X Forward | local +Xを目の正面とみなす |
| -X Forward | local -Xを目の正面とみなす |
多くの場合、最初は +Y Forward または -Y Forward を試します。
Live Center / Offset
v1.4.0の重要機能です。
黒目の中心位置を、Nパネルからリアルタイムに調整できます。
| 項目 | 内容 |
|---|---|
| Base X Offset | 黒目の中心となるLocation X |
| Base Z Offset | 黒目の中心となるLocation Z |
| Set Current as Offset | 現在のPupil Location X/ZをOffsetとして保存 |
| Reset Offset | Offsetを0に戻す |
Offsetの考え方
最終的な黒目の位置は、次のように計算されます。
Location X = Base X Offset + Camera方向によるX移動
Location Z = Base Z Offset + Camera方向によるZ移動
これにより、黒目の中心位置を0固定ではなく、白目スクリーン上の任意の位置にできます。
Live Movement
黒目の移動量と反応の強さを設定します。
| 項目 | 内容 |
|---|---|
| X Range | 左右方向の最大移動幅 |
| Z Range | 上下方向の最大移動幅 |
| X Sensitivity | 左右方向の反応倍率 |
| Z Sensitivity | 上下方向の反応倍率 |
推奨初期値
| 項目 | 推奨値 |
|---|---|
| X Range | 0.030 |
| Z Range | 0.020 |
| X Sensitivity | 0.350 |
| Z Sensitivity | 0.350 |
黒目の動きが大きすぎる場合は、Sensitivityを下げます。
動きが小さすぎる場合は、Sensitivityを上げます。
Live Limits Relative to Offset
Offsetを中心とした移動制限です。
| 項目 | 内容 |
|---|---|
| X Min | Base X Offsetから見た左方向の限界 |
| X Max | Base X Offsetから見た右方向の限界 |
| Z Min | Base Z Offsetから見た下方向の限界 |
| Z Max | Base Z Offsetから見た上方向の限界 |
例
Base X Offset = 0.010
X Min = -0.030
X Max = 0.030
この場合、実際のLocation Xの範囲は次です。
-0.020 ~ 0.040
Min/Maxは絶対座標ではなく、Offsetから見た相対範囲として扱います。
Applyボタン
Apply Left Eye Driver
左目の設定が揃っている場合だけ、左目Pupil Objectにdriverを設定します。
Apply Right Eye Driver
右目の設定が揃っている場合だけ、右目Pupil Objectにdriverを設定します。
Apply Available Eye Drivers
左右のうち、設定が揃っている側だけdriverを設定します。
例えば右目だけ設定されている場合は、右目だけApplyされ、左目はスキップされます。
Right Eye: Applied
Left Eye: Skipped - Left Eye Pupil Object is not set.


コメントを残す