diff --git a/docs/PORT-PLAN.md b/docs/PORT-PLAN.md index 704aec1a..1550b866 100644 --- a/docs/PORT-PLAN.md +++ b/docs/PORT-PLAN.md @@ -1044,3 +1044,40 @@ Outstanding: no Vulkan/Android device run or frame-time capture for this pass; `frames*0.033f` / `frames/60` animation clocks are frame-based rather than real time; translucent depth sorting uses each draw's first vertex. Original AVA2 data and the server are unchanged. + +### 2026-10-12 FPS pass 2 (SpeedTree untouched) + +SpeedTree (forest culling, SpeedTreeRT texture-path cache) is left alone while +the SDK side is still being optimized. Client commits 46880be5..b2c7c6ce, one per +item: + +- Cached map-object and terrain-patch draws are submitted by pointer + (`Render3DDrawRef` + `FlattenDraws`); no per-frame copies of cached commands. +- Map objects beyond the AVA2 loading distance are skipped, 1:1 with + `ENABLE_MAP_OBJECT_OPTIMIZATION` (`CArea::__UpdateLoadedObjectInstances`): + 2D distance from the main actor > max(`OBJECT_DIST`, 5000). The background + update now receives the player position instead of the camera eye, as + `CPythonApplication` does. Fog-far culling was rejected (it changes + silhouettes against the sky). +- Render scale < 1 no longer copies the scene through an extra full-screen + texture when the SDL_GPU pipeline is active; the scene target is composited + with linear filtering. +- HardwareScene skips redundant vertex/index/pipeline/sampler binds; the + opaque sort groups depth-writing opaque and alpha-tested draws by cull mode, + texture and geometry (blended and non-depth-writing draws stay back to front). +- Distant actors animate at the original reduced FPS + (`CGrannyLODController::UpdateLODLevel` + `CGrannyModelInstance::Update`): + only models with a `_lod_01.gr2` sibling, more than 500 units from the camera + target, 30-120 FPS by camera distance over 5000 (25000 for models of 500+ + units). The `_lod_` meshes are still not swapped in. + +GPU skinning limit reviewed, not changed: 36 of 3755 skinned models in pc*, +monster*, npc*, npc_mount and npc_pet exceed 128 bones (bosses, metin stones, +doors; max 314, no PC models) and fall back to CPU skinning. Raising the limit +needs shader rebuilds, exceeds Vulkan's 16 KB minimum uniform range and the +UBYTE4 bone index range. + +Verified: Debug macOS/Metal build, 50/50 CTests (new regressions for +`FlattenDraws`, scaled-scene compositing and LOD animation rate). Not verified: +in-game frame-time capture and 3D screenshots (no server in this session), and +any Vulkan/Android device run.