用語
Target Object
Revealによって見せる側のMesh Objectです。
Target Unit
Target Object + Target Vertex Groupの組み合わせです。
Target Vertex Group
Reveal対象Surfaceを指定するVertex Groupです。
Occluder
Targetより手前に存在し、Reveal透過処理を受けるMesh Objectです。
1-Vertex Group Surface
Vertex Groupに属する実評価Mesh Surfaceを使用する主Projection Modeです。
Broad-phase Culling
Exact判定の前に、現在のViewやOccluderへ影響しないTarget Unitを省略する処理です。
W2L
World-to-Localの略です。
World SpaceのRay情報をTarget Local Spaceへ変換します。
Reveal Wrapper
Occluderの既存Material Shaderを置き換えず、その出力にReveal処理を追加するNode構造です。
WordPress設定用情報
SEO Title：KJ Eye Through Hair v0.3.6 取扱説明書｜Blender 5.1/5.2 Target Vertex Group透過Add-on
Meta Description：Blender 5.1/5.2対応のKJ Eye Through Hair v0.3.6について、Target Object、Vertex Group、複数Occluder、実Mesh Surface投影、Broad-phase Culling、Material設定、Demo、Troubleshootingまで解説します。
Slug：kj-eye-through-hair-v036-manual
Focus Keyword：KJ Eye Through Hair
Related Keywords：Blender Add-on、Vertex Group、Occluder、透過、Shader、Broad-phase Culling、Blender 5.1、Blender 5.2
KJ Eye Through Hair v0.3.6 継続開発用技術資料
Documentation Version：v1.0
Add-on Version：v0.3.6
用途：継続開発、Debug、Migration、Performance改善
基準日：2026年9月13日
公開区分：INTERNAL
本資料の目的
本資料は、KJ Eye Through Hairを今後継続開発する際に、過去の設計判断、Performance改善の経緯、Runtime構造、Target ObjectとTarget Vertex Groupの所有関係、Material処理、Broad-phase Cullingなどを再解析せずに引き継げるようにするための技術資料です。
実装事実については、v0.3.6のAdd-on Codeを最優先情報とします。
READMEや過去のCHANGELOGに古い仕様が残っている場合は、現行Codeを優先します。
特に、過去READMEの「One Target Object」という表現は現行仕様と一致しません。
v0.3.6では複数Target Objectと複数Target Vertex Groupを実装しています。
Version / Runtime Policy
bl_info.version：0.3.6
ADDON_VERSION：0.3.6
manifest version：0.3.6
manifest schema：1.0.0
Extension ID：kj_eye_through_hair
Minimum Blender：5.1.0
Target Blender：5.1 / 5.2
Runtime Verified Set：未登録
N-menu：KJ Eye Through Hair
Category：3D View
Blender 5.1未満はUnsupportedです。
Blender 5.1 / 5.2はTarget Versionですが、Verified Setが空のためTARGET_UNVERIFIEDとして扱います。
新しい未確認VersionはFUTURE_UNVERIFIEDとして扱います。
開発上の不変条件
Target Unitは必ず「Target Object + Target Vertex Group」で識別します。
同名Vertex Groupが別Objectに存在しても混同しません。
Target ObjectをOFFにしてもChild Group登録を削除しません。
Target Vertex GroupをOFFにしても登録を削除しません。
新しくTarget Objectだけを登録してGroupが0件の場合でも、既存Target Maskを無効化してはいけません。
Final Maskは有効なTarget Unit MaskのMAX unionです。
1-Vertex Group Surfaceは実際の評価済みMesh Surfaceを使用します。
円や楕円などのproxyへ置き換えてはいけません。
Surface採用判定はsource polygon単位で行います。
Quadの片側Triangleだけが残るhalf-polygon artifactを再発させてはいけません。
Pure Object TransformではTriangle座標を再解析せず、World-to-Localのみを更新します。
Shape Key、Armature、Modifier、Mesh変形はEvaluated Meshを反映します。
同一Objectに複数Target Groupがある場合、Evaluated Mesh snapshotはObject単位で共有します。
Add Target Vertex Groupでは既存Target Surfaceを全再構築しません。
Broad-phase CullingはExact結果を近似するものではなく、Exact判定の前段Filterだけに使用します。
Render開始前にはCull状態を正確なRuntime Stateへ同期します。
Occluderの元Shaderは置換せず、Reveal Wrapperで包みます。
Shared Material IsolationおよびDithered設定は可逆Live Toggleとして維持します。
Legacy Regionsは互換機能として保持します。
コメントを残す