Files
Neutron/docs/rendering.md
T

2.7 KiB

Current Vulkan rendering and evidence

Original API and state maps: analysis/graphics.md. Mesh/material/texture formats: file-formats.md. Vulkan code: src/GamePort/Rendering/Vulkan/VulkanRenderer.cs.

Default prepared LV1B view uses the GAM STARTEXP camera; positive-Z projection uses recovered FOV 0xAAA/16384*360 degrees, near 20, far 10000. Generic engine far default is 3200; other scene-specific overrides remain to be mapped. Camera target offset (0,80,0) is recovered, but startup look-at and follow interpolation have not been dynamically compared. Vulkan viewport Y is handled in projection.

World OMT coordinates and per-corner UVs are unchanged. ASE conversion (x,z,y) and (u,-v) is verified using duplicate gate/yokianpart assets; no invented light is applied to Jimmy. The original normal texture is jimycarl.png (InitObject 0x422C96), while jimyshock.png is texture slot 1, a separate effect (0x422CA7). The normal atlas and scene/player captures have been visually inspected locally.

Null-material visibility correction

LV1B references material 18 from 45 draw ranges but that material does not exist in its original resource index. Names include phoneblock, blockfan and Box/Plane objects. Rendering them with white fallback surfaces incorrectly obscured the actual lab. Disassembly of OMT2.dll DX draw_shape at 0x1003756C loads the polygon material pointer, tests it at 0x1003756F, and jumps directly to polygon advance at 0x10037A7F when null. Therefore the modern scene loader retains this geometry but excludes unresolved-material draw ranges, matching the original render path. It does not assign collision semantics solely from names.

The original also tests in-memory polygon flag 4 (0x10037577). For v2 resources, the first serialized bool sets flag 2 at 0x10003F83 (DX disables culling for that bit at 0x10037731); the second bool sets flag 1 at 0x10003F9B. Other legacy fields and per-material pipeline states still need full mapping.

Animation preview

MorphAnimation reads prepared base topology/UV and sample vertex positions, with linear interpolation following DLL 0x10002F9A. It can append a player draw with independent texture to original scene geometry and updates the mapped coherent vertex buffer after synchronous frame completion. Source frame sample timing is used for preview. Loop closure, state selection, state-specific playback speed, normal interpolation, clothing variants and gameplay pose transforms remain unverified. This is not a complete animation/gameplay reconstruction.

GPU readback evidence: artifacts/test-level1b.ppm, artifacts/test-player.ppm, artifacts/jimmy-normal.ppm, artifacts/resize-input.ppm (generated/ignored). No original reference image equivalence or pixel-perfect claim is made.