Blender: add-on ～ KJ Eye Through Hair v0.3.6 取扱説明書 ～ アニメの表現でよくある髪の毛越しに目を浮き上がせる(投影)．

Internal Constants / Naming

NODE_GROUP_PREFIXはKJ_ETH_ViewDependentReveal_v021です。

RAY_TRIANGLE_KERNEL_GROUP_NAMEはKJ_ETH_RayTriangleKernel_v021です。

TARGET_SURFACE_GROUP_PREFIXはKJ_ETH_TargetSurface_v021です。

MASTER_UNION_TAGはkj_eth_master_union_v021です。

MASTER_TARGET_NODE_TAGはkj_eth_master_target_node_v021です。

WRAPPER_NODE_PREFIXはKJ_ETH_WRAPPERです。

OWNED_KEYはkj_eth_ownedです。

ORIGINAL_MATERIAL_KEYはkj_eth_original_materialです。

Demo CollectionはKJ_ETH_Demoです。

Demo TargetはKJ_ETH_Demo_CharacterSphereです。

Demo OccluderはKJ_ETH_Demo_HairCubeです。

Debug TextはKJ_ETH_DebugLogです。

Overlay Minimum Intervalは約1/30秒です。

Add Target後のPost Suspendは0.10秒です。

Broad-phase NDC Marginは0.05です。

Node Group Prefixのv021表記は単純Renameしないでください。

既存Runtime GroupとのMigrationへ影響する可能性があります。

Runtime Cache

主要Cacheは_TARGET_SIGNATURE_CACHE、_TARGET_OBJECT_MATRIX_CACHE、_TARGET_LOCAL_OVERLAY_CACHE、_OVERLAY_LAST_UPDATE、_TARGET_CULLED_UNITS、_BROADPHASE_VIEW_SIGNATURES、_BROADPHASE_VIEW_DIRTY、_DEFERRED_GEOMETRYです。

Load PostおよびUnregister時には適切にClearします。

新しいCacheを追加する場合はScene Scopeを基本とし、別Scene間でStateを混在させないようにします。

Error / Fallback Policy

Incremental処理に失敗した場合はFull refresh_runtime()へFallbackする経路を残します。

PerformanceのためにFallbackを削除してはいけません。

Correctnessを優先します。

Error LogにはTarget Object名、Vertex Group名など、原因特定に必要な情報を含めます。

Save / Load Behavior

Persistent User DataはScene PropertyGroupおよびCollectionPropertyとして.blendへ保存されます。

Runtime-only DiagnosticsはSKIP_SAVEとします。

Node GroupやMaterial WrapperはBlend Dataとして残る場合があります。

Load PostではRuntime CacheをClearし、その後の更新で再同期します。

Preset Save、User Library、Export機能はv0.3.6では確認できません。

Parameter Dependency Map

Enable Reveal Through HairはFinal Reveal Gateです。

Reveal ModeがTarget Vertex Groupsの場合、Target Object List、Target Vertex Group List、Projection Geometry、Occluder Listを使用します。

Projection Geometryが1-Vertex Group Surfaceの場合、Group Weight Threshold、Depth Margin、Outward Normal、Normal Thresholdが主Parameterです。

Projection Geometryが2-View Ray Radiusの場合、Projection RadiusとProjection Featherを使用します。

Reveal ModeがLegacy Regionsの場合、Region List、Superellipse Parameter、Face Exactを使用します。

Isolate Shared MaterialsはOccluder Material Ownershipを制御します。

EEVEE DitheredはMaterial Render StateのBackup / Restoreを制御します。

Transform Broad-phase CullingはTransform時のW2L Write抑制とPersistent CULLED Stateを制御します。