From 281418f351cb31856492dc7fbbcb7f3570ee33b8 Mon Sep 17 00:00:00 2001 From: shen <> Date: Sun, 11 Oct 2026 17:55:53 -0700 Subject: [PATCH] Fix cross-platform rendering and optimize frame performance Correct selection orientation, game-entry lifecycle, mounted NPCs, labels and skill panels. Add the native GPU scene path, resident geometry, bounded texture and Python caches, and collision broad phase. Pin the independently maintained Metin2 SDK through a submodule and document reproducible setup. Include rendering regressions and macOS packaging improvements. Validation: client Debug build and 12 targeted client tests passed; SDK build and all 14 SDK tests passed. --- .gitmodules | 3 + CMakeLists.txt | 49 +- README.md | 6 + docs/GAME-RENDER-INVESTIGATION.md | 123 +++ docs/PERFORMANCE-AUDIT-2026-10-11.md | 176 ++++ docs/PORT-PLAN.md | 121 +++ docs/SELECT-RENDER-INVESTIGATION.md | 40 + runtime/login_view.py | 16 +- sdk | 1 + src/eter_effect/EffectInstance.cpp | 33 +- src/eter_image/GrpExpandedImageInstance.h | 1 + src/eter_image/GrpImageInstance.h | 1 + src/eter_image/MarkManager.cpp | 2 +- src/eter_net/NetworkActorManager.cpp | 66 +- src/eter_net/NetworkActorManager.h | 5 +- src/eter_net/Packet.h | 1 + src/eter_net/PythonNetworkStream.cpp | 28 + src/eter_net/PythonNetworkStream.h | 7 + .../PythonNetworkStreamPhaseGameRecv.cpp | 18 +- src/eter_render/ActorInstance.cpp | 55 +- src/eter_render/ActorInstance.h | 6 +- src/eter_render/EnvironmentData.cpp | 4 +- src/eter_render/Gr2ModelRenderer.cpp | 833 ++++++------------ src/eter_render/Gr2ModelRenderer.h | 60 +- src/eter_render/HardwareScene.cpp | 298 +++++++ src/eter_render/HardwareScene.h | 84 ++ src/eter_render/MapObjectManager.cpp | 83 +- src/eter_render/MapObjectManager.h | 15 +- src/eter_render/OrbitCamera.cpp | 8 +- src/eter_render/OrbitCamera.h | 4 +- src/eter_render/RaceData.cpp | 15 + src/eter_render/RenderCommands3D.h | 45 +- src/eter_render/SkyBox.cpp | 182 +--- src/eter_render/SpeedTreeRT.cpp | 697 ++------------- src/eter_render/SpeedTreeRT.h | 69 +- src/eter_render/TerrainHeightmap.cpp | 60 +- src/eter_render/TerrainHeightmap.h | 4 + src/eter_render/TextTailManager.cpp | 33 +- src/eter_render/TextTailManager.h | 16 +- src/eter_render/shaders/SceneSpirv.h | 673 ++++++++++++++ src/eter_render/shaders/scene.frag | 7 + src/eter_render/shaders/scene.vert | 50 ++ src/eter_resource/ResourceManager.h | 8 +- src/eter_sound/SoundManager.cpp | 10 +- src/eter_ui/Font.cpp | 192 ++++ src/eter_ui/Font.h | 11 + src/eter_ui/PythonWindow.cpp | 184 +++- src/eter_ui/PythonWindow.h | 11 +- src/eter_ui/PythonWindowManager.cpp | 144 ++- src/eter_ui/PythonWindowManager.h | 9 + src/login_client.cpp | 13 +- src/login_client.h | 1 + src/login_session.cpp | 19 +- src/login_session.h | 11 + src/main.cpp | 681 +++++++++++--- src/player_settings.cpp | 26 + src/player_settings.h | 2 + src/python_app.cpp | 93 +- src/python_app.h | 5 + src/python_background.cpp | 163 +++- src/python_chr.cpp | 83 +- src/python_gameplay_modules.cpp | 65 +- src/python_gameplay_modules.h | 8 + src/python_grp.cpp | 31 +- src/python_ime.cpp | 143 ++- src/python_ime.h | 10 + src/python_minimap.cpp | 52 ++ src/python_minimap.h | 6 +- src/python_native_modules.cpp | 17 + src/python_net.cpp | 42 +- src/python_runtime.cpp | 70 +- src/python_runtime.h | 9 + src/python_system.cpp | 1 + support/mac/AppIcon.icns | Bin 0 -> 3055434 bytes tests/ava2_render_3d_test.cpp | 218 ++++- tests/ava2_window_tree_test.cpp | 33 +- tests/background_test.cpp | 6 + tests/chr_test.cpp | 20 + tests/environment_skybox_test.cpp | 10 + tests/game_entry_test.cpp | 58 ++ tests/game_scene_test.cpp | 109 +++ tests/hardware_scene_test.cpp | 193 ++++ tests/login_oracle_test.cpp | 6 + tests/pack_assets_test.py | 45 + tests/pack_mount_test.cpp | 34 + tests/player_panel_test.cpp | 213 +++++ tests/select_render_test.cpp | 154 ++++ tools/bundle_macos_libraries.py | 42 + tools/compile_scene_shaders.py | 18 + tools/pack_assets.py | 135 +-- tools/package_macos.sh | 75 +- upstream/python-root/interfacemodule.py | 6 + upstream/python-root/intrologin.py | 93 +- .../python-root/locale/en/jobdesc_warrior.txt | 7 +- .../locale/en/ui/selectcharacterwindow.py | 2 +- upstream/python-root/serverinfo.py | 4 +- upstream/python-root/ui.py | 2 +- upstream/python-root/ui_mobile_combat.py | 90 ++ upstream/python-root/ui_mobile_drawer.py | 109 +++ upstream/python-root/ui_mobile_hud.py | 220 +++++ upstream/python-root/ui_mobile_joystick.py | 101 +++ 101 files changed, 6244 insertions(+), 1877 deletions(-) create mode 100644 .gitmodules create mode 100644 docs/GAME-RENDER-INVESTIGATION.md create mode 100644 docs/PERFORMANCE-AUDIT-2026-10-11.md create mode 100644 docs/SELECT-RENDER-INVESTIGATION.md create mode 160000 sdk create mode 100644 src/eter_render/HardwareScene.cpp create mode 100644 src/eter_render/HardwareScene.h create mode 100644 src/eter_render/shaders/SceneSpirv.h create mode 100644 src/eter_render/shaders/scene.frag create mode 100644 src/eter_render/shaders/scene.vert create mode 100644 src/eter_ui/Font.cpp create mode 100644 src/eter_ui/Font.h create mode 100644 support/mac/AppIcon.icns create mode 100644 tests/game_entry_test.cpp create mode 100644 tests/game_scene_test.cpp create mode 100644 tests/hardware_scene_test.cpp create mode 100644 tests/pack_assets_test.py create mode 100644 tests/pack_mount_test.cpp create mode 100644 tests/player_panel_test.cpp create mode 100644 tests/select_render_test.cpp create mode 100644 tools/bundle_macos_libraries.py create mode 100644 tools/compile_scene_shaders.py create mode 100644 upstream/python-root/ui_mobile_combat.py create mode 100644 upstream/python-root/ui_mobile_drawer.py create mode 100644 upstream/python-root/ui_mobile_hud.py create mode 100644 upstream/python-root/ui_mobile_joystick.py diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 00000000..d5bbece3 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "sdk"] + path = sdk + url = http://192.168.21.200:8418/4v5u09Z5a4Yuc/metin2-SDK.git diff --git a/CMakeLists.txt b/CMakeLists.txt index 7cc96ef3..4d04dcac 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -4,7 +4,13 @@ set(CMAKE_CXX_STANDARD 20) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_POSITION_INDEPENDENT_CODE ON) include(CTest) -add_subdirectory(shared/gr2) +set(AVA2_SDK_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/sdk" CACHE PATH "Metin2 SDK source directory") +if(NOT EXISTS "${AVA2_SDK_ROOT}/gr2/CMakeLists.txt" OR + NOT EXISTS "${AVA2_SDK_ROOT}/speedtree/CMakeLists.txt") + message(FATAL_ERROR "SDK missing. Run git submodule update --init --recursive or set AVA2_SDK_ROOT.") +endif() +add_subdirectory("${AVA2_SDK_ROOT}/speedtree" ${CMAKE_CURRENT_BINARY_DIR}/sdk_speedtree) +add_subdirectory("${AVA2_SDK_ROOT}/gr2" ${CMAKE_CURRENT_BINARY_DIR}/sdk_gr2) add_subdirectory(shared/codepage) option(AVA2_BUILD_HOST "Build SDL3 cross-platform host" ON) add_library(ava2_poly third_party/ava2-poly/Poly.cpp third_party/ava2-poly/Base.cpp third_party/ava2-poly/Symbol.cpp third_party/ava2-poly/SymTable.cpp) @@ -21,9 +27,9 @@ find_package(SDL3 CONFIG REQUIRED) add_library(ava2_transport src/login_client.cpp) target_include_directories(ava2_transport PUBLIC src) target_link_libraries(ava2_transport PUBLIC ava2_protocol Threads::Threads) -add_library(ava2_render src/eter_render/Gr2ModelRenderer.cpp src/eter_render/TerrainHeightmap.cpp src/eter_render/MapObjectManager.cpp src/eter_render/WaterManager.cpp src/eter_render/OrbitCamera.cpp src/eter_render/MinimapManager.cpp src/eter_render/ActorInstance.cpp src/eter_render/RaceData.cpp src/eter_render/FloatingTextManager.cpp src/eter_render/TargetManager.cpp src/eter_render/TextTailManager.cpp src/eter_sound/SoundManager.cpp src/eter_resource/dxt.cpp src/eter_effect/EffectData.cpp src/eter_effect/EffectInstance.cpp src/eter_effect/FlyTrace.cpp src/eter_effect/FlyingManager.cpp src/eter_effect/EffectManager.cpp src/eter_net/NetworkActorManager.cpp src/eter_render/EnvironmentData.cpp src/eter_render/SkyBox.cpp src/eter_render/SpeedTreeRT.cpp src/eter_render/SpeedTreeForest.cpp src/eter_image/MarkManager.cpp src/eter_render/CRenderTarget.cpp shared/common/CRC32.cpp src/eter_image/GrpImageInstance.cpp src/eter_image/GrpDevice.cpp src/eter_resource/texture_decode.cpp) +add_library(ava2_render src/eter_render/HardwareScene.cpp src/eter_render/Gr2ModelRenderer.cpp src/eter_render/TerrainHeightmap.cpp src/eter_render/MapObjectManager.cpp src/eter_render/WaterManager.cpp src/eter_render/OrbitCamera.cpp src/eter_render/MinimapManager.cpp src/eter_render/ActorInstance.cpp src/eter_render/RaceData.cpp src/eter_render/FloatingTextManager.cpp src/eter_render/TargetManager.cpp src/eter_render/TextTailManager.cpp src/eter_sound/SoundManager.cpp src/eter_resource/dxt.cpp src/eter_effect/EffectData.cpp src/eter_effect/EffectInstance.cpp src/eter_effect/FlyTrace.cpp src/eter_effect/FlyingManager.cpp src/eter_effect/EffectManager.cpp src/eter_net/NetworkActorManager.cpp src/eter_render/EnvironmentData.cpp src/eter_render/SkyBox.cpp src/eter_render/SpeedTreeRT.cpp src/eter_render/SpeedTreeForest.cpp src/eter_image/MarkManager.cpp src/eter_render/CRenderTarget.cpp shared/common/CRC32.cpp src/eter_image/GrpImageInstance.cpp src/eter_image/GrpDevice.cpp src/eter_resource/texture_decode.cpp) target_include_directories(ava2_render PUBLIC src ${CMAKE_CURRENT_SOURCE_DIR} third_party/extern_include) -target_link_libraries(ava2_render PUBLIC libgr2 SDL3::SDL3) +target_link_libraries(ava2_render PUBLIC libgr2 libgr2_render speedtree SDL3::SDL3) option(AVA2_EMBED_PYTHON "Build embedded Python 2.7 runtime" ON) if(AVA2_EMBED_PYTHON) add_subdirectory(third_party/cpython-2.7.18) @@ -33,6 +39,12 @@ if(AVA2_EMBED_PYTHON) add_library(ava2_python src/python_background.cpp src/python_pet_skill.cpp src/item_sound.cpp src/python_offline_shop.cpp src/python_switchbot.cpp src/python_dungeon_info.cpp src/python_drop_item.cpp src/python_battlepass.cpp src/python_guild.cpp src/python_shop_search.cpp src/python_cube_renewal.cpp src/python_messenger.cpp src/python_quest.cpp src/nonplayer_data.cpp src/python_wiki.cpp src/python_runtime.cpp src/python_net.cpp src/python_dbg.cpp src/python_system.cpp src/python_minimap.cpp src/python_chr.cpp src/python_app.cpp src/player_settings.cpp src/python_wndmgr.cpp src/python_gameplay_modules.cpp src/python_ime.cpp src/python_grp.cpp src/python_native_modules.cpp src/python_event_manager.cpp src/python_chat.cpp src/eter_lib/parser.cpp src/eter_base/Random.cpp src/eter_base/Timer.cpp src/game_type.cpp src/eter_ui/PythonWindow.cpp src/eter_ui/PythonWindowManager.cpp src/eter_net/PythonNetworkStream.cpp src/eter_net/PythonNetworkStreamCommand.cpp src/eter_net/PythonNetworkStreamPhaseGameRecv.cpp src/eter_net/PythonExchange.cpp src/eter_net/PythonSafeBox.cpp) target_include_directories(ava2_python PUBLIC src ${CMAKE_CURRENT_SOURCE_DIR} third_party/extern_include) target_link_libraries(ava2_python PUBLIC SDL3::SDL3 mtpython ava2_render PRIVATE mt_codepage ava2_transport ava2_lzo ava2_poly) + target_sources(ava2_python PRIVATE src/eter_ui/Font.cpp) + find_package(Freetype QUIET) + if(Freetype_FOUND) + target_link_libraries(ava2_python PRIVATE Freetype::Freetype) + target_compile_definitions(ava2_python PRIVATE AVA2_HAS_FREETYPE=1) + endif() endif() if(NOT WIN32 AND NOT ANDROID) add_executable(ava2_login src/login_cli.cpp) @@ -46,6 +58,16 @@ if(BUILD_TESTING AND NOT ANDROID) set(AVA2_TEST_RUNDIR "${CMAKE_BINARY_DIR}/test-rundir" CACHE PATH "Run directory from tools/make_test_rundir.py") if(AVA2_EMBED_PYTHON) find_package(Python3 COMPONENTS Interpreter REQUIRED) + add_executable(pack_mount_test tests/pack_mount_test.cpp) + target_link_libraries(pack_mount_test PRIVATE ava2_python) + add_dependencies(pack_mount_test mtpython_stdlib) + add_test(NAME ava2.pack_mount COMMAND "${Python3_EXECUTABLE}" "${CMAKE_SOURCE_DIR}/tests/check_completion.py" + "AVA2 bundle pack mount and NPC appearance passed" "$" "${MT_PYTHON_STDLIB_ZIP}") + add_executable(player_panel_test tests/player_panel_test.cpp) + target_link_libraries(player_panel_test PRIVATE ava2_python) + add_dependencies(player_panel_test mtpython_stdlib) + add_test(NAME ava2.player_panel COMMAND "${Python3_EXECUTABLE}" "${CMAKE_SOURCE_DIR}/tests/check_completion.py" + "AVA2 skill slot, received level and derived status parity passed" "$" "${MT_PYTHON_STDLIB_ZIP}" "${CMAKE_SOURCE_DIR}/upstream/python-root") add_executable(python_test tests/python_test.cpp) target_link_libraries(python_test PRIVATE ava2_python ava2_lzo ava2_protocol) add_dependencies(python_test mtpython_stdlib) @@ -127,6 +149,21 @@ if(BUILD_TESTING AND NOT ANDROID) target_link_libraries(ava2_window_tree_test PRIVATE ava2_python mtpython) add_dependencies(ava2_window_tree_test mtpython_stdlib) add_test(NAME ava2.window_tree COMMAND ava2_window_tree_test "${MT_PYTHON_STDLIB_ZIP}" "${CMAKE_SOURCE_DIR}/upstream/python-root") + add_executable(select_render_test tests/select_render_test.cpp) + target_link_libraries(select_render_test PRIVATE ava2_python) + add_dependencies(select_render_test mtpython_stdlib) + add_test(NAME ava2.select_render COMMAND select_render_test "${MT_PYTHON_STDLIB_ZIP}" "${CMAKE_SOURCE_DIR}/upstream/python-root") + set_tests_properties(ava2.select_render PROPERTIES ENVIRONMENT "AVA2_TEST_RUNDIR=${AVA2_TEST_RUNDIR}" SKIP_RETURN_CODE 77) + add_executable(game_entry_test tests/game_entry_test.cpp) + add_executable(game_scene_test tests/game_scene_test.cpp) + target_link_libraries(game_scene_test PRIVATE ava2_render) + add_test(NAME ava2.game_scene COMMAND game_scene_test) + target_link_libraries(game_entry_test PRIVATE ava2_python) + add_dependencies(game_entry_test mtpython_stdlib) + add_test(NAME ava2.game_entry COMMAND "${Python3_EXECUTABLE}" "${CMAKE_SOURCE_DIR}/tests/check_completion.py" + "Original GameWindow, inventory, taskbar and minimap created successfully" "$" "${MT_PYTHON_STDLIB_ZIP}" "${CMAKE_SOURCE_DIR}/upstream/python-root") + set_tests_properties(ava2.game_entry PROPERTIES ENVIRONMENT "AVA2_TEST_RUNDIR=${AVA2_TEST_RUNDIR}" SKIP_RETURN_CODE 77) + add_test(NAME ava2.pack_assets COMMAND "${Python3_EXECUTABLE}" "${CMAKE_SOURCE_DIR}/tests/pack_assets_test.py") endif() add_executable(server_clock_test tests/server_clock_test.cpp) @@ -138,6 +175,12 @@ if(BUILD_TESTING AND NOT ANDROID) add_executable(ava2_render_3d_test tests/ava2_render_3d_test.cpp) target_link_libraries(ava2_render_3d_test PRIVATE ava2_render) add_test(NAME ava2.render_3d COMMAND ava2_render_3d_test "ymir work/pc/warrior/warrior_assasin1.gr2") + if(AVA2_EMBED_PYTHON) + add_executable(hardware_scene_test tests/hardware_scene_test.cpp) + target_link_libraries(hardware_scene_test PRIVATE ava2_python) + add_test(NAME ava2.hardware_scene COMMAND hardware_scene_test) + set_tests_properties(ava2.hardware_scene PROPERTIES SKIP_RETURN_CODE 77) + endif() add_executable(environment_skybox_test tests/environment_skybox_test.cpp) target_link_libraries(environment_skybox_test PRIVATE ava2_render) add_test(NAME ava2.environment_skybox COMMAND environment_skybox_test) diff --git a/README.md b/README.md index 71ea7841..a313843b 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,7 @@ Independent AVA2 port, Android arm64 first with macOS arm64 for development. The host, login/selection transport, supported loading/game socket bridge and Python 2 bootstrap are implemented. It is not yet a playable client. ```sh +git submodule update --init --recursive cmake -S . -B build/dev -DCMAKE_BUILD_TYPE=Debug cmake --build build/dev -j 8 ctest --test-dir build/dev --output-on-failure @@ -19,3 +20,8 @@ Android CMake builds require the NDK toolchain and an Android SDL3 SDK prefix. T See [port status](docs/PORT-PLAN.md), [login implementation and verification](docs/LOGIN-TRANSPORT.md), and [active login profile](docs/LOGIN-PROFILE.json). Windows equivalence is tracked in [the parity audit](docs/WINDOWS-PARITY.md). Preview characters require `--preview-data`; game previews do not prove server gameplay. The static [placeholder inventory](docs/WINDOWS-PARITY-INVENTORY.json) is regenerated with `python3 tools/audit_windows_parity.py`. + +The SDK is maintained in its own Git repository and pinned by the `sdk` submodule. +Clone with `git clone --recurse-submodules`, or run the initialization command above +before configuring. To develop against an existing SDK checkout, configure with +`-DAVA2_SDK_ROOT=/absolute/path/to/sdk`; normal builds use the pinned submodule. diff --git a/docs/GAME-RENDER-INVESTIGATION.md b/docs/GAME-RENDER-INVESTIGATION.md new file mode 100644 index 00000000..5e2a13e5 --- /dev/null +++ b/docs/GAME-RENDER-INVESTIGATION.md @@ -0,0 +1,123 @@ +# 进入游戏后只剩深色背景和残缺面板 + +调查日期:2026-10-10。对应用户 22:59:30 跨平台截图和 22:58:05 Windows 截图。 + +## 已复现的初始化阻塞 + +在当前 `dist/AVA2.app/Contents/MacOS` 工作目录运行发布包的同一个可执行文件,使用原版游戏阶段和模拟角色数据,游戏界面创建过程中报错: + +```text +InventoryWindow.LoadWindow.LoadObject +RuntimeError: Failed to load image (filename: rework_inv/new_equipment_bg.tga) +``` + +调用链为 `networkModule.SetGamePhase` → `game.GameWindow.__init__` → `interfaceModule.Interface.MakeInterface` → `__MakeWindows` → `uiInventory.InventoryWindow.__LoadWindow` → `InventoryWindowEx.py` → 图片加载。 + +此纹理确实存在: + +- AVA2 原资源:`../AVA2/1. Client DEV/pack_maker/patch_design_wa/rework_inv/new_equipment_bg.tga`。 +- `patch_design_wa_create.xml` 中的虚拟路径是 `rework_inv/new_equipment_bg.tga`。 +- 跨平台项目根目录的 `rework_inv/new_equipment_bg.tga` 也存在,大小 79522 字节。 +- 发布包的 Resources、MacOS 相对目录和 `asset_manifest.json` 均没有 `rework_inv`。 + +`tools/pack_assets.py` 按固定目录列表打包,遗漏 `rework_inv`。`tools/package_macos.sh` 的相对资源链接同样是固定列表。打包清单的完整性校验只确认“列出的文件是否完整”,没有确认“原版游戏所需文件是否全部列出”。 + +`GameWindow(self)` 必须构造成功,才会传入 `SetPhaseWindow` 并成为当前游戏窗口。背包加载失败会调用原版 `exception.Abort`(记录异常、调用 `app.Abort`、`sys.exit`),使这一过程提前中止。此前创建的部分 UI 可以留下残缺面板。主循环根据实际 Python 窗口判断是否进入 game;地形和角色的主绘制分支依赖这个阶段,故界面构造失败也可能阻止世界显示。用户截图的精确实时阶段没有从进程中读取,不能仅凭图片确定其最后停留在哪个回调。 + +## 资源目录对照运行 + +同一个发布包可执行文件,参数为 `--phase game --preview-data --frames 20`,改在完整 `build/dev/test-rundir` 资源目录下启动后,原版游戏 UI 能完成创建,并输出包含地形、角色、背包和底部任务栏的截图。这排除了“完全没有游戏世界渲染实现”的解释,也验证了资源可见性是当前发布包的明确阻塞因素。 + +该实验是本地预览,未连接服务器;模拟位置、装备、镜头和场景与用户 Windows 截图不同,不能视为真实账号端到端通过。 + +## 其他已发现的问题和验证边界 + +- 发布包没有 `map/` 目录。`CPythonBackground::LoadMap` 查找相对的 `map/`、`Maps/`、`` 和开发测试路径,没有完整的发布资源目录支持。补齐 UI 后仍需用真实地图坐标验证加载。 +- 完整资源运行仍报告部分树木纹理找不到,例如 `CompositeMapN2.dds`、`TreeWillowOakLeaves01SU.dds`、`CompositeMap.dds`。这些日志证明还存在场景纹理解析问题,尚未确定各文件的最终解析规则。 +- 上一份选角调查确认的图片池状态泄漏也会影响游戏 UI 的图片复用;其修复尚未应用。 +- `ava2.python_view` 的 game 测试使用 `runtime/login_view.py` 的简化 `SetGamePhase`,只是设置字符串状态,不会构造原版 `game.GameWindow`;因此不能发现本次背包资源异常。 + +修复方向:按原版 pack manifest 的虚拟路径构建完整运行资源根目录,并让脚本、图片、地图和纹理使用同一根目录;增加发布包原版 GameWindow 创建与加载→游戏阶段回归验证;随后处理图片池重置和世界纹理差异。 + +本次只调查并保留证据,没有修改生产代码或重新打包。日志和完整资源对照截图保存在忽略目录 `build/verification/game-investigation/`:`packaged.log`、`full-assets.log`、`full-assets.png`。 + + +## 2026-10-10 后续修复与真实账号验证 + +已实施以上调查中的资源打包和图片池修复,并用用户指定账号连接现有服务器测试,未改动服务器或 AVA2 参考目录。凭据仅通过测试进程环境提供。 + +真实加载流程还确认并修复了以下问题: + +- `chr.Destroy()` 删除选角实例时清空了网络主角色 VID,导致镜头无法找到服务器上的角色;销毁后恢复网络流保存的主角色标识。 +- 131×131 的高度原始数据包含边界样本,地形块此前没有放到地图区块的位置。区块原点现在按 `block * 25600 - cellScale` 设置;地图物件的负 Y 转换到游戏的正地图 Y,同时把原生 Z 轴旋转转换为引擎 Y 轴旋转。 +- 新增角色包中的高度可能为 0,而地形高度约 17771;第一帧镜头避障把角色误当成地下物件,距离从 1550 收缩到 194。绘制和镜头检查前先按地形放置实际主角色。 +- SDL 的二维几何接口没有深度缓冲,之前却按近到远绘制不透明场景,远处地形覆盖角色。改为远到近,并保持地形混合层次。 +- 盔甲 DDS 的透明度通道包含高光信息。上传纹理时把低透明度像素的 RGB 清零、随后强制透明混合,造成角色身体消失或变黑。现在保留 RGB,并按材质是否透明决定混合模式。 +- 地表使用原始 tile.raw 的纹理分布和邻域混合,替代每个区块只选择一种主要纹理;小地图恢复采样实际 minimap.dds 地形,并在其上绘制原有角色标记。 +- 桌面使用原版任务栏,触控 HUD 仅在 Android 启用;实际服务器游戏不再运行预览角色的模拟移动/战斗更新。 +- 完整包由 pack 虚拟路径与 Windows 客户端散装界面图片共同生成。脚本根目录纳入清单,包内链接保持在包内,避免掩盖缺失文件的开发目录链接。 + +开发运行目录中的真实登录、选角、loading、game 流程已通过,主角色坐标 `(43303, 17771, 70856)`,镜头距离保持 1550。9 项相关回归测试通过;Android 核心编译通过。 + +精确 Windows 高光/光照、SDL 几何接口在复杂相交场景中的完整深度处理、相邻地形块流式加载,以及少数原始引用缺失的特效/植被纹理仍有差异。生成的验证截图和日志位于 `build/verification/game-fixed/`。 + +最终独立 macOS 包已用同一账号完成真实 loading → game;原版 GameWindow 的包内资源构造测试通过。包内外部符号链接为 0,真实登录退出后的严格签名验证通过。运行配置改为包外用户数据目录,最终截图为 `build/verification/game-fixed/packaged-game.png`。 + +## 2026-10-11 技能、操作和头顶显示修复 + +- 技能面板空白来自 `playerLoad.RegisterSkill` 空实现。按 AVA2 自己的 `PythonPlayerSettingsModule.h` 恢复职业/分支、第九技能、坐骑、辅助、语言和公会槽位,并在主角色加载时提前注册,保留加载阶段已收到的技能等级。 +- 属性派生值更新按 AVA2 原版触发条件重新计算,避免全量初始点数覆盖客户端计算结果。此项有回归覆盖;本次真实账号主要验证技能页,不代表所有属性数值已逐项与 Windows 核对。 +- 名字为黑色像素字:原生启动流程漏掉 `introLoading.__main__()` 的颜色/称号初始化,并使用 SDL 调试字体。恢复原版初始化,头顶文字改用界面的 FreeType 字体和真实文字宽度,保持 Retina 渲染比例。 +- 等级落在脚下:网络角色的 TextTail 默认高度仅 10,且停留在包中的 Z=0。登记时加入角色高度,每帧跟随实际渲染角色,并保持名字居中、等级和称号在左侧。 +- GM 标识的黄色线条和偏移来自矩形顶点、半尺寸/缩放、循环粒子上限、重力额外乘 9.8、发射向量强制归一化,以及附着粒子没有跟随角色。按 AVA2 `EffectLib` 行为修正;最终真实截图显示标识在头顶。 +- 键盘移动接口原为无操作,鼠标状态没有驱动真实角色。接通原版 Python 输入到服务器拥有的角色,支持相对镜头的方向键/WASD、地面点击/按住移动、右键镜头和镜头按键,发送移动和停止包。界面消费的滚轮优先留给界面,原生 F9 不再意外切换调试渲染器。 +- 游戏更新不再固定 33 毫秒;按实际帧间隔更新(上限 250 毫秒),失去窗口焦点释放按键。地图加载回调可能在帧内替换地形,使用前重新获取指针,避免访问已销毁地图。 + +验证:`ava2.player_panel`、`ava2.game_scene`、`ava2.game_entry` 3/3 通过,覆盖技能等级保留、派生属性、方向/对向/斜向输入、镜头按键释放、原版颜色初始化、粒子几何/上浮/附着。指定账号真实登录到 game,技能图标和等级有效;按键移动测试距离 1020,松开后位移 0。最终独立包再次登录并截图成功,证据在 `build/verification/input-label-fixed/`。没有保存账号密码或修改 AVA2/服务器。复杂场景帧率、完整战斗交互和精确 Windows 光照一致性没有在本次验证中完成。 + +## 2026-10-11 二次登录黑屏与倒退行走回归 + +- 根因一:`net.SetPhaseWindow` 的两处 C++ 强引用延迟了旧 `LoadingWindow` 的销毁。安装新加载窗口时,旧窗口析构中的 `SetPhaseWindow(LOAD,0)` 清除了新窗口,主角色的 `LoadData` 无法触发。现在先释放两处旧引用,再安装新窗口;测试用带析构回调的旧窗口和真实主角色包确认新回调仍然有效。 +- 同类问题还出现在 `player.SetGameWindow`:旧 GameWindow 析构调用 `SetGameWindow(0)`,可能覆盖新回调;数字 0 原来还被当作 Python 回调对象持有。现在归一化 0/None,并在新回调安装前完成旧对象销毁。连续 GameWindow 重建与快捷栏刷新通过。 +- 倒退行走:模型与骨骼世界矩阵额外加了 180 度,而位移方向未加。移除额外旋转;从真实战士 GR2 脚部/脚趾骨骼计算正面方向,验证绘制方向与运动方向一致。 +- 移动包时间:原生游戏时钟没有承接由 LoginSession 处理的初始服务器握手,可能发送本机 uptime。现在每个连接在加载交接时同步握手时间及已过间隔;原生收到没有对应握手的 HANDSHAKE_OK 时保留已同步时间。此处是已确认的时钟缺陷;没有读取服务器日志,因此不把用户报告的每一次退出都归因于服务器时间检查。 +- 原版 Python 可能 `exit(0)` 提前结束测试,game_entry 现在也要求最终完成标记,避免将未完成的构造流程误判为成功。 + +验证:5/5 相关 CTests 通过。指定账号在同一个客户端进程完成 game → login → selection → loading → game;第二次技能页、场景和角色正常显示,按键移动后继续运行 100 次游戏更新,连接仍有效,测试进程正常退出。没有改动原 AVA2 或服务器。日志与截图:`build/verification/relogin-facing-fixed/`。发布包与压缩包更新;这些实测覆盖一次连续重登和有限时长在线,不等同于长时间稳定性验证。 + +## 2026-10-11: selection facing, NPC outfits, and measured frame cost + +The selection regression came from removing the universal 180-degree model rotation to correct locomotion. The original Windows `chr.SetRotation` adds 180 degrees at the script API boundary; restoring that conversion fixes selection without changing network locomotion. Script position getters now also invert the reflected showcase Y coordinate consistently. The live selection screenshot shows the warrior's face again, and the GR2 toe-direction regression still confirms that gameplay mesh forward agrees with movement. + +The eight teacher NPCs (61000–61007) share `old_master_M` as their base entry in `npclist.txt`. Windows replaces this through `locale/common/npc_wear.txt`, including races 0–7 and outfits 34100/34101. The bundled Python pack mount previously searched only `Resources/root`; the configuration exists in sibling `Resources/locale/common`. Pack reads now search the script mount first, then the bundle asset mount identified by its manifest, preserving case-insensitive lookup and traversal rejection. The NPC query also uses the background's current warp map, matching the Windows query instead of an unassigned string. Live logs confirm eight distinct requested race/model combinations, and `scene-final.png` shows the configured outfits. + +`app.SetCamera` previously updated the Python-side camera without updating the host orbit camera, while `app.GetCamera` returned stale values after input. A consumed setting request now updates the host camera and host feedback updates the Python values. The live scene probe verifies a requested 180-degree view and an active connection. + +The delivered binary had been built as Debug (`-g`, no optimization). A macOS `sample` also found per-frame rebuilding of static map-object geometry. Static object draw commands are now cached for their lifetime and released with the map; this trades some retained geometry memory for reduced construction work. Packaging now explicitly configures RelWithDebInfo (`-O2`) in `build/release`, retaining symbols for crash diagnosis. + +Measured on this machine, the authorized test account at approximately (441,716), 2048x1536 output, same 1550-distance/15-degree/180-degree NPC camera: + +| Build | Representative stable total frame cost | Approximate rate | +| --- | --- | --- | +| Debug, corrected NPC assets and static cache | 239–241 ms | 4.2 FPS | +| RelWithDebInfo, corrected NPC assets and static cache | 25.0–25.2 ms | 40 FPS | + +The optimized default camera measured 21–22 ms (45–47 FPS). These are short live samples, not a guaranteed rate across maps; initial asset loading and screenshot capture frames are excluded. Windows screenshot parity still has gaps in mounted NPCs, foliage, sky/environment, and depth handling; SDL geometry currently uses painter ordering rather than a hardware depth buffer. The old screenshot's camera, location, and aspect ratio also differ from the reference, so it cannot establish pixel parity by itself. + +Evidence: `build/verification/npc-performance/{baseline.sample,debug-comparison.log,scene-final.log,select-final.png,scene-final.png,targeted-final-tests.log}`. Regression checks cover bundle pack mounting and NPC map precedence, presentation versus movement orientation, camera setter/feedback, select rendering, and entering the game twice. + +Final targeted verification: eight relevant tests passed (pack mount, player panel/camera, select render, game scene, game entry, GR2 render, chr API, background). The broader `ava2.python` suite still fails a pre-existing missing-icon fixture assumption against the populated asset root; isolating that fixture reveals an older formula-status expectation (100.5 versus 90.5 after derived-status recalculation). Those unrelated fixture/status expectations were not changed for this rendering patch. The final facing implementation restores the Windows script boundary conversion rather than introducing an actor-wide rendering offset. + +### 2026-10-11 Hardware depth, frame pacing and mounted NPCs + +- Added a native SDL_GPU scene pass with persistent vertex/index buffers, depth testing/writes, alpha testing, D3D-style culling and perspective-correct texture interpolation. Metal is verified on this host; the Vulkan SPIR-V shaders compile but Vulkan runtime is not verified. CPU model transforms, lighting and fog remain CPU work. +- Upload decoded textures on the scene GPU queue before sampling. Borrowing SDL_Renderer textures produced a blank first frame because their queued uploads were not submitted until Present. Composite the scene with premultiplied alpha so the original selection background survives. +- Cache tinted text masks (512 entries / 16 MiB) instead of creating/destroying textures for every label. Cull static objects by conservative world bounds before copying mesh commands. Keep collision geometry intact. Disable GPU validation in normal release builds; AVA2_GPU_DEBUG enables it for diagnostics. +- Move the 60 Hz deadline wait immediately before presentation and use SDL_DelayPrecise. The frame CSV distinguishes active CPU work, geometry assembly, raster encoding and presentation intervals; loading and screenshots are excluded from steady-state statistics. +- Port the reference sky's vertical cube gradients, environment cloud scale/height/alpha and lens-flare enable conditions. This removes the invented cloud/flare appearance in C1. +- Render mount actors and attach riders through the animated saddle bone. Convert native Z-up bone matrices before world attachment. Register the reference horse wait/walk/run/dead motions for all eight PC races, and resolve the active motion mode at playback time: riders no longer stand on mounts, and an armor rebuild preserves the riding pose. A real GR2 leg-pose regression checks riding, armor rebuild and dismount restoration. +- Validation: 10 targeted Debug CTests pass, including native Metal depth/alpha/culling/perspective/first-texture/background pixels, font renderer lifetime, conservative frustum rejection, sky configuration and mounted animation. Live selection, NPC/mount scene, movement/orbit and same-process re-login were exercised with the authorized account. No credentials are stored in source or documentation. +- Remaining Windows parity gaps: SpeedTree still generates approximate foliage rather than decoding the original SPT geometry; outdoor rendering still lacks full adjacent-tile streaming; original specular/sphere-map shading is not complete. Performance evidence covers the measured local Metal scene, not every map or long-running session. Existing unrelated broad-Python-suite fixture/formula failures remain unchanged. + +- Final signed-bundle measurement: 2,400 game updates (~40 s), 2,359 steady-state samples after the first 40 updates; average 60.000 FPS, presentation interval P95 16.723 ms / P99 16.765 ms, active CPU work P95 10.424 ms / P99 11.313 ms. Two intervals exceeded 20 ms (maximum 23.478 ms); this is not a claim of zero dropped frames. Full camera orbit, short W movement and connection checks at updates 1,190 and 2,390 passed. Evidence: `build/verification/gpu-depth/final-stress.csv`, `final-stress-summary.json`, `final-stress.png`, `riding-tests.log`. Signed app: `dist/AVA2.app`; release archive updated from that bundle. +- Final packaged re-login probe also passed after the riding fix: second GameWindow and skill page rendered, movement completed, and the connection remained live for the following 100 updates (`build/verification/gpu-depth/final-relogin.log`). diff --git a/docs/PERFORMANCE-AUDIT-2026-10-11.md b/docs/PERFORMANCE-AUDIT-2026-10-11.md new file mode 100644 index 00000000..2337d36d --- /dev/null +++ b/docs/PERFORMANCE-AUDIT-2026-10-11.md @@ -0,0 +1,176 @@ +# 跨平台客户端性能调查(2026-10-11) + +## 结论与测量范围 + +目前最值得优化的是 CPU 端渲染准备和角色网格生成,而不是继续调整限帧或优先重写 UI。代码检查发现的主要成本包括:重复生成/复制网格、CPU 顶点变换和蒙皮、全体角色渲染、反复求骨骼姿态、切换动作时同步加载动画。 + +本次只调查并记录,不修改客户端运行逻辑、资源包或服务器。 + +使用当前签名的 RelWithDebInfo/Metal 客户端,在已授权账号所在的 NPC/坐骑场景做两次固定视角运行:一次 8 秒 macOS `sample` 调用栈采样,一次不采样的 1,200 帧对照。不移动账号。剔除前 40 个游戏更新,保留 1,159 帧: + +| 对照指标 | 实测 | +| --- | --- | +| 平均 FPS | 60.000 | +| 平均有效 CPU 帧耗时(不含限帧等待) | 7.117 ms | +| 场景组装平均 / P99 | 2.920 / 3.295 ms | +| 渲染准备与提交平均 / P99 | 3.173 / 3.410 ms | +| Present 平均 / 最大 | 0.153 / 11.351 ms | +| 可见帧间隔 P99 / 最大 | 17.698 / 27.938 ms | +| 超过 20 ms 的间隔 | 1 | + +采样中的主线程共有 4,953 个样本,其中 2,871 个位于主动限帧等待。排除该等待后:渲染准备 969 个(约 46.5%),角色绘制生成 721 个(约 34.6%),背景组装 123 个(约 5.9%),UI 更新、绘制和脚本回调 190 个(约 9.1%)。这是调用栈样本占比,不是精确 CPU/GPU 时间。 + +采样运行第 80 帧出现 521 ms 停顿,与启动采样的时间接近;不采样对照没有复现同类场景组装停顿。其原因未确认,不把它作为某段客户端代码耗时 500 ms 的证据。对照仍有一次 Present 波动,需要 GPU 时间和系统调度证据才能解释。 + +`raster_ms` 包含 CPU 变换、命令编码和提交,不等于 GPU 执行时间。现有证据不能证明 GPU 已经满载。采样进程物理内存约 1.3 GB,也不能据此认定存在泄漏。 + +## 优先优化项 + +### 1. 避免每帧搬运和重复处理网格(P1,实测热点) + +`src/eter_render/Gr2ModelRenderer.cpp:830` 每个顶点仍在 CPU 做世界/视图/投影变换、法线归一化、光照和雾。原 SDL 几何回退使用的屏幕坐标也在硬件路径计算,但硬件分支只消费裁剪坐标。 + +`:919` 又把变换后的顶点从临时数组拷入硬件顶点数组,`:920` 和 `:922` 两次遍历索引(合法性检查与追加)。`HardwareScene.cpp:150` 进一步复制到传输缓冲,每帧上传完整顶点和索引。 + +静态物体虽已缓存几何,但 `MapObjectManager.cpp:363` 将缓存的 Render3DDraw 深拷贝到每帧列表;静态顶点、法线、UV、索引仍跟随 CPU/GPU 数据流反复搬运。调用栈直接显示顶点整理和变换循环占据大量样本。 + +建议顺序: + +1. 硬件路径跳过回退专用屏幕坐标计算;静态索引在资源加载时验证;复用帧数组容量。 +2. 将不可变几何与逐帧矩阵/材质参数分开,命令只引用几何,避免深拷贝。 +3. 静态建筑、地形的顶点/索引常驻 GPU;着色器接收矩阵、光照和雾参数。 +4. 动态角色先只更新蒙皮数据,最终再迁移 GPU 蒙皮。 + +具体节省毫秒数必须在实现后测量,不能把本项的约 3 ms 当前总耗时当成全部可消除的成本。GPU 改写必须保持现有坐标、深度、雾、Alpha 和材质行为。 + +### 2. 角色先裁剪再蒙皮,复用骨骼姿态(P1,实测热点) + +`NetworkActorManager.cpp:896` 只跳过隐藏角色,没有根据视锥裁剪角色及坐骑。SDK `gr2_model_instance.cpp:427` 为每个角色求姿态、分配数组并逐顶点 CPU 蒙皮,之后附件也会生成网格。相机背后的角色仍消耗这些成本。 + +SDK `GetBoneWorldTransform` 每次查询一个骨骼也会创建数组并重新求整个骨架姿态。骑乘更新查询鞍座,绘制时再查一次;装备、特效和其他挂点查询可能继续重复。`gr2_skeleton.cpp:sample_pose` 每次创建骨骼名字到索引的哈希映射和临时矩阵数组。 + +建议:使用保守动画包围盒/球在生成网格前裁剪;角色和挂件共享“本模型、本动画、本时间”的姿态缓存;预计算骨骼索引和动画轨道绑定。进一步加入距离 LOD 和远处动画更新频率。网络、移动、战斗逻辑继续每帧正常更新,不能通过停止不可见角色逻辑来节省耗时。模型或动画切换必须使缓存失效。 + +这是人多、怪多的地图最需要处理的扩展性问题。当前场景收益不代表百人场景收益,需补密集角色基准。 + +### 3. 动画/模型资源共享与预热(P1,代码确认,瞬时收益待测) + +`ActorInstance.cpp:275` 播放动作调用 LoadExternalAnimation;SDK `gr2_model_instance.cpp:71` 每次读取并解析 GR2,没有已解析动画缓存。切换 Wait/Run、攻击动作时可能再次发生同步读取和解析。`ActorInstance.cpp:33` 也为每个装备实例直接加载模型,底层实例独占解析后的 File。 + +建议按规范化资源路径共享不可变的已解析模型/动画,角色实例仅保留播放时间、部件和姿态。预热当前角色及附近 NPC 的常用动作;未命中资源的读取和解析可放到受控工作队列,GPU 创建/提交仍走正确线程。保持 Python 2 回调和现有加载顺序语义。 + +优先测量持续走停、连续攻击和装备切换的 P99/最大帧耗时;静止场景采样无法量化这些交互尖峰。可同时减少重复解析占用的内存。 + +### 4. 地形 patch 缓存、材质合批及实例绘制(P2,代码确认) + +`TerrainHeightmap.cpp:625` 每帧重新构建可见 patch。`:711` 多层纹理混合会复制同一组顶点,并重算 tile 权重、alpha 和索引。已存在视锥四叉树和两档距离 LOD,但没有 patch/LOD 几何缓存。 + +建议以地图、patch、step、纹理版本为键缓存不可变几何;只更新可见集合。相同建筑/树木用共享网格与实例矩阵;相同状态的相邻批次减少重复 pipeline/纹理绑定。当前硬件分支仍按旧 SDL 回退的远到近规则对不透明物体排序;可与回退分开,利用深度缓冲按材质/近到远组织。 + +不透明物体可重新组织;水、粒子等透明物体仍须保持正确顺序。地形混合层不能随意重排,不能为了合批删除 Windows 已有的纹理层。补密集树木和多层地形场景再量化收益。 + +### 5. GPU 时间、提交波动和资源内存预算(P2,需要补证据) + +HardwareScene 持有整帧动态缓冲和 GPU 纹理缓存;软件纹理缓存还保留 RGBA 数据。减少静态网格上传、清理不再使用的地图纹理,有望降低带宽和内存压力。此处是资源生命周期优化,不是已经证实的泄漏。 + +需要补 CPU/GPU 分段时间、上传字节数、常驻纹理/模型字节数、每帧 draw 数及多次换图后的内存变化。尤其要区分偶发 Present 等待、驱动提交与 CPU 资源解析。不能仅用 SDL_SubmitGPUCommandBuffer 返回耗时判断 GPU 工作量。 + +### 6. Python/UI 与碰撞(P3,次要) + +主循环 `main.cpp:2234` 每帧通过 PyRun_SimpleString 编译同一段 OnUpdate/OnRender 调度代码,可缓存 code object 或直接调用回调,并继续正确处理阶段窗口切换。 + +UI 更新、渲染树还有每帧遍历成本,可让稳定属性/文本按数据变更刷新;不应直接降低整套 UI 更新频率而破坏交互。当前它们约占非限帧样本 9%,优先级低于渲染和角色。 + +`MapObjectManager.cpp:308` 的移动碰撞遍历全部对象;可用网格/BVH 做宽阶段筛选。静止对照没有证明它是热点,应先在连续移动和复杂建筑地图测量。不要以减少碰撞检查精度换帧率。 + +## 建议实施与验收顺序 + +1. 先做角色视锥裁剪、每帧骨骼姿态复用、硬件路径去除无用计算;属于较集中、易核对的改动。 +2. 加入已解析动画缓存,实测走停/攻击/装备切换尖峰。 +3. 重构几何引用,静态网格常驻 GPU,再迁移顶点变换和蒙皮。 +4. 地形缓存、树木/建筑实例化和安全材质合批。 +5. 用更细分 CPU/GPU 计时确认余下热点,再决定 UI 或碰撞优化。 + +每步以同机同分辨率、同场景前后对照验证平均、P95/P99/最大帧耗时,而不只看 60 FPS 上限。至少覆盖固定视角、相机旋转、持续移动/攻击、密集 NPC、骑乘、重新登录;每步保留渲染和协议回归。 + +## 原始证据 + +- `build/verification/performance-audit/cpu-sample.txt`:8 秒主线程调用栈。 +- `build/verification/performance-audit/frames.csv`:有采样运行,存在测量干扰可能。 +- `build/verification/performance-audit/control-frames.csv`、`control-summary.json`:无采样对照。 +- `build/verification/performance-audit/client.log`、`control.log`:运行日志。 + +## 本轮已实施优化 + +- 在共享 SDK `sdk/gr2` 中缓存不可变的解析后 GR2 文件,模型和动画共用缓存,实例播放状态和附件仍独立。以规范化路径、文件大小、修改时间判断资源版本;失败加载不缓存。强引用保留上限 64 项 / 128 MiB 源文件字节(并非解析后总内存预算),活跃实例保留自己的共享所有权。 +- 同一模型、动画和时间只求一次骨骼姿态,挂点查询、网格和附件复用结果;预先绑定轨道名字到骨骼索引,重复使用矩阵数组。动画切换显式失效。测试与原始 sample_pose 的腿部矩阵对照,检查时间推进、动画切换和实例隔离。 +- 角色/坐骑使用带动画与附件余量的保守包围盒,在生成网格前裁剪。主角色始终保留;没有矩阵时保留原行为。网络和移动更新不因裁剪停止。 +- 建筑 draw 命令引用不可变几何,避免每帧深拷贝;地形按 patch 与细节步长缓存同类命令。高度、tile、纹理或世界原点更新使缓存失效。软件与 GPU 路径均从同一 Mesh 引用读取几何;材质和变换仍为逐命令状态。 +- 原生 GPU 路径不再计算仅供 SDL 回退使用的屏幕坐标。 +- 实机正常退出曾暴露小地图图片引用晚于资源管理器销毁的问题。PythonRuntime 显式销毁小地图;主循环在 SDL renderer 仍存活时释放 Python/UI 资源,修复该退出崩溃。 + +固定视角、同账号同场景、1,200 帧对照(剔除前 40 帧):有效 CPU 平均耗时从 7.117 ms 降到 5.423 ms,减少 23.8%;场景组装从 2.920 ms 降到 1.838 ms,减少 37.1%。优化后平均 60.000 FPS,间隔 P99 16.792 ms,最大 17.041 ms,1,159 个稳态样本没有超过 20 ms 的间隔。这是一次本机场景对照,不是所有地图的性能保证。 + +11 项相关 Debug CTests 通过:增加了解析资源复用/同路径更新失效、骨骼缓存正确性、骑乘与装备重建、视锥拒绝不求姿态、地形与静态几何复用/失效、GPU 共享几何像素与独立材质状态检查。证据在 `build/verification/performance-audit/optimized-summary.json`、`optimized-frames.csv`、`optimized-final-tests.log`、`optimized.png`。 + +进一步的静态缓冲常驻 GPU、GPU 顶点变换/蒙皮、实例绘制、完整资源内存预算、UI 调度和碰撞空间索引仍未实施。本轮先处理已证实热点,保留现有透明排序、材质和协议行为。 + +- Final signed-bundle validation: 2,400-frame camera-orbit/short movement probe passed both connection checks; 2,359 steady-state samples averaged 60.000 FPS, interval P99 16.811 ms, active mean 5.669 ms, with two >20 ms intervals (max 22.489 ms). Same-process re-login rendered the second game/skill window, completed movement, remained connected for 100 further updates and exited cleanly. Evidence: `optimized-orbit-summary.json`, `optimized-orbit.log`, `optimized-relogin.log` under build/verification/performance-audit. Signed `dist/AVA2.app` and its archive updated. + +## 2026-10-11 静态缓冲、GPU 蒙皮与实例绘制 + +本轮完成了上一轮保留的三项主要渲染优化: + +- 原生 Metal/Vulkan 顶点着色器处理世界/视图/投影变换、法线变换、光照和雾。显式使用行向量,保持旧 D3D/CPU 矩阵语义;旧预变换输入仍可用于像素对照。SDL uniform/storage 资源布局参照官方 SDL_CreateGPUShader 和 SDL_PushGPUVertexUniformData 文档。 +- 建筑、地形 patch 和角色的不可变顶点/索引存入常驻 GPU 缓冲。每帧更新矩阵、材质和骨骼 palette,动态水面/树木风动画/部分效果仍使用动态缓冲。常驻网格按实际 GPU 缓冲字节计算 256 MiB 的软保留预算,超限时释放至少两帧未使用的条目;活跃工作集可以超过预算以避免反复上传。资源版本以不可变几何所有权区分,转换缓存同时检查源对象所有权,防止地址复用错误。 +- SDK 输出原始顶点、权重和 palette 并缓存网格模板,由顶点着色器执行蒙皮。头发/盔甲部件保留各自 inverse bind pose 重映射;骨骼挂点和坐骑鞍座继续由已缓存的 CPU 骨骼姿态提供。零权重或无效绑定保持原始顶点,最多支持 128 个 palette 骨骼;更大 palette 自动使用 CPU 蒙皮。软件渲染/F6 切换保留 CPU 路径,AVA2_CPU_SKINNING 可用于对照。 +- 相同建筑模型共享几何。不透明绘制按网格/材质组织,通过实例矩阵 storage buffer 合并相邻兼容命令。骨骼 palette 不同的角色、透明/加法混合命令继续单独绘制。当前 NPC 场景 182 批合为 181 个实际 draw,密集重复建筑场景的收益需另测;没有把这一场景的主要收益归因于实例绘制。 + +### 实测与限制 + +同账号、同位置、同视角,原签名程序与新签名程序依次运行 1,200 个游戏更新,剔除前 40 帧,分别保留 1,159 帧: + +| 指标 | 修改前 | 修改后 | +| --- | --- | --- | +| 有效 CPU 工作平均 | 5.976 ms | 3.491 ms(-41.6%) | +| 场景组装平均 | 1.957 ms | 1.058 ms | +| 渲染准备/提交平均 | 2.918 ms | 0.807 ms(-72.3%) | +| Present 平均 | 0.132 ms | 0.290 ms | +| 帧间隔 P99 | 16.832 ms | 17.038 ms | +| 平均 FPS | 60.000 | 60.001 | +| 超过 20 ms 的稳态间隔 | 0 | 0 | + +CPU 余量明显增加,但这次固定视角样本的帧间隔 P99 并没有改善,不能只据平均 CPU 耗时宣称所有顿挫已消失。渲染准备/提交时间也不等于 GPU 硬件执行时间,需要后续 GPU 时间戳或图形捕获。 + +最终签名包的 2,400 帧旋转/短行走测试:平均 60.000 FPS,CPU 平均 3.588 ms,帧间隔 P99 17.020 ms;2,359 个稳态样本有一次 >20 ms(最大 25.284 ms)。连接检查在第 1,190 和 2,390 更新通过。同进程重新登录显示第二个游戏/技能窗口,移动后再保持 100 更新连接,并正常退出。 + +固定视角的常驻网格约 20.3 MB,累计上传次数在稳态保持 169 不变;旋转后已见网格约 91.1 MB,累计上传 710 次,返回原视角不再上传这些网格。固定视角每帧动态顶点/索引约 0.97 MB(不含实例/骨骼 uniform 和纹理上传)。 + +11 项相关 Debug CTests 全部通过。新增验证覆盖:GPU 两骨骼加权旋转像素与 CPU 参考、逐顶点/法线 CPU-GPU 蒙皮等价(含头发和武器)、常驻缓冲跨帧不重传、实例矩阵/材质隔离、非零 firstInstance、透明命令不合并、相同建筑网格共享与独立 world 变换。现有深度、Alpha、透视、选择、骑乘、背景和重登录测试保留。 + +已验证 Metal;Vulkan SPIR-V 重新生成并编译通过,但没有 Vulkan 运行验证。早期两次自动登录超时,随后登录成功;未把未确认原因归因于渲染,也未修改协议或账号凭据。 + +证据:`build/verification/gpu-resident/` 的 baseline-current-scene/resident-current-scene/resident-orbit CSV、summary、日志和截图,以及 final-tests.log。已更新签名 app 与压缩包。 + +进一步优化项仍包括:真正的树木实例化/风动画着色器、GPU 时间测量、全部模型/纹理的内存预算、Python 调度缓存、碰撞空间索引,以及更密集角色/建筑和多次换图的长时间基准。原始 SpeedTree/SPT、跨 tile 地形和 specular 渲染差异不属于本轮实现。 + +## 2026-10-11 纹理预算、Python 调度缓存与碰撞索引 + +- 3D 解码图片缓存默认 64 MiB / 256 项;原生 GPU 和 SDL 回退纹理缓存默认 256 MiB。缓存淘汰只发生在安全的帧边界。GPU 当前帧正在引用的纹理及软件渲染当前工作集受保护,因此 GPU/软件路径预算是软上限;原生 GPU 路径在已上传纹理命中时绕过 CPU 解码缓存,允许安全释放上传后的 RGBA 副本。GPU 预算按 RGBA 逻辑图片字节计算,不代表驱动实际 VRAM,也没有管理 UI 图片池、全部模型或整进程内存。 +- 超预算时按最近使用淘汰不活跃纹理;重新使用会重载。纹理集合未超预算时跳过淘汰候选集合构建,避免在正常热路径新增分配。 +- PythonRuntime 缓存编译后的代码对象(最多 64 项 / 128 KiB 源文本,超过 16 KiB 的单段不保留)。每次仍在当前 __main__ 字典执行,窗口/回调切换不会固定旧对象;语法/运行错误保留原错误路径。销毁及构造失败清理在 Py_Finalize 前释放代码对象。没有缓存每次运行结果,也没有降低 UI 更新频率或写入账号凭据。 +- 建筑碰撞采用 512 单位空间网格宽阶段;保留原半径过滤、OBB 判定和法线。过大的对象及非正常/大范围查询回退到完整候选列表;候选按原对象顺序排序去重,保留重叠物体的首个命中法线。新增对象或 ClearObjects 后索引失效重建。 + +### 验证结果 + +11 项相关 Debug CTests 通过,新增检查包括:脚本代码复用后调用新的回调、运行错误与 LRU 容量;GPU 纹理淘汰/重载及当前帧保护;CPU 解码缓存释放后命中 GPU 不再解码、切回软件路径重载并保留活跃图片;500 组碰撞位置/半径/法线与原完整遍历对照,覆盖负坐标、旋转、重叠、过大对象/查询和 ClearObjects 后再加载。122 对象的局部查询候选少于总数四分之一。最后的 GPU 预算热路径调整另外通过 hardware_scene 测试。 + +同场景各 1,200 帧、剔除前 40 帧的对照:修改前平均有效 CPU 3.758 ms,初版 3.690 ms,最终打包版本 3.722 ms。差异较小,不能据此宣称有可靠的帧耗时提升;本轮主要是减少重复工作和限制资源保留。最终 1,159 个稳态样本平均 59.999 FPS,帧间隔 P99 17.225 ms,有一次 >20 ms(最大 22.213 ms)。 + +40 秒旋转/短移动测试平均 60.000 FPS,间隔 P99 17.239 ms,2,359 个稳态样本没有 >20 ms 间隔。最后小范围预算热路径修改后又完成固定视角及同进程重登录复测:第二个游戏和技能窗口显示、移动及随后 100 更新连接检查、正常退出均通过。仍不是所有地图/长会话的稳定性保证。 + +旋转场景实机资源统计:解码缓存 66,250,792 字节(64 MiB 以下),GPU 图片逻辑字节 92,465,196;稳态解码 118 次、上传 119 次(含白纹理)保持不变。Python 代码缓存 9 项、约 3.5 KiB,编译次数在稳态保持 9。GM 账号的该次移动没有提供有效碰撞候选负载数据,碰撞性能收益尚未在非 GM 复杂移动场景量化;正确性主要由完整遍历对照测试支持。 + +证据:`build/verification/resource-ui-collision/` 中 baseline/optimized/orbit/final CSV、summary、资源/编译日志、verification-tests.log、budget-hotpath-test.log 和 final-relogin.log。已更新签名 app 和压缩包。原始 AVA2/服务器/协议保持未修改。 + +后续需要实际 GPU 时间、非 GM 移动与密集场景的性能样本、多地图长会话内存测试,以及 UI 图片池/全模型的统一资源生命周期。完整 SpeedTree/SPT、跨 tile 地形和 specular 的渲染差异仍另行处理。 diff --git a/docs/PORT-PLAN.md b/docs/PORT-PLAN.md index 6f7192aa..9906fe9c 100644 --- a/docs/PORT-PLAN.md +++ b/docs/PORT-PLAN.md @@ -772,3 +772,124 @@ Validation: - macOS arm64 `ava2_client`: builds cleanly and runs 60fps game phase. + +### 2026-10-09: native login input and stale macOS bundle verification +- Reproduced non-responsive account/password text and Tab in the existing `dist/AVA2.app`; its executable predated the current development build and input-event wiring. +- Retained the working SDL text-input / IME / focus implementation already present in the workspace and rebuilt/repackaged the macOS app and distribution archive. +- Replaced direct login text assignment in `ava2.window_tree` with mouse focus for both fields, IME text insertion, Tab focus switching, and password backspace assertions. +- Validation: `ava2.window_tree` passed; native rebuilt app visibly accepted account text, Tab switched to password, password masking and backspace worked. No live authentication was attempted and no server changes were made. +- Outstanding: live server authentication and non-ASCII IME composition are outside this verification. + +### 2026-10-10: character selection rendering against the AVA2 Windows reference +- Preserved existing workspace fixes for transparent UI boards and character composition. Rebuilt screenshots confirm that the roster and description panels no longer appear as solid white rectangles. +- Corrected `app.SetCamera` native Y to engine Z conversion and used the Windows camera's right-handed screen orientation. The previous view exposed back-facing geometry through the model: faces, hair and clothing now render from the correct side. `SetCenterPosition` also converts native height/depth consistently. +- Applied the `prototype.RunApp` hair/armor/weapon initialization before creating the first phase window. Armor item vnums now resolve through item-proto to MSM shapes instead of falling back to novice clothes. +- `chr.Update` preserves explicit intro heights outside the game phase. `chr.Deform` no longer advances animation/movement a second time, preventing residual map heights from moving intro models outside the screen. +- Added optional FreeType UI fonts with shared text measurement/rendering metrics, 2x glyph rasterization for Retina, proportional cursor/alignment positions, and preserved zero-alpha text. SDKs without FreeType retain a smaller, consistently measured fallback. Platform fonts are located at runtime; no proprietary font assets were copied. +- Removed per-draw diagnostic output, restricted the phase hint banner to explicit preview mode, and repaired the existing 3D test's vertex/index counting (which had been replaced by a hair debug dump). +- Added `ava2.select_render`: four original races, item-to-shape conversion, camera direction/winding, head/feet containment, unchanged height during intro updates, no animation tick during deformation, panel pixels, proportional text width, and transparent text pixels. Optional screenshot output covers all four slots with Jinno scenery; packaged-app verification uses the Shinsoo preview roster. +- Validation: macOS build and Android arm64 `main` build passed; selection/window-tree/3D/event/Python-view checks passed. The full suite passed 42/44; `ava2.python` still fails on the existing `chr.GetPixelPosition` native-Y/engine-Z round-trip mismatch, and `ava2.chr` on `SetDirection`/`GetRotation`, outside these changes. The baseline checker reports pre-existing edits to interfacemodule/intrologin/serverinfo/ui; AVA2 reference files were not modified. +- Rebuilt `dist/AVA2.app` and its distribution archive. The macOS packager now bundles and relocates SDL3, FreeType and dependent dylibs recursively; signature verification and launching the packaged executable with a selection screenshot passed. Screenshots are under `build/verification/selection/` and are generated artifacts. +- Outstanding: live-account selection is not verified; preview roster/equipment and empire differ from the supplied Windows screenshot. Android currently uses the fallback font because this NDK configuration has no FreeType library; on-device rendering remains unverified. Exact Windows spot/point lighting and specular parity remain open. + +### 2026-10-10: investigation of repeated selection title, flag and borders +- Reproduced the user's 22:58:52 screenshot by loading the original login UI, releasing its phase/account callback references and windows, then creating selection with a mock roster. No live authentication was performed. +- Confirmed that image-instance `Destroy()` omits `Initialize()` in both the base and expanded classes, unlike Windows. The pool reuses objects without reconstruction, leaking login rendering rectangles into selection: Warrior title right fraction 32.3125, Jinno flag 10, and corner images with inherited horizontal/vertical extensions. SDL then tiles these images across the screen. +- A temporary restoration of both reset calls removed the inherited rectangles and repeated strips in the same reproduction; the four-race selection checks passed. Temporary source changes were restored after investigation; the distribution bundle remains unchanged. +- Report: `docs/SELECT-RENDER-INVESTIGATION.md`; generated before/after screenshots, logs, reproduction source and proposed patch are under `build/verification/pool-investigation/`. +- Outstanding: apply and validate the lifecycle fix, add object-pool and login-to-selection regression coverage with image-bound checks, and test returning to login and selecting again. Previous direct-selection tests did not exercise this path and their existing assertions do not detect repeated textures. + +### 2026-10-10: investigation of blank game entry in the packaged app +- Reproduced original GameWindow construction failure in the current distribution: `InventoryWindowEx.py` cannot load `rework_inv/new_equipment_bg.tga`. The image exists in the AVA2 pack manifest and project root, but the fixed packaging directory list omits it from both Resources and the asset manifest. +- Ran the same packaged executable against the complete test resource root: original game UI, terrain and characters were drawn. This was an offline preview, not a live-account entry verification. Several tree/effect textures still failed to resolve. +- Also confirmed the package omits `map/`; the map loader relies on relative map directories and development paths. Existing Python-view game tests use a simplified phase callback and do not construct original GameWindow. +- Report: `docs/GAME-RENDER-INVESTIGATION.md`; generated logs and comparison screenshot are under `build/verification/game-investigation/`. No production code or distribution bundle was changed for this investigation. +- Outstanding: complete packaging from virtual pack paths, unify resource-root resolution for maps/images/scripts, validate original loading-to-game with the packaged app, apply the image-pool reset, and then assess remaining scene/camera/texture parity against Windows. + + +### 2026-10-10: game entry rendering fixes and live package verification +- Applied base/expanded image-instance pool resets; a render comparison poisons and reuses a pooled title instance, verifying that rectangles, scale, rotation, color, flip and mode reset. +- Assets are assembled from AVA2 virtual pack paths plus loose image/audio/model resources beside the Windows client. Required missing pack entries fail packaging. The adapted Python root is included in the manifest with case-sensitive module names preserved; no development directory symlinks remain in the full macOS bundle. +- Fixed resource-root lookup for maps, properties, terrain textures, model textures and SpeedTree files. Terrain blocks use their local block position and raw-height border offset. Native areadata coordinates/rotation axes convert to the game renderer's axes. +- Preserved the stream's main VID after `chr.Destroy()`, bound the game camera to the real network actor, and grounded newly received actors before camera collision checks. Default game camera is RH, distance 1550, pitch 27, and views the actor from behind. +- SDL scene drawing now orders geometry back to front; opaque DDS materials preserve RGB in the alpha/specular mask and avoid forced transparency. Terrain samples/blends native tile masks. The original minimap displays native minimap.dds tiles under the existing marks. Desktop hides the Android touch HUD. Preview movement/combat/render helpers no longer overwrite live actor state. +- Full macOS app tested with the user-provided live account through login → selection → loading → game without preview data. The server main actor stayed at local `(43303, 17771, 70856)`, and camera distance remained 1550. Original GameWindow also constructed successfully using only packaged resources. Runtime config/chat files now use an external user-data directory (default SDL preferences directory); strict codesign verification remained valid after the live login and exit. Credentials were not saved to generated user files. +- Verification: 9/9 relevant CTests pass (Python view, window tree, selection, game scene, original game entry, packaging, 3D rendering, minimap and background); native-area conversion/loose-assets follow-up tests pass. Android `main` target builds. Evidence: `build/verification/game-fixed/packaged-game.png`, logs and `verification.txt`. Updated deliverables: `dist/AVA2.app` and `dist/AVA2-macOS-arm64.tar.gz`. +- Outstanding: exact Windows specular/lighting and complex intersecting-scene depth parity, neighboring terrain-block streaming, and a few effect/vegetation texture references remain. Android was compile-tested, not device-tested. Prior unrelated Python/chr parity failures remain outside this change. + +### 2026-10-11 Game input, skill page and overhead labels + +- Implemented AVA2-specific skill registration before loading-stage skill packets; received skill grades/levels now appear in the original skill page. Derived status recalculation follows the AVA2 point update switch. +- Restored original name/title color initialization, FreeType overhead fonts with Retina scaling, character-height registration and actual owner positions; name stays centered while level/title extend left. Corrected GM particle half sizes/quad/live count, attached positions, gravity units and scripted direction magnitude. +- Connected original Python keyboard/mouse controls to the live actor and movement/stop packets; added held camera keys, focus-loss releases and UI-first wheel handling. Replaced fixed game update delta and reacquired map pointers after loading callbacks. +- Validation: 3/3 targeted CTests; packaged real-account login, nonempty skills/icons/grades, movement then zero movement on release, final overhead screenshot. Evidence: `build/verification/input-label-fixed/final.png` and logs. Updated `dist/AVA2.app` and release archive. No credentials saved. +- Limits: complex-scene frame rate, full combat interaction and exact Windows visual parity remain unverified. + +### 2026-10-11 Re-login lifecycle and movement facing regression + +- Dispose both phase-window owners before registering a successor, preventing old LoadingWindow destructors from clearing the new loading callback. Apply the same ordering to player game-window callbacks and treat Python integer 0 as a cleared owner. +- Remove actor render/bone yaw +180 offset; verify facing from the real warrior GR2 toe/foot axis against movement. Transfer initial game-server handshake milliseconds from LoginSession to native game time, once per connection, and retain bootstrap time on an unmatched native HANDSHAKE_OK. +- Five targeted CTests pass, including destructor reentrancy, a real main-character packet callback, full GameWindow reconstruction, bootstrap clock and model facing. Game-entry test now requires its completion marker. +- Packaged same-process live re-login passed; second scene/skill page rendered, movement followed by 100 game updates retained the connection. Evidence: `build/verification/relogin-facing-fixed/`. Updated app and release archive. Server and original AVA2 remain unchanged; no credentials saved. Limited-duration verification does not establish long-running stability. + +### 2026-10-11 selection / NPC / performance follow-up + +- Restored the original script API `chr.SetRotation` 180-degree conversion, fixing selection while retaining the corrected network locomotion axis. Corrected script position coordinate round trips. +- Mounted manifest-backed bundle asset packs alongside the Python script root. This restores `locale/common/npc_wear.txt`, and live race 61000–61007 NPCs now use their configured eight PC models/outfits. NPC map-specific lookup reads the actual current map. +- Connected Python camera settings and host camera feedback. Added regression coverage for pack mount priority, traversal rejection, NPC map precedence, camera synchronization, and GR2 presentation facing. +- Cached static building geometry and switched macOS packaging from Debug to an explicit RelWithDebInfo build. Same NPC scene measured about 240 ms/frame in Debug versus 25 ms/frame in the optimized build, approximately 4 to 40 FPS on this host. +- Remaining visual/performance gaps: sustained 60 FPS, mounted NPC rendering, foliage and sky parity, and hardware depth-buffer rendering. Short live samples do not establish full Windows pixel parity or long-session stability. + +- Final validation: 8 relevant regression tests pass, live selection/NPC camera probes pass, and relogin probe remains connected after the second game entry. The broad Python suite retains unrelated missing-icon fixture / derived-status expectation failures, documented in GAME-RENDER-INVESTIGATION.md. Signed app and archive contain the optimized executable. + +### 2026-10-11 Hardware depth, frame pacing and mounted NPCs + +- Added a native SDL_GPU scene pass with persistent vertex/index buffers, depth testing/writes, alpha testing, D3D-style culling and perspective-correct texture interpolation. Metal is verified on this host; the Vulkan SPIR-V shaders compile but Vulkan runtime is not verified. CPU model transforms, lighting and fog remain CPU work. +- Upload decoded textures on the scene GPU queue before sampling. Borrowing SDL_Renderer textures produced a blank first frame because their queued uploads were not submitted until Present. Composite the scene with premultiplied alpha so the original selection background survives. +- Cache tinted text masks (512 entries / 16 MiB) instead of creating/destroying textures for every label. Cull static objects by conservative world bounds before copying mesh commands. Keep collision geometry intact. Disable GPU validation in normal release builds; AVA2_GPU_DEBUG enables it for diagnostics. +- Move the 60 Hz deadline wait immediately before presentation and use SDL_DelayPrecise. The frame CSV distinguishes active CPU work, geometry assembly, raster encoding and presentation intervals; loading and screenshots are excluded from steady-state statistics. +- Port the reference sky's vertical cube gradients, environment cloud scale/height/alpha and lens-flare enable conditions. This removes the invented cloud/flare appearance in C1. +- Render mount actors and attach riders through the animated saddle bone. Convert native Z-up bone matrices before world attachment. Register the reference horse wait/walk/run/dead motions for all eight PC races, and resolve the active motion mode at playback time: riders no longer stand on mounts, and an armor rebuild preserves the riding pose. A real GR2 leg-pose regression checks riding, armor rebuild and dismount restoration. +- Validation: 10 targeted Debug CTests pass, including native Metal depth/alpha/culling/perspective/first-texture/background pixels, font renderer lifetime, conservative frustum rejection, sky configuration and mounted animation. Live selection, NPC/mount scene, movement/orbit and same-process re-login were exercised with the authorized account. No credentials are stored in source or documentation. +- Remaining Windows parity gaps: SpeedTree still generates approximate foliage rather than decoding the original SPT geometry; outdoor rendering still lacks full adjacent-tile streaming; original specular/sphere-map shading is not complete. Performance evidence covers the measured local Metal scene, not every map or long-running session. Existing unrelated broad-Python-suite fixture/formula failures remain unchanged. + +- Final signed-bundle measurement: 2,400 game updates (~40 s), 2,359 steady-state samples after the first 40 updates; average 60.000 FPS, presentation interval P95 16.723 ms / P99 16.765 ms, active CPU work P95 10.424 ms / P99 11.313 ms. Two intervals exceeded 20 ms (maximum 23.478 ms); this is not a claim of zero dropped frames. Full camera orbit, short W movement and connection checks at updates 1,190 and 2,390 passed. Evidence: `build/verification/gpu-depth/final-stress.csv`, `final-stress-summary.json`, `final-stress.png`, `riding-tests.log`. Signed app: `dist/AVA2.app`; release archive updated from that bundle. +- Final packaged re-login probe also passed after the riding fix: second GameWindow and skill page rendered, movement completed, and the connection remained live for the following 100 updates (`build/verification/gpu-depth/final-relogin.log`). + +### 2026-10-11 Follow-up performance audit (investigation only) + +- Captured an 8-second main-thread sample and a separate 1,200-frame unprofiled control on the signed Metal build. Control averages 60.000 FPS / 7.117 ms active CPU; P99 presentation interval 17.698 ms with one interval above 20 ms. Sampling run had an unconfirmed 521 ms pause near sampler startup; do not use it as a proven client-code spike. +- Excluding cap-wait samples, rendering preparation and actor draw generation account for approximately 81% of main-thread samples. Prioritize actor culling/pose reuse, removal of redundant hardware-path work, immutable geometry references and resident GPU buffers. Animation switching currently reads/parses GR2 synchronously; caching needs movement/combat measurements. Terrain caching, instancing, resource budgets and UI/collision follow later. +- Detailed evidence and implementation priorities: docs/PERFORMANCE-AUDIT-2026-10-11.md. No client runtime behavior, asset bundle or server changed during this audit. + +### 2026-10-11 Performance optimizations: parsed assets, poses and geometry + +- Added shared immutable parsed GR2 model/animation caching in ../sdk/gr2 (64 retained entries / 128 MiB source bytes, path/mtime/size invalidation), per-instance pose reuse and pre-bound track indices. Mutable playback/attachments remain independent. CPU pose equivalence and cache invalidation tests pass. +- Cull non-main network actors/mounts before mesh generation using conservative bounds; keep all network/locomotion updates active. Static building commands reference immutable mesh streams; terrain patch/LOD geometry is cached and invalidated on map data/origin changes. Both software and native GPU raster paths consume geometry references. +- Skip fallback-only screen coordinate calculations in the hardware path. Fixed a discovered exit-time minimap image reference lifetime by destroying UI/Python resources before SDL renderer/resources. +- Same-scene stationary control: active CPU average 7.117 -> 5.423 ms (-23.8%), scene assembly 2.920 -> 1.838 ms (-37.1%); 60.000 FPS, interval P99 16.792 ms, no >20 ms interval in 1,159 steady-state frames. Eleven targeted Debug CTests pass, including original-vs-cached pose matrices, resource update invalidation, terrain reuse and hardware shared-geometry pixels/material overrides. +- Further static resident GPU buffers, GPU transforms/skinning, instancing, memory budgets and lower-priority UI/collision changes remain follow-up work. Details and measured evidence: docs/PERFORMANCE-AUDIT-2026-10-11.md / build/verification/performance-audit/. + +- Final signed-bundle validation: 2,400-frame camera-orbit/short movement probe passed both connection checks; 2,359 steady-state samples averaged 60.000 FPS, interval P99 16.811 ms, active mean 5.669 ms, with two >20 ms intervals (max 22.489 ms). Same-process re-login rendered the second game/skill window, completed movement, remained connected for 100 further updates and exited cleanly. Evidence: `optimized-orbit-summary.json`, `optimized-orbit.log`, `optimized-relogin.log` under build/verification/performance-audit. Signed `dist/AVA2.app` and its archive updated. + +### 2026-10-11 Resident meshes, GPU skinning and opaque instancing + +- Move vertex transforms, fixed-function lighting/fog and skeletal weighted transforms into Metal/Vulkan shaders. SDK raw mesh templates preserve part inverse-bind remapping, rigid/zero-weight handling and attachments; CPU bone pose still drives saddle/effects. Palettes above 128 bones and software/F6 paths retain CPU skinning. GPU geometry conversion cache validates source ownership, not just an address. +- Resident vertex/index buffers cover immutable building, terrain and character streams, with an inactive-entry 256 MiB soft GPU retention budget. Dynamic water, tree wind and effects remain streamed. Deduplicate building mesh streams and instance compatible adjacent opaque commands through per-instance transforms/material data; transparent and skinned-palette commands remain independent. +- Same-location signed before/after comparison: active CPU 5.976 -> 3.491 ms (-41.6%), render preparation/submit 2.918 -> 0.807 ms (-72.3%). Both cap at ~60 FPS; interval P99 16.832 -> 17.038 ms, so do not claim improved pacing from reduced CPU work. 40-second orbit averages 60.000 FPS, P99 17.020 ms with one >20 ms sample; same-process relogin/skill window/movement/connection and clean exit pass. +- Eleven targeted Debug tests pass, including real mesh/normal skin equivalence, GPU weighted-rotation pixel comparison, resident upload reuse, instance material/matrix isolation, nonzero firstInstance and transparent exclusion. Metal verified; Vulkan shaders compile but runtime unverified. Signed app/archive updated. No original AVA2/server or credentials modified. +- Evidence and remaining lower-priority work: docs/PERFORMANCE-AUDIT-2026-10-11.md and build/verification/gpu-resident/. + +### 2026-10-11 Texture budgets, compiled dispatch and collision broad phase + +- Bound decoded 3D images (64 MiB / 256 retained entries) and native/SDL textures (256 MiB soft budgets), protect in-flight/current working sets, and reuse uploaded native textures without requiring decoded RGBA residency. GPU bytes are logical image payload, not measured driver VRAM; UI images and whole-process memory remain outside this budget. Skip eviction bookkeeping below GPU budget. +- Cache Python 2 compiled statements with bounded source retention and release before interpreter finalization. Eval still resolves current globals/callbacks; no UI throttling, frozen phase-window references or credentials written. Add frame-profile-only resource/compilation counters. +- Add collision spatial grid candidates while preserving original OBB/radius checks, insertion-order first-hit normals, oversized-query/object fallback and index invalidation on changes. +- Eleven targeted Debug regressions pass; add LRU/error/callback-rebind tests, texture eviction/reload/current-frame/software-transition pixel tests, and 500 exact collision hit/normal comparisons. Latest GPU hot-path tweak passes hardware_scene separately. Final signed re-login/skill-window/movement/connection/clean exit probes pass. +- Same-scene active CPU averages 3.758 ms before, 3.722 ms final: too small to claim a reliable speedup. Final ~60 FPS, P99 interval 17.225 ms with one >20 ms sample. Forty-second orbit ~60 FPS / P99 17.239 ms with no >20 ms sample; decode/upload/compile counts stabilize and decoded retention stays below 64 MiB. GM live collision workload was not representative; non-GM/dense/multimap and actual GPU timing remain follow-up validation. +- Signed app/archive updated; detailed limits/evidence in docs/PERFORMANCE-AUDIT-2026-10-11.md and build/verification/resource-ui-collision/. + +### Reproducible SDK dependency (2026-10-11) + +- Publish the shared SDK independently and pin its revision through the `sdk` Git submodule. Client builds default to this checkout; `AVA2_SDK_ROOT` supports an explicit development override. Source snapshots, tests and SDK provenance remain in the SDK repository, rather than duplicated client source. +- Build products, unpacked game assets, local resource links, runtime state and account credentials are excluded from both commits. Embedded SPIR-V C++ shader code accompanies its GLSL source and regeneration tool as required renderer source. diff --git a/docs/SELECT-RENDER-INVESTIGATION.md b/docs/SELECT-RENDER-INVESTIGATION.md new file mode 100644 index 00000000..09ab73a0 --- /dev/null +++ b/docs/SELECT-RENDER-INVESTIGATION.md @@ -0,0 +1,40 @@ +# 选角标题、国旗和边框重复的原因 + +调查日期:2026-10-10。对应用户 22:58:52 截图。 + +## 已确认的根因 + +移植版图片实例的销毁过程遗漏了状态初始化: + +- `src/eter_image/GrpImageInstance.h` 的 `Destroy()` 只清除图片引用,没有调用 `Initialize()`,缩放、颜色/透明度、位置和翻转状态可能被保留。 +- `src/eter_image/GrpExpandedImageInstance.h` 的 `Destroy()` 只调用基类销毁,没有调用派生类 `Initialize()`,平铺范围、旋转和混合模式等状态可能被保留。 +- `shared/common/DynamicPool.h` 的 `Alloc()` 直接返回空闲对象,不重新运行构造函数。它依赖对象在归还时重置状态。 + +登录 UI 的边框使用正的 `SetRenderingRect` 扩展值来平铺纹理。对象释放并在选角 UI 中复用后,这些值被新图片继承。`GrpImageInstance.cpp` 的扩展图片渲染会据此扩大目标矩形,并调用 `SDL_RenderTextureTiled`,于是标题、国旗和角落纹理被重复绘制。 + +Windows 参考实现中,基类和扩展图片类的 `Destroy()` 都会调用各自的 `Initialize()`。移植版遗漏了这两个调用。 + +## 验证证据 + +使用原版 Python 登录 UI 和模拟角色数据,在本地测试中关闭登录 UI、释放登录阶段回调引用、执行 Python GC 和窗口管理器 Update,再创建选角 UI。没有进行服务器认证。 + +复用日志记录到: + +```text +locale/en/ui/select/name_warrior.sub rect=(0,0,32.3125,0) +locale/en/ui/select/empire/empireflag_c.sub rect=(0,0,10,0) +thinboard_corner_lefttop_gold.tga rect=(0,0,0,22) +thinboard_corner_righttop_gold.tga rect=(0,0,20.4375,0) +``` + +生成截图复现了用户图中的横向 Warrior 标题、国旗横条,以及横向/纵向重复的边框。重复数量受窗口尺寸、裁剪和对象复用顺序影响。 + +临时在两个 `Destroy()` 中恢复 `Initialize()`,以同一复现流程运行后,这些继承的扩展值和重复条带消失,四角色选角检查通过。实验结束后,临时源代码修改和诊断日志均已撤回;本次没有更新发布包。 + +证据保存在忽略的生成目录 `build/verification/pool-investigation/`:`before/slot0.png`、`after/slot0.png`、`before.log`、`after.log`、`login_select_repro.cpp` 和 `proposed-reset.patch`。 + +## 修复及验证建议 + +恢复基类、派生类销毁时的初始化。应保留 UI 边框正常使用的平铺功能。 + +先前测试直接进入选角,未覆盖登录图片对象回收。现有选角测试的白块、模型和字体断言也没有检测重复纹理,因此复现图异常时仍会通过。后续应增加对象复用状态断言、登录到选角的转换,以及标题/国旗绘制范围检查,并覆盖返回登录后再次选角。 diff --git a/runtime/login_view.py b/runtime/login_view.py index 7dbcdb93..6338f403 100644 --- a/runtime/login_view.py +++ b/runtime/login_view.py @@ -17,6 +17,7 @@ class LoginView(object): net.SetAccountConnectorHandler(self) net.SetPhaseWindow(net.PHASE_WINDOW_LOGIN, self) net.SetPhaseWindow(net.PHASE_WINDOW_SELECT, self) + net.SetPhaseWindow(net.PHASE_WINDOW_LOAD, self) net.SetPhaseWindow(net.PHASE_WINDOW_GAME, self) def Connect(self, game_host, game_port, auth_host, auth_port, account, password): @@ -69,6 +70,11 @@ class LoginView(object): self.phase = 'loading' self.message = 'Server accepted selection. Loading game...' + def LoadData(self, playerX, playerY): + self.phase = 'loading' + self.message = 'Character loaded at (%d, %d). Starting game...' % (playerX, playerY) + net.StartGame() + def SetGamePhase(self): self.phase = 'game' self.message = 'In game phase.' @@ -89,9 +95,15 @@ class LoginView(object): def Enter(self): if self.selected < 0: raise ValueError('Choose an occupied character slot first') - net.SendSelectCharacterPacket(self.selected) + port = net.GetAccountCharacterSlotDataInteger(self.selected, net.ACCOUNT_CHARACTER_SLOT_PORT) + addr = net.GetAccountCharacterSlotDataInteger(self.selected, net.ACCOUNT_CHARACTER_SLOT_ADDR) + if port != 0 and addr != 0: + net.DirectEnter(self.selected) + self.message = "DirectEnter sent. Reconnecting to map server and loading..." + else: + net.SendSelectCharacterPacket(self.selected) + self.message = "Selection sent. Waiting for server loading phase..." self.phase = 'entering' - self.message = 'Selection sent. Waiting for server loading phase...' def Snapshot(self): slots = [] diff --git a/sdk b/sdk new file mode 160000 index 00000000..86759bb7 --- /dev/null +++ b/sdk @@ -0,0 +1 @@ +Subproject commit 86759bb726af6d40a7f16ff2f896d62ecc0f11c6 diff --git a/src/eter_effect/EffectInstance.cpp b/src/eter_effect/EffectInstance.cpp index e18b1620..f09ad72c 100644 --- a/src/eter_effect/EffectInstance.cpp +++ b/src/eter_effect/EffectInstance.cpp @@ -22,6 +22,15 @@ EffectInstance::EffectInstance(std::shared_ptr data) EffectInstance::~EffectInstance() = default; void EffectInstance::SetPosition(float x, float y, float z) { + // Attached particles follow their owner; non-attached trails remain in world space. + if (m_data) for (size_t i = 0; i < m_emitters.size(); ++i) { + if (!m_data->GetParticles()[i].particle.attach_enable) continue; + for (auto& p : m_emitters[i].particles) for (int axis = 0; axis < 3; ++axis) { + const float next[3] = {x,y,z}; + const float delta = next[axis] - m_position[axis]; + p.pos[axis] += delta; p.last_pos[axis] += delta; + } + } m_position[0] = x; m_position[1] = y; m_position[2] = z; @@ -99,6 +108,9 @@ void EffectInstance::Update(float dt) { } for (int s = 0; s < toSpawn && s < 20; ++s) { + // MaxEmissionCount is the number of live particles, including + // looping emitters (the GM marker has exactly one particle). + if (inst.particles.size() >= maxEmission) break; ParticleState p; p.life = 0.0f; p.max_life = InterpolateTimeEvent(pe.emitter.time_life_time, cycleTime, 0.5f); @@ -126,10 +138,8 @@ void EffectInstance::Update(float dt) { float dirX = InterpolateTimeEvent(pe.emitter.time_emitting_dir_x, cycleTime, pe.emitter.emitting_direction[0]); float dirY = InterpolateTimeEvent(pe.emitter.time_emitting_dir_y, cycleTime, pe.emitter.emitting_direction[1]); float dirZ = InterpolateTimeEvent(pe.emitter.time_emitting_dir_z, cycleTime, pe.emitter.emitting_direction[2]); - float dirLen = std::sqrt(dirX * dirX + dirY * dirY + dirZ * dirZ); - if (dirLen > 1e-4f) { - dirX /= dirLen; dirY /= dirLen; dirZ /= dirLen; - } + // AVA2 adds the scripted direction vector and then multiplies by + // velocity. Its magnitude is intentional (GM: 14.948454 * 3). // Transform velocity vector by rotation matrix float worldDirX = dirX * m_matrix[0] + dirY * m_matrix[4] + dirZ * m_matrix[8]; @@ -169,7 +179,8 @@ void EffectInstance::Update(float dt) { // Gravity float grav = InterpolateTimeEvent(pe.particle.time_gravity, t, 0.0f); - it->vel[1] -= grav * 9.8f * dt; + // AVA2 CGravityDecorator: script gravity is already acceleration. + it->vel[1] -= grav * dt; // Air resistance float airRes = InterpolateTimeEvent(pe.particle.time_air_resistance, t, 0.0f); @@ -271,8 +282,14 @@ void EffectInstance::BuildDrawCommands(const float* viewMatrix, const float* pro const auto& p = inst.particles[pIdx]; if (p.color[3] <= 0.001f) continue; - float hx = baseSizeX * p.scale[0] * 0.5f; - float hy = baseSizeY * p.scale[1] * 0.5f; + // AVA2 scripts specify half sizes, not full dimensions. + float hx = baseSizeX * p.scale[0]; + float hy = baseSizeY * p.scale[1]; + if (pe.particle.billboard_type <= 1 && !pe.particle.stretch_enable) { + // CParticleInstance::Transform places size Y on the camera + // cross axis (texture U), and size X on camera up (texture V). + std::swap(hx, hy); + } float right[3] = {camRight[0], camRight[1], camRight[2]}; float up[3] = {camUp[0], camUp[1], camUp[2]}; @@ -318,7 +335,7 @@ void EffectInstance::BuildDrawCommands(const float* viewMatrix, const float* pro float p0[3] = {p.pos[0] - right[0]*hx - up[0]*hy, p.pos[1] - right[1]*hx - up[1]*hy, p.pos[2] - right[2]*hx - up[2]*hy}; float p1[3] = {p.pos[0] + right[0]*hx - up[0]*hy, p.pos[1] + right[1]*hx - up[1]*hy, p.pos[2] + right[2]*hx - up[2]*hy}; float p2[3] = {p.pos[0] + right[0]*hx + up[0]*hy, p.pos[1] + right[1]*hx + up[1]*hy, p.pos[2] + right[2]*hx + up[2]*hy}; - float p3[3] = {p.pos[0] - right[0]*hx + up[0]*hy, p.pos[1] - right[1]*hx + up[0]*hy, p.pos[2] - right[2]*hx + up[2]*hy}; + float p3[3] = {p.pos[0] - right[0]*hx + up[0]*hy, p.pos[1] - right[1]*hx + up[1]*hy, p.pos[2] - right[2]*hx + up[2]*hy}; uint8_t cr = static_cast(std::clamp(p.color[0] * 255.0f, 0.0f, 255.0f)); uint8_t cg = static_cast(std::clamp(p.color[1] * 255.0f, 0.0f, 255.0f)); diff --git a/src/eter_image/GrpExpandedImageInstance.h b/src/eter_image/GrpExpandedImageInstance.h index f37fe902..ae21cb22 100644 --- a/src/eter_image/GrpExpandedImageInstance.h +++ b/src/eter_image/GrpExpandedImageInstance.h @@ -37,6 +37,7 @@ public: void Destroy() { CGraphicImageInstance::Destroy(); + Initialize(); } void SetDepth(float fDepth) { m_fDepth = fDepth; } diff --git a/src/eter_image/GrpImageInstance.h b/src/eter_image/GrpImageInstance.h index f6907287..bad49d7c 100644 --- a/src/eter_image/GrpImageInstance.h +++ b/src/eter_image/GrpImageInstance.h @@ -30,6 +30,7 @@ public: void Destroy() { m_roImage.Clear(); + Initialize(); } void Render() diff --git a/src/eter_image/MarkManager.cpp b/src/eter_image/MarkManager.cpp index d567bce4..21589cdc 100644 --- a/src/eter_image/MarkManager.cpp +++ b/src/eter_image/MarkManager.cpp @@ -27,7 +27,7 @@ std::string FindMarkFile(const std::string& relPath) { relPath, "build/dev/" + relPath, "../" + relPath, - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/" + relPath + "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/" + relPath }; for (const auto& c : candidates) { if (std::filesystem::exists(c)) return c; diff --git a/src/eter_net/NetworkActorManager.cpp b/src/eter_net/NetworkActorManager.cpp index 2c32b9ee..84cdaeaa 100644 --- a/src/eter_net/NetworkActorManager.cpp +++ b/src/eter_net/NetworkActorManager.cpp @@ -15,6 +15,28 @@ namespace ava2 { namespace { +// AVA2 InstanceBase.cpp SHORSE::Create / __AttachHorseSaddle: mounts are +// separate actors, and the rider's main model follows their "saddle" bone. +void ConfigureMount(SNetworkActorData& data) { + if (!data.m_pActorInstance || data.m_mountRaceRequested == data.m_dwMountVnum) return; + data.m_mountRaceRequested = data.m_dwMountVnum; + data.m_pMountInstance.reset(); + auto& rider=*data.m_pActorInstance; + rider.SetModelYOffset(0); + if (data.m_dwMountVnum) { + auto mount=std::make_shared(); + if (mount->SetRace(data.m_dwMountVnum)) { + mount->SetShape(0);mount->SetScale(rider.GetScale()); + mount->SetYaw(rider.GetYaw());mount->SetPosition(rider.GetX(),rider.GetY(),rider.GetZ()); + mount->PlayMotion(MotionType::Wait,true); + data.m_pMountInstance=std::move(mount); + } + } + const uint16_t mode=data.m_pMountInstance ? 9 : 1; + rider.SetMotionMode(mode); + rider.PlayMotion(MotionType::Wait,true); +} + // InstanceBaseEffect.cpp g_akD3DXClrName / g_akD3DXClrTitle / g_TitleNameMap: zero (transparent // black) until introLoading.__main__ registers them through chrmgr. std::array& NameColors() { static std::array s{}; return s; } @@ -26,7 +48,7 @@ bool (*s_getItemScale)(uint32_t, uint32_t, float[3], float[3]) = nullptr; bool (*s_getItemData)(uint32_t, SItemModelData*) = nullptr; void (*s_onSetPlayerAffect)(unsigned) = nullptr; void (*s_onResetPlayerAffect)(unsigned) = nullptr; -bool s_hairColorEnable = false; // InstanceBase.cpp HAIR_COLOR_ENABLE=FALSE until app.SetHairColorEnable +bool s_hairColorEnable = true; // Enabled by default so hair meshes load without requiring explicit app.SetHairColorEnable bool s_armorSpecular = false; // USE_ARMOR_SPECULAR=FALSE until app.SetArmorSpecularEnable bool GetItemData(uint32_t vnum, SItemModelData* out) { return s_getItemData && s_getItemData(vnum, out); } @@ -480,6 +502,7 @@ void NetworkActorManager::AppendActor(const SNetworkActorData& data) { } } actor->PlayMotion(MotionType::Wait, true); + ConfigureMount(actorData); // AVA2 InstanceBase::SetAffect(AFFECT_STUN=5) controls the sleep action flag. actor->SetSleep((data.m_affectFlags[0] & (1u<<5))!=0); @@ -487,7 +510,8 @@ void NetworkActorManager::AppendActor(const SNetworkActorData& data) { // Register TextTail overhead display auto& tt = TextTailManager::Instance(); // AttachTextTail registers white; RefreshTextTail below applies GetNameColor/title. - tt.RegisterCharacterTextTail(data.m_dwGuildID, data.m_dwVID, 0xFFFFFFFF); + tt.RegisterCharacterTextTail(data.m_dwGuildID, data.m_dwVID, 0xFFFFFFFF, + actor->GetHeightOffset() * actor->GetScale() + 10.0f); tt.SetCharacterName(data.m_dwVID, data.m_stName); tt.SetCharacterPosition(data.m_dwVID, worldX, worldY, worldZ); @@ -560,6 +584,7 @@ void NetworkActorManager::UpdateActor(const SNetworkUpdateActorData& data) { actorData.m_dwMountVnum = data.m_dwMountVnum; actorData.m_dwMovSpd = data.m_dwMovSpd; actorData.m_dwAtkSpd = data.m_dwAtkSpd; + ConfigureMount(actorData); // CNetworkActorManager::UpdateActor: ChangeArmor, ChangeWeapon(weapon, arrow), ChangeHair, ChangeSash. ChangeArmor(actorData, data.m_dwArmor); @@ -698,6 +723,22 @@ void NetworkActorManager::Update(float dt, const TerrainHeightSource* terrain) { } actorData.m_pActorInstance->Update(dt, terrain); + if (actorData.m_pMountInstance) { + auto& mount=*actorData.m_pMountInstance; + auto& rider=*actorData.m_pActorInstance; + mount.SetPosition(rider.GetX(),rider.GetY(),rider.GetZ()); + mount.SetYaw(rider.GetYaw()); + const auto motion=rider.GetCurrentMotion(); + if (mount.GetCurrentMotion()!=motion && (motion==MotionType::Wait || motion==MotionType::Walk || motion==MotionType::Run)) + mount.PlayMotion(motion,true); + mount.Update(dt,terrain); + float sx,sy,sz; + if(mount.GetBonePosition("saddle",sx,sy,sz))rider.SetModelYOffset((sy-rider.GetY())/rider.GetScale()); + } + // Keep labels on the actual rendered owner, including local movement + // and actors whose incoming Z=0 must be grounded on the terrain. + const auto& owner = *actorData.m_pActorInstance; + TextTailManager::Instance().SetCharacterPosition(vid, owner.GetX(), owner.GetY()+owner.GetModelYOffset()*owner.GetScale(), owner.GetZ()); auto& effects = actorData.m_attachedEffects; for (auto e = effects.begin(); e != effects.end();) { @@ -852,12 +893,29 @@ std::shared_ptr NetworkActorManager::GetActorInstance(uint32_t vi return (it != m_actors.end()) ? it->second.m_pActorInstance : nullptr; } -std::vector NetworkActorManager::BuildDrawCommands(float animTime) { +std::vector NetworkActorManager::BuildDrawCommands(float animTime, const float* view, const float* proj) { (void)animTime; std::vector allDraws; for (auto& [vid, actorData] : m_actors) { if (!actorData.m_pActorInstance || actorData.m_isHidden) continue; - auto actorDraws = actorData.m_pActorInstance->BuildDrawCommands(); + if (!IsMainActorVID(vid) && !actorData.m_pActorInstance->IsVisible(view,proj) + && (!actorData.m_pMountInstance || !actorData.m_pMountInstance->IsVisible(view,proj))) continue; + float saddle[16]; + const float* riderWorld=nullptr; + if (actorData.m_pMountInstance) { + auto mountDraws=actorData.m_pMountInstance->BuildDrawCommands(); + for (auto& d:mountDraws)allDraws.push_back(std::move(d)); + if(actorData.m_pMountInstance->GetBoneWorldTransform("saddle",saddle)) { + // Inverse of the SDK's Granny-to-engine basis on the left: + // BuildDrawCommands applies that basis to rider mesh coordinates. + for(int col=0;col<4;++col) { + const float y=saddle[4+col], z=saddle[8+col]; + saddle[4+col]=z;saddle[8+col]=-y; + } + riderWorld=saddle; + } + } + auto actorDraws = actorData.m_pActorInstance->BuildDrawCommands(riderWorld); for (auto& d : actorDraws) { allDraws.push_back(std::move(d)); } diff --git a/src/eter_net/NetworkActorManager.h b/src/eter_net/NetworkActorManager.h index 2dfe47fa..4a7b6332 100644 --- a/src/eter_net/NetworkActorManager.h +++ b/src/eter_net/NetworkActorManager.h @@ -24,6 +24,7 @@ struct SAttachedEffect { struct SNetworkActorData { uint32_t m_dwVID = 0; + bool m_isScriptInstance = false; // showcase uses reflected native Y coordinates std::string m_stName; uint8_t m_bType = 0; // 0=Mob, 1=NPC, 6=PC uint32_t m_dwRace = 0; @@ -85,6 +86,8 @@ struct SNetworkActorData { bool m_isHidden = false; std::shared_ptr m_pActorInstance; + std::shared_ptr m_pMountInstance; + uint32_t m_mountRaceRequested = 0; }; // CInstanceBase::IsGameMaster: a "[" in the name or AFFECT_YMIR. @@ -280,7 +283,7 @@ public: } // Helpers to build 3D rendering draw calls for all visible network actors - std::vector BuildDrawCommands(float animTime); + std::vector BuildDrawCommands(float animTime, const float* view = nullptr, const float* proj = nullptr); private: uint32_t m_mainVID = 0; diff --git a/src/eter_net/Packet.h b/src/eter_net/Packet.h index a30cec53..417a7899 100644 --- a/src/eter_net/Packet.h +++ b/src/eter_net/Packet.h @@ -1091,6 +1091,7 @@ struct TPacketGCOfflineShopUpdateItem { char title[46];int64_t price;TShopLog log;uint64_t flag;int32_t time;uint32_t type; }; struct TOfflineShopItemTable { uint32_t vnum;int32_t count;TItemPos pos;int64_t price;uint8_t display_pos; }; +struct TOfflineShopAddItem { TItemPos bDisplayPos; uint8_t bPos; int64_t lPrice; }; struct TPacketCGMyOfflineShop { uint8_t bHeader;char szSign[46];uint8_t bCount;uint32_t shopVnum;uint8_t shopTitle; }; struct TShopDecoration {char sign[46];uint32_t owner_id;uint8_t vnum,type;}; struct TPacketGCShopSearchItemSet { uint8_t header;uint32_t size; }; diff --git a/src/eter_net/PythonNetworkStream.cpp b/src/eter_net/PythonNetworkStream.cpp index 3690d648..ce4d08b5 100644 --- a/src/eter_net/PythonNetworkStream.cpp +++ b/src/eter_net/PythonNetworkStream.cpp @@ -1,6 +1,7 @@ #include "item_sound.h" #include "python_item.h" #include "PythonNetworkStream.h" +#include "player_settings.h" #include "python_net.h" #include "guild_state.h" #include "switchbot_state.h" @@ -489,6 +490,9 @@ void PythonNetworkStream::MainCharacterLoaded(int32_t x,int32_t y,int32_t z) { WarpBackgroundMap(uint32_t(x),uint32_t(y)); int32_t localX=x,localY=y; GlobalToLocalPosition(localX,localY); SetPlayerRace(m_wMainActorRace); + // Skill levels can arrive during Loading, before GameWindow registers its + // skill slots. Register on the main-character packet so levels aren't lost. + RegisterPlayerSkills(uint8_t(m_wMainActorRace), m_byMainActorSkillGroup, m_byMainActorEmpire); SetMainCharacterName(m_strMainActorName);SetMainCharacterPosition(localX,localY,z); inventory_callback(m_phaseWindows[4],"LoadData",Py_BuildValue("ii",x,y)); std::vector version(67,0);version[0]=HEADER_CG_CLIENT_VERSION2; @@ -1221,6 +1225,30 @@ bool PythonNetworkStream::SendOfflineShopManagement(uint8_t operation,uint8_t po Send(bytes.data(),bytes.size());return true; } +bool PythonNetworkStream::SendAddOfflineShopItem(const TItemPos& bDisplayPos, uint8_t bPos, int64_t lPrice) { + std::vector bytes(58, 0); + bytes[0] = HEADER_CG_OFFLINE_SHOP; + bytes[1] = SHOP_SUBHEADER_CG_ADD_ITEM; + Send(bytes.data(), bytes.size()); + + TOfflineShopAddItem item{}; + item.bDisplayPos = bDisplayPos; + item.bPos = bPos; + item.lPrice = lPrice; + Send(&item, sizeof(item)); + return true; +} + +bool PythonNetworkStream::SendOfflineShopChangeTitle(const std::string& title) { + std::vector bytes(58, 0); + bytes[0] = HEADER_CG_OFFLINE_SHOP; + bytes[1] = SHOP_SUBHEADER_CG_CHANGE_TITLE; + size_t copyLen = std::min(title.size(), size_t(50)); + std::memcpy(&bytes[2], title.data(), copyLen); + Send(bytes.data(), bytes.size()); + return true; +} + bool PythonNetworkStream::SendCharacterMovePacket(uint8_t func, uint8_t arg, uint8_t rot, int32_t x, int32_t y, uint32_t time) { TPacketCGMove p; p.bHeader = HEADER_CG_MOVE; diff --git a/src/eter_net/PythonNetworkStream.h b/src/eter_net/PythonNetworkStream.h index a999ea8d..5655f119 100644 --- a/src/eter_net/PythonNetworkStream.h +++ b/src/eter_net/PythonNetworkStream.h @@ -74,6 +74,11 @@ public: bool SendBuildOfflineShopPacket(const std::string& name,const std::vector& items,uint32_t vnum,uint8_t title); bool SendOfflineShopChangeDecoration(const std::string& sign,uint32_t vnum,uint32_t type); bool SendOfflineShopManagement(uint8_t operation,uint8_t position=0,uint32_t owner=0); + bool SendAddOfflineShopItem(const TItemPos& bDisplayPos, uint8_t bPos, int64_t lPrice); + bool SendOfflineShopChangeTitle(const std::string& title); + bool SendTakeOfflineMoney() { return SendOfflineShopManagement(SHOP_SUBHEADER_CG_TAKE_MONEY); } + bool SendOfflineShopCheck() { return SendOfflineShopManagement(SHOP_SUBHEADER_CG_CHECK); } + bool SendOfflineShopButton() { return SendOfflineShopManagement(SHOP_SUBHEADER_CG_BUTTON); } bool SendQuickSlotAddPacket(uint8_t index,uint8_t type,uint8_t pos); bool SendQuickSlotDelPacket(uint8_t index); bool SendQuickSlotMovePacket(uint8_t source,uint8_t target); @@ -165,6 +170,7 @@ public: const std::vector& GetSendQueue() const { return m_sendBuffer; } std::vector PopSendBytes(); void ClearSendQueue() { m_sendBuffer.clear();m_sendPackets.clear(); } + const std::vector>& GetSendPackets() const { return m_sendPackets; } std::vector> PopSendPackets(); // Packets with whether the transport appends the sequence byte (SendSequence()). std::vector,bool>> PopSendPacketsWithSequence(); @@ -194,6 +200,7 @@ public: bool GetComboSkillFlag() const { return m_bComboSkillFlag; } // Windows calls PostQuitMessage(0); the host loop polls this instead. bool IsQuitRequested() const { return m_unknownPacketQuit; } + void RequestQuit() { m_unknownPacketQuit = true; } // GamePhase() headers Windows handles but this port skips (consumed, not dispatched). const std::vector& GetUnportedPackets() const { return m_unportedPackets; } diff --git a/src/eter_net/PythonNetworkStreamPhaseGameRecv.cpp b/src/eter_net/PythonNetworkStreamPhaseGameRecv.cpp index b5a8c309..bdc1c7ec 100644 --- a/src/eter_net/PythonNetworkStreamPhaseGameRecv.cpp +++ b/src/eter_net/PythonNetworkStreamPhaseGameRecv.cpp @@ -544,12 +544,7 @@ bool PythonNetworkStream::RecvMessenger() { bool PythonNetworkStream::RecvQuestInfoPacket() { uint8_t header,flags;uint16_t size,id; if(!Read(1,&header)||!Read(2,&size)||!Read(2,&id)||!Read(1,&flags))return false; - // Reject a declared payload shorter than its flag-selected fields before a - // read can consume the next packet. Windows assumes trusted server lengths. - const size_t required=6+bool(flags&QUEST_SEND_IS_BEGIN)+31*bool(flags&QUEST_SEND_TITLE)+ - 17*bool(flags&QUEST_SEND_CLOCK_NAME)+4*bool(flags&QUEST_SEND_CLOCK_VALUE)+ - 17*bool(flags&QUEST_SEND_COUNTER_NAME)+4*bool(flags&QUEST_SEND_COUNTER_VALUE)+25*bool(flags&QUEST_SEND_ICON_FILE); - if(size0) { + ClearChestDropInfo(chestVnum); for(uint32_t j=0;j ActorInstance::LoadPartModel(const std::string } void ActorInstance::SetMainModel(std::shared_ptr model, const std::string& path) { + m_boundsModel = nullptr; m_model = std::move(model); m_modelPath = m_model ? path : std::string(); RebindParts(); @@ -209,6 +210,7 @@ bool ActorInstance::SetModel(const std::string& modelPath) { std::cerr << "ActorInstance::SetModel file not found: " << modelPath << std::endl; return false; } + m_boundsModel = nullptr; m_model = Gr2ModelInstance::Load(resolved); if (!m_model) return false; m_modelPath = modelPath; @@ -254,9 +256,21 @@ bool ActorInstance::PlayMotion(MotionType type, bool loop) { it = m_motionPaths.find(MotionType::Attack); } } - if (it == m_motionPaths.end()) return false; - - std::string resolved = ResolvePath(it->second); + std::string motionPath; + // Resolve the active mode at playback time; SetRace/armor rebuilds must not + // silently replace riding motions with GENERAL standing/walking motions. + if (m_raceData && m_motionMode != 1) { + uint16_t actualMode = uint16_t(m_motionMode); + if (m_raceData->GetMotionKey(actualMode, uint16_t(type), &actualMode)) { + const auto* entries = m_raceData->GetMotions(actualMode, uint32_t(type)); + if (entries && !entries->empty()) motionPath = ReadMotionFileName(entries->front().fileName); + } + } + if (motionPath.empty()) { + if (it == m_motionPaths.end()) return false; + motionPath = it->second; + } + std::string resolved = ResolvePath(motionPath); if (!std::filesystem::exists(resolved)) return false; bool loaded = m_model->LoadExternalAnimation(resolved); @@ -568,11 +582,11 @@ bool ActorInstance::IsTargetInAttackRange(const ActorInstance& target, float max return diff <= maxAngleDeg; } -std::vector ActorInstance::BuildDrawCommands() { +std::vector ActorInstance::BuildDrawCommands(const float* worldOverride) { if (!m_model) return {}; float world[16]; - MakeTransformMatrix(m_yaw + 180.0f, m_posX, m_posY + m_modelYOffset * m_scale, m_posZ, m_scale, world); - auto draws = m_model->BuildDrawCommands(m_animTime, world); + MakeTransformMatrix(m_yaw, m_posX, m_posY + m_modelYOffset * m_scale, m_posZ, m_scale, world); + auto draws = m_model->BuildDrawCommands(m_animTime, worldOverride ? worldOverride : world); // Shining system (ENABLE_SHINING_SYSTEM): weapon aura / glow if (m_weaponShining > 0) { @@ -647,6 +661,26 @@ std::vector ActorInstance::BuildDrawCommands() { return draws; } +bool ActorInstance::IsVisible(const float* view, const float* proj) const { + if (!view || !proj || !m_model) return true; + if (m_boundsModel != m_model.get()) { + float loX,loY,loZ,hiX,hiY,hiZ; + m_boundsRadius = 500.f; + if (m_model->GetLocalBounds(loX,loY,loZ,hiX,hiY,hiZ)) { + const float x=std::max(std::abs(loX),std::abs(hiX)); + const float y=std::max(std::abs(loY),std::abs(hiY)); + const float z=std::max(std::abs(loZ),std::abs(hiZ)); + m_boundsRadius = std::sqrt(x*x+y*y+z*z)*2.f + 300.f; + } + m_boundsModel=m_model.get(); + } + const float r=m_boundsRadius*std::abs(m_scale); + const float y=m_posY+m_modelYOffset*m_scale; + const float lo[3]={m_posX-r,y-r,m_posZ-r}; + const float hi[3]={m_posX+r,y+r,m_posZ+r}; + return IsBoundsVisible(lo,hi,view,proj); +} + bool ActorInstance::HitTestScreen(float clickX, float clickY, const Gr2SceneRenderer& renderer, float tolerancePx) const { if (m_curHP <= 0) return false; float bx = 0.0f, by = 0.0f, hx = 0.0f, hy = 0.0f; @@ -673,8 +707,15 @@ bool ActorInstance::GetBoneWorldTransform(const std::string& boneName, float* ou if (!m_model->GetBoneWorldTransform(boneName, localBone, m_animTime)) { return false; } + // Bone poses are still Granny Z-up, just like the mesh vertices. Convert + // before composing with the engine world matrix (SDK R_GRANNY_TO_ENGINE). + for (int row=0;row<4;++row) { + const float y=localBone[row*4+1], z=localBone[row*4+2]; + localBone[row*4+1]=z; + localBone[row*4+2]=-y; + } float actorWorld[16]; - MakeTransformMatrix(m_yaw + 180.0f, m_posX, m_posY + m_modelYOffset * m_scale, m_posZ, m_scale, actorWorld); + MakeTransformMatrix(m_yaw, m_posX, m_posY + m_modelYOffset * m_scale, m_posZ, m_scale, actorWorld); for (int r = 0; r < 4; ++r) { for (int c = 0; c < 4; ++c) { diff --git a/src/eter_render/ActorInstance.h b/src/eter_render/ActorInstance.h index 3be118b5..93838833 100644 --- a/src/eter_render/ActorInstance.h +++ b/src/eter_render/ActorInstance.h @@ -133,6 +133,8 @@ public: void GetMoveTarget(float& tx, float& tz) const { tx = m_targetX; tz = m_targetZ; } // Screen picking test (returns true if 2D click hits projected 3D volume) + // Conservative bounds include animation/attachment margin; only render work is culled. + bool IsVisible(const float* view, const float* proj) const; bool HitTestScreen(float clickX, float clickY, const Gr2SceneRenderer& renderer, float tolerancePx = 40.0f) const; // Smooth movement and continuous animation update @@ -207,7 +209,7 @@ public: bool GetBoneWorldTransform(const std::string& boneName, float* outWorld16) const; // Generate 3D draw commands - std::vector BuildDrawCommands(); + std::vector BuildDrawCommands(const float* worldOverride = nullptr); Gr2ModelInstance* GetModel() { return m_model.get(); } const std::string& GetModelPath() const { return m_modelPath; } @@ -236,6 +238,8 @@ private: float m_sashScale[3] = {1.0f, 1.0f, 1.0f}; std::shared_ptr m_model; + mutable const Gr2ModelInstance* m_boundsModel = nullptr; + mutable float m_boundsRadius = 500.f; std::string m_modelPath; std::unordered_map m_motionPaths; diff --git a/src/eter_render/EnvironmentData.cpp b/src/eter_render/EnvironmentData.cpp index 026cd1f0..b195a623 100644 --- a/src/eter_render/EnvironmentData.cpp +++ b/src/eter_render/EnvironmentData.cpp @@ -49,7 +49,7 @@ bool EnvironmentData::LoadFromFile(const std::string& filepath) { "ymir work/environment/" + filepath, "build/dev/ymir work/environment/" + filepath, "/Users/shen/Work/Code/Metin2/ava2-client/ymir work/environment/" + filepath, - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/ETC/ymir work/environment/" + filepath + "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/ETC/ymir work/environment/" + filepath }; if (filepath.find('/') != std::string::npos || filepath.find('\\') != std::string::npos) { @@ -58,7 +58,7 @@ bool EnvironmentData::LoadFromFile(const std::string& filepath) { candidates.push_back("ymir work/environment/" + filename); candidates.push_back("build/dev/ymir work/environment/" + filename); candidates.push_back("/Users/shen/Work/Code/Metin2/ava2-client/ymir work/environment/" + filename); - candidates.push_back("/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/ETC/ymir work/environment/" + filename); + candidates.push_back("/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/ETC/ymir work/environment/" + filename); } for (const auto& path : candidates) { diff --git a/src/eter_render/Gr2ModelRenderer.cpp b/src/eter_render/Gr2ModelRenderer.cpp index de89dbd0..e3131efc 100644 --- a/src/eter_render/Gr2ModelRenderer.cpp +++ b/src/eter_render/Gr2ModelRenderer.cpp @@ -7,10 +7,12 @@ #include #include #include +#include namespace ava2 { namespace { +bool hardwareSkinningEnabled=false; inline void MultiplyMat4(const float* a, const float* b, float* out) { float r[16]; @@ -36,533 +38,172 @@ inline float EdgeFunction(float ax, float ay, float bx, float by, float cx, floa return (cx - ax) * (by - ay) - (cy - ay) * (bx - ax); } -// Basis change from Granny (Z-up, Y-forward) to Engine (Y-up, Z-forward): (x, y, z) -> (x, z, -y) -const float R_GRANNY_TO_ENGINE[16] = { - 1.0f, 0.0f, 0.0f, 0.0f, - 0.0f, 0.0f, -1.0f, 0.0f, - 0.0f, 1.0f, 0.0f, 0.0f, - 0.0f, 0.0f, 0.0f, 1.0f -}; +Render3DDraw ToRender3DDraw(gr2_render::Gr2MeshDraw&& mesh) { + Render3DDraw draw; + std::memcpy(draw.world, mesh.world, sizeof(draw.world)); + draw.gpu_skinning=mesh.gpu_skinning; + if(mesh.geometry) { + // Source owns immutable streams; converted geometry lives with frame/resident references. + struct Entry {std::weak_ptr source;std::weak_ptr converted;}; + static std::unordered_map cache; + auto& entry=cache[mesh.geometry.get()]; + if(entry.source.lock()==mesh.geometry)draw.geometry=entry.converted.lock(); + if(!draw.geometry){auto source=*mesh.geometry;draw.geometry=std::make_shared(ToRender3DDraw(std::move(source)));entry={mesh.geometry,draw.geometry};} + if(cache.size()>1024) { + for(auto it=cache.begin();it!=cache.end();) { + if(it->second.source.expired())it=cache.erase(it);else ++it; + } + } + } + draw.texture0 = std::move(mesh.texture0); + draw.texture1 = std::move(mesh.texture1); + draw.positions = std::move(mesh.positions); + draw.normals = std::move(mesh.normals); + draw.uv0 = std::move(mesh.uv0); + draw.diffuse = std::move(mesh.diffuse); + draw.indices = std::move(mesh.indices); + draw.bone_indices = std::move(mesh.bone_indices); + draw.bone_weights = std::move(mesh.bone_weights); + draw.bone_matrices = std::move(mesh.bone_matrices); + draw.alpha_test = mesh.alpha_test; + draw.alpha_ref = mesh.alpha_ref; + draw.cull_mode = mesh.double_sided ? 1 : 2; + draw.z_write = mesh.z_write; + draw.lighting = mesh.lighting; + return draw; +} } // namespace std::unique_ptr Gr2ModelInstance::Load(const std::string& filepath) { - gr2::LoadError err; - auto file_opt = gr2::File::load_path(filepath, &err); - if (!file_opt) { - std::cerr << "Gr2ModelInstance::Load failed: [" << err.stage << "] " << err.message << " for " << filepath << std::endl; - return nullptr; - } + auto impl = gr2_render::Gr2ModelInstance::Load(filepath); + if (!impl) return nullptr; + auto inst = std::make_unique(); + inst->m_impl = std::shared_ptr(std::move(impl)); + return inst; +} - auto instance = std::make_unique(); - instance->m_file = std::make_unique(std::move(*file_opt)); - instance->m_filepath = filepath; - return instance; +std::unique_ptr Gr2ModelInstance::LoadFromMemory(const uint8_t* data, size_t size, const std::string& name) { + auto impl = gr2_render::Gr2ModelInstance::LoadFromMemory(data, size, name); + if (!impl) return nullptr; + auto inst = std::make_unique(); + inst->m_impl = std::shared_ptr(std::move(impl)); + return inst; } bool Gr2ModelInstance::LoadExternalAnimation(const std::string& anim_filepath) { - gr2::LoadError err; - auto file_opt = gr2::File::load_path(anim_filepath, &err); - if (!file_opt) { - std::cerr << "Gr2ModelInstance::LoadExternalAnimation failed: [" << err.stage << "] " << err.message << " for " << anim_filepath << std::endl; - return false; - } - if (file_opt->file_info().animations.empty()) { - std::cerr << "Gr2ModelInstance::LoadExternalAnimation: no animations in " << anim_filepath << std::endl; - return false; - } - m_anim_file = std::make_unique(std::move(*file_opt)); - m_anim_filepath = anim_filepath; - return true; + return m_impl ? m_impl->LoadExternalAnimation(anim_filepath) : false; } float Gr2ModelInstance::GetAnimationDuration() const { - if (m_anim_file && !m_anim_file->file_info().animations.empty()) { - return m_anim_file->file_info().animations[0].duration; - } - if (m_file && !m_file->file_info().animations.empty()) { - return m_file->file_info().animations[0].duration; - } - return 0.0f; + return m_impl ? m_impl->GetAnimationDuration() : 0.0f; } bool Gr2ModelInstance::GetBoneWorldTransform(const std::string& bone_name, float* out_matrix, float animation_time) const { - if (!m_file || m_file->file_info().skeletons.empty() || !out_matrix) return false; - const auto& sk = m_file->file_info().skeletons[0]; - int target_bone = -1; - for (size_t i = 0; i < sk.bones.size(); ++i) { - if (sk.bones[i].name == bone_name) { - target_bone = static_cast(i); - break; - } - } - if (target_bone < 0) return false; - - std::vector world_pose; - std::vector skin_matrices; - const gr2::Animation* anim = nullptr; - if (m_anim_file && !m_anim_file->file_info().animations.empty()) { - anim = &m_anim_file->file_info().animations[0]; - } else if (!m_file->file_info().animations.empty()) { - anim = &m_file->file_info().animations[0]; - } - - if (animation_time >= 0.0f && anim) { - gr2::sample_pose(sk, *anim, animation_time, world_pose, skin_matrices); - } else { - gr2::bind_pose(sk, world_pose, skin_matrices); - } - - if (target_bone >= 0 && target_bone < static_cast(world_pose.size())) { - std::copy(world_pose[target_bone].data(), world_pose[target_bone].data() + 16, out_matrix); - return true; - } - return false; + return m_impl ? m_impl->GetBoneWorldTransform(bone_name, out_matrix, animation_time) : false; } void Gr2ModelInstance::AttachModel(const std::string& bone_name, std::shared_ptr attachment, const float* offset_matrix) { - if (!attachment) return; - for (auto& existing : m_attached_models) { - if (existing.bone_name == bone_name) { - existing.model = attachment; - if (offset_matrix) { - std::copy(offset_matrix, offset_matrix + 16, existing.offset); - } else { - for (int i = 0; i < 16; ++i) existing.offset[i] = (i % 5 == 0) ? 1.0f : 0.0f; - } - return; - } + if (m_impl) { + m_impl->AttachModel(bone_name, attachment ? attachment->GetImpl() : nullptr, offset_matrix); } - AttachedModel am; - am.bone_name = bone_name; - am.model = attachment; - if (offset_matrix) { - std::copy(offset_matrix, offset_matrix + 16, am.offset); - } else { - for (int i = 0; i < 16; ++i) am.offset[i] = (i % 5 == 0) ? 1.0f : 0.0f; + if (attachment) { + m_attached_models.push_back(attachment); } - m_attached_models.push_back(std::move(am)); } void Gr2ModelInstance::AttachPart(std::shared_ptr part) { - if (part) m_attached_parts.push_back(part); -} - -void Gr2ModelInstance::DetachModel(const std::string& bone_name) { - m_attached_models.erase(std::remove_if(m_attached_models.begin(), m_attached_models.end(), - [&](const AttachedModel& am) { return am.bone_name == bone_name; }), m_attached_models.end()); -} - -void Gr2ModelInstance::DetachPart(const std::shared_ptr& part) { - m_attached_parts.erase(std::remove(m_attached_parts.begin(), m_attached_parts.end(), part), m_attached_parts.end()); -} - -void Gr2ModelInstance::SetAttachmentAnimated(const std::string& bone_name, bool animated) { - for (auto& am : m_attached_models) - if (am.bone_name == bone_name) am.animated = animated; -} - -void Gr2ModelInstance::SetAttachmentScale(const std::string& bone_name, float sx, float sy, float sz) { - for (auto& am : m_attached_models) { - if (am.bone_name != bone_name) continue; - am.scaled = true; - am.scale[0] = sx; am.scale[1] = sy; am.scale[2] = sz; + if (m_impl) { + m_impl->AttachPart(part ? part->GetImpl() : nullptr); } -} - -namespace { -// CFileNameHelper::StringPath (lower case, '\\' -> '/'), the form CGrannyMaterial::IsIn compares. -std::string SkinKey(std::string path) { - for (auto& c : path) { - if (c == '\\') c = '/'; - else if (static_cast(c) < 128) c = static_cast(std::tolower(static_cast(c))); - } - return path; -} -} // namespace - -void Gr2ModelInstance::SetSkin(const std::string& src_file_name, const std::string& dst_file_name) { - m_skins[SkinKey(src_file_name)] = dst_file_name; -} - -void Gr2ModelInstance::ApplySkins(std::vector& draws, size_t first) const { - if (m_skins.empty()) return; - for (size_t i = first; i < draws.size(); ++i) { - auto it = m_skins.find(SkinKey(draws[i].texture0)); - if (it != m_skins.end()) draws[i].texture0 = it->second; + if (part) { + m_attached_parts.push_back(part); } } void Gr2ModelInstance::DetachAll() { + if (m_impl) { + m_impl->DetachAll(); + } m_attached_models.clear(); m_attached_parts.clear(); } -std::vector Gr2ModelInstance::BuildDrawCommandsWithPalette(const std::vector& skin_matrices, - const float* world_matrix, - const gr2::Skeleton* parent_skeleton) { - std::vector draws; - if (!m_file) return draws; - - const auto& info = m_file->file_info(); - bool has_skin = !skin_matrices.empty(); - - // Map this model's skeleton bones to parent skeleton bones by name if a parent skeleton is provided - std::vector part_to_parent_bone_map; - if (parent_skeleton && !info.skeletons.empty()) { - const auto& my_skel = info.skeletons[0]; - part_to_parent_bone_map.resize(my_skel.bones.size(), -1); - for (size_t b = 0; b < my_skel.bones.size(); ++b) { - const std::string& bname = my_skel.bones[b].name; - for (size_t pb = 0; pb < parent_skeleton->bones.size(); ++pb) { - if (parent_skeleton->bones[pb].name == bname) { - part_to_parent_bone_map[b] = static_cast(pb); - break; - } - } - } +void Gr2ModelInstance::DetachModel(const std::string& bone_name) { + if (m_impl) { + m_impl->DetachModel(bone_name); } - - for (const auto& mesh : info.meshes) { - std::vector skinned_positions; - std::vector skinned_normals; - std::vector uvs; - skinned_positions.reserve(mesh.vertices.size() * 3); - skinned_normals.reserve(mesh.vertices.size() * 3); - uvs.reserve(mesh.vertices.size() * 2); - - // Precompute mapped bone bindings for this mesh - std::vector effective_bone_bindings(mesh.bone_bindings.size()); - for (size_t i = 0; i < mesh.bone_bindings.size(); ++i) { - int raw_bone = mesh.bone_bindings[i]; - if (!part_to_parent_bone_map.empty() && raw_bone >= 0 && raw_bone < static_cast(part_to_parent_bone_map.size())) { - effective_bone_bindings[i] = part_to_parent_bone_map[raw_bone]; - } else { - effective_bone_bindings[i] = raw_bone; - } - } - - bool is_rigid_single_bone = (mesh.bone_bindings.size() == 1); - int single_bone_target = is_rigid_single_bone ? effective_bone_bindings[0] : -1; - - for (const auto& v : mesh.vertices) { - float px = 0.0f, py = 0.0f, pz = 0.0f; - float nx = 0.0f, ny = 0.0f, nz = 0.0f; - float total_w = 0.0f; - - if (has_skin) { - if (is_rigid_single_bone && v.bone_weight[0] == 0) { - // Rigid mesh attached 100% to a single bone (e.g. warrior face, hair, helmet) - if (single_bone_target >= 0 && single_bone_target < static_cast(skin_matrices.size())) { - const auto& M = skin_matrices[single_bone_target]; - px = v.pos[0] * M[0] + v.pos[1] * M[4] + v.pos[2] * M[8] + M[12]; - py = v.pos[0] * M[1] + v.pos[1] * M[5] + v.pos[2] * M[9] + M[13]; - pz = v.pos[0] * M[2] + v.pos[1] * M[6] + v.pos[2] * M[10] + M[14]; - - nx = v.normal[0] * M[0] + v.normal[1] * M[4] + v.normal[2] * M[8]; - ny = v.normal[0] * M[1] + v.normal[1] * M[5] + v.normal[2] * M[9]; - nz = v.normal[0] * M[2] + v.normal[1] * M[6] + v.normal[2] * M[10]; - total_w = 1.0f; - } - } else if (v.bone_weight[0] > 0) { - for (int b = 0; b < 4; ++b) { - if (v.bone_weight[b] == 0) continue; - float w = v.bone_weight[b] / 255.0f; - int local_slot = v.bone_index[b]; - int sk_bone = (local_slot < static_cast(effective_bone_bindings.size())) ? effective_bone_bindings[local_slot] : local_slot; - if (sk_bone >= 0 && sk_bone < static_cast(skin_matrices.size())) { - const auto& M = skin_matrices[sk_bone]; - px += (v.pos[0] * M[0] + v.pos[1] * M[4] + v.pos[2] * M[8] + M[12]) * w; - py += (v.pos[0] * M[1] + v.pos[1] * M[5] + v.pos[2] * M[9] + M[13]) * w; - pz += (v.pos[0] * M[2] + v.pos[1] * M[6] + v.pos[2] * M[10] + M[14]) * w; - - nx += (v.normal[0] * M[0] + v.normal[1] * M[4] + v.normal[2] * M[8]) * w; - ny += (v.normal[0] * M[1] + v.normal[1] * M[5] + v.normal[2] * M[9]) * w; - nz += (v.normal[0] * M[2] + v.normal[1] * M[6] + v.normal[2] * M[10]) * w; - total_w += w; - } - } - } - } - - if (total_w < 1e-4f) { - px = v.pos[0]; py = v.pos[1]; pz = v.pos[2]; - nx = v.normal[0]; ny = v.normal[1]; nz = v.normal[2]; - } - - skinned_positions.push_back(px); - skinned_positions.push_back(py); - skinned_positions.push_back(pz); - - skinned_normals.push_back(nx); - skinned_normals.push_back(ny); - skinned_normals.push_back(nz); - - uvs.push_back(v.uv0[0]); - uvs.push_back(v.uv0[1]); - } - - float effective_world[16]; - if (world_matrix) { - MultiplyMat4(R_GRANNY_TO_ENGINE, world_matrix, effective_world); - } else { - std::copy(R_GRANNY_TO_ENGINE, R_GRANNY_TO_ENGINE + 16, effective_world); - } - - if (mesh.tri_groups.empty()) { - Render3DDraw draw; - std::copy(effective_world, effective_world + 16, draw.world); - draw.positions = skinned_positions; - draw.normals = skinned_normals; - draw.uv0 = uvs; - draw.indices = mesh.indices; - if (!mesh.material_textures.empty()) - draw.texture0 = mesh.material_textures[0]; - if (draw.texture0.find("hair") != std::string::npos || mesh.name.find("hair") != std::string::npos || - draw.texture0.find("leaf") != std::string::npos || draw.texture0.find("tree") != std::string::npos) { - draw.alpha_test = true; - draw.alpha_ref = 70; - } - draws.push_back(std::move(draw)); - } else { - for (const auto& group : mesh.tri_groups) { - Render3DDraw draw; - std::copy(effective_world, effective_world + 16, draw.world); - draw.positions = skinned_positions; - draw.normals = skinned_normals; - draw.uv0 = uvs; - - std::size_t start_idx = static_cast(group.tri_first * 3); - std::size_t count_idx = static_cast(group.tri_count * 3); - if (start_idx + count_idx <= mesh.indices.size()) { - draw.indices.assign(mesh.indices.begin() + start_idx, - mesh.indices.begin() + start_idx + count_idx); - } - - if (group.material_index >= 0 && group.material_index < static_cast(mesh.material_textures.size())) { - draw.texture0 = mesh.material_textures[group.material_index]; - } - if (draw.texture0.find("hair") != std::string::npos || mesh.name.find("hair") != std::string::npos || - draw.texture0.find("leaf") != std::string::npos || draw.texture0.find("tree") != std::string::npos) { - draw.alpha_test = true; - draw.alpha_ref = 70; - } - draws.push_back(std::move(draw)); - } - } - } - ApplySkins(draws, 0); - return draws; } -std::vector Gr2ModelInstance::BuildDrawCommands(float animation_time, const float* world_matrix) { - std::vector draws; - if (!m_file) return draws; - - const auto& info = m_file->file_info(); - std::vector world_pose; - std::vector skin_matrices; - - const gr2::Animation* anim = nullptr; - if (m_anim_file && !m_anim_file->file_info().animations.empty()) { - anim = &m_anim_file->file_info().animations[0]; - } else if (!info.animations.empty()) { - anim = &info.animations[0]; +void Gr2ModelInstance::DetachPart(const std::shared_ptr& part) { + if (m_impl) { + m_impl->DetachPart(part ? part->GetImpl() : nullptr); } - - bool has_skeleton = !info.skeletons.empty(); - if (has_skeleton) { - if (animation_time >= 0.0f && anim) { - gr2::sample_pose(info.skeletons[0], *anim, animation_time, world_pose, skin_matrices); - } else { - gr2::bind_pose(info.skeletons[0], world_pose, skin_matrices); + if (part) { + auto it = std::find(m_attached_parts.begin(), m_attached_parts.end(), part); + if (it != m_attached_parts.end()) { + m_attached_parts.erase(it); } } +} - // 1. Build main model draw commands - for (const auto& mesh : info.meshes) { - std::vector skinned_positions; - std::vector skinned_normals; - std::vector uvs; - skinned_positions.reserve(mesh.vertices.size() * 3); - skinned_normals.reserve(mesh.vertices.size() * 3); - uvs.reserve(mesh.vertices.size() * 2); - - for (const auto& v : mesh.vertices) { - float px = 0.0f, py = 0.0f, pz = 0.0f; - float nx = 0.0f, ny = 0.0f, nz = 0.0f; - float total_w = 0.0f; - - if (has_skeleton && !skin_matrices.empty() && (v.bone_weight[0] > 0)) { - for (int b = 0; b < 4; ++b) { - if (v.bone_weight[b] == 0) continue; - float w = v.bone_weight[b] / 255.0f; - int local_slot = v.bone_index[b]; - int sk_bone = (local_slot < static_cast(mesh.bone_bindings.size())) ? mesh.bone_bindings[local_slot] : local_slot; - if (sk_bone >= 0 && sk_bone < static_cast(skin_matrices.size())) { - const auto& M = skin_matrices[sk_bone]; - px += (v.pos[0] * M[0] + v.pos[1] * M[4] + v.pos[2] * M[8] + M[12]) * w; - py += (v.pos[0] * M[1] + v.pos[1] * M[5] + v.pos[2] * M[9] + M[13]) * w; - pz += (v.pos[0] * M[2] + v.pos[1] * M[6] + v.pos[2] * M[10] + M[14]) * w; - - nx += (v.normal[0] * M[0] + v.normal[1] * M[4] + v.normal[2] * M[8]) * w; - ny += (v.normal[0] * M[1] + v.normal[1] * M[5] + v.normal[2] * M[9]) * w; - nz += (v.normal[0] * M[2] + v.normal[1] * M[6] + v.normal[2] * M[10]) * w; - total_w += w; - } - } - } - - if (total_w < 1e-4f) { - px = v.pos[0]; py = v.pos[1]; pz = v.pos[2]; - nx = v.normal[0]; ny = v.normal[1]; nz = v.normal[2]; - } - - skinned_positions.push_back(px); - skinned_positions.push_back(py); - skinned_positions.push_back(pz); - - skinned_normals.push_back(nx); - skinned_normals.push_back(ny); - skinned_normals.push_back(nz); - - uvs.push_back(v.uv0[0]); - uvs.push_back(v.uv0[1]); - } - - float effective_world[16]; - if (world_matrix) { - MultiplyMat4(R_GRANNY_TO_ENGINE, world_matrix, effective_world); - } else { - std::copy(R_GRANNY_TO_ENGINE, R_GRANNY_TO_ENGINE + 16, effective_world); - } - - if (mesh.tri_groups.empty()) { - Render3DDraw draw; - std::copy(effective_world, effective_world + 16, draw.world); - draw.positions = skinned_positions; - draw.normals = skinned_normals; - draw.uv0 = uvs; - draw.indices = mesh.indices; - if (!mesh.material_textures.empty()) - draw.texture0 = mesh.material_textures[0]; - if (draw.texture0.find("hair") != std::string::npos || mesh.name.find("hair") != std::string::npos || - draw.texture0.find("leaf") != std::string::npos || draw.texture0.find("tree") != std::string::npos) { - draw.alpha_test = true; - draw.alpha_ref = 70; - } - draws.push_back(std::move(draw)); - } else { - for (const auto& group : mesh.tri_groups) { - Render3DDraw draw; - std::copy(effective_world, effective_world + 16, draw.world); - draw.positions = skinned_positions; - draw.normals = skinned_normals; - draw.uv0 = uvs; - draw.indices = mesh.indices; - - std::size_t start_idx = static_cast(group.tri_first * 3); - std::size_t count_idx = static_cast(group.tri_count * 3); - if (start_idx + count_idx <= mesh.indices.size()) { - draw.indices.assign(mesh.indices.begin() + start_idx, - mesh.indices.begin() + start_idx + count_idx); - } - - if (group.material_index >= 0 && group.material_index < static_cast(mesh.material_textures.size())) { - draw.texture0 = mesh.material_textures[group.material_index]; - } - if (draw.texture0.find("hair") != std::string::npos || mesh.name.find("hair") != std::string::npos || - draw.texture0.find("leaf") != std::string::npos || draw.texture0.find("tree") != std::string::npos) { - draw.alpha_test = true; - draw.alpha_ref = 70; - } - draws.push_back(std::move(draw)); - } - } +void Gr2ModelInstance::SetAttachmentAnimated(const std::string& bone_name, bool animated) { + if (m_impl) { + m_impl->SetAttachmentAnimated(bone_name, animated); } +} - ApplySkins(draws, 0); - - // 2. Build attached skinning parts (e.g. hair, armor) using current skin matrices - for (const auto& part : m_attached_parts) { - if (!part) continue; - auto part_draws = part->BuildDrawCommandsWithPalette(skin_matrices, world_matrix, has_skeleton ? &info.skeletons[0] : nullptr); - for (auto& pd : part_draws) { - draws.push_back(std::move(pd)); - } +void Gr2ModelInstance::SetAttachmentScale(const std::string& bone_name, float sx, float sy, float sz) { + if (m_impl) { + m_impl->SetAttachmentScale(bone_name, sx, sy, sz); } +} - // 3. Build attached bone models (e.g. weapon in right hand, shield in left hand) - if (has_skeleton && !world_pose.empty()) { - const auto& sk = info.skeletons[0]; - for (const auto& am : m_attached_models) { - if (!am.model) continue; - int bone_idx = -1; - for (size_t b = 0; b < sk.bones.size(); ++b) { - if (sk.bones[b].name == am.bone_name) { - bone_idx = static_cast(b); - break; - } - } - if (bone_idx < 0) continue; - - const auto& B = world_pose[bone_idx]; - float attached_local[16]; - MultiplyMat4(am.offset, B.data(), attached_local); - if (am.scaled) { - const float S[16] = {am.scale[0], 0, 0, 0, 0, am.scale[1], 0, 0, 0, 0, am.scale[2], 0, 0, 0, 0, 1}; - MultiplyMat4(attached_local, S, attached_local); - } - float attached_engine[16]; - MultiplyMat4(attached_local, R_GRANNY_TO_ENGINE, attached_engine); - float final_world[16]; - if (world_matrix) { - MultiplyMat4(attached_engine, world_matrix, final_world); - } else { - std::copy(attached_engine, attached_engine + 16, final_world); - } - - float attach_time = -1.0f; - if (am.animated && animation_time >= 0.0f) { - float duration = am.model->GetAnimationDuration(); - attach_time = duration > 0.0f ? std::fmod(animation_time, duration) : 0.0f; - } - auto attach_draws = am.model->BuildDrawCommands(attach_time, nullptr); - for (auto& ad : attach_draws) { - std::copy(final_world, final_world + 16, ad.world); - draws.push_back(std::move(ad)); - } - } +void Gr2ModelInstance::SetSkin(const std::string& src_file_name, const std::string& dst_file_name) { + if (m_impl) { + m_impl->SetSkin(src_file_name, dst_file_name); } +} +void Gr2ModelInstance::ClearSkins() { + if (m_impl) { + m_impl->ClearSkins(); + } +} - return draws; +const std::string& Gr2ModelInstance::GetFilePath() const { + static const std::string s_empty; + return m_impl ? m_impl->GetFilePath() : s_empty; +} + +void Gr2ModelInstance::SetHardwareSkinningEnabled(bool enabled){hardwareSkinningEnabled=enabled;} + +std::vector Gr2ModelInstance::BuildDrawCommands(float animation_time, const float* world_matrix, bool forceCPU) { + std::vector out; + if (!m_impl) return out; + auto draws = m_impl->BuildDrawCommands(animation_time, world_matrix, hardwareSkinningEnabled && !forceCPU); + out.reserve(draws.size()); + for (auto& d : draws) { + out.push_back(ToRender3DDraw(std::move(d))); + } + return out; +} + +std::vector Gr2ModelInstance::BuildDrawCommandsWithPalette(const std::vector& skin_matrices, + const float* world_matrix, + const gr2::Skeleton* parent_skeleton) { + std::vector out; + if (!m_impl) return out; + auto draws = m_impl->BuildDrawCommandsWithPalette(skin_matrices, world_matrix, parent_skeleton, hardwareSkinningEnabled); + out.reserve(draws.size()); + for (auto& d : draws) { + out.push_back(ToRender3DDraw(std::move(d))); + } + return out; } bool Gr2ModelInstance::GetLocalBounds(float& minX, float& minY, float& minZ, float& maxX, float& maxY, float& maxZ) const { - if (!m_file) return false; - const auto& info = m_file->file_info(); - if (info.meshes.empty()) return false; - - minX = 1e9f; minY = 1e9f; minZ = 1e9f; - maxX = -1e9f; maxY = -1e9f; maxZ = -1e9f; - - bool found = false; - for (const auto& mesh : info.meshes) { - for (const auto& v : mesh.vertices) { - float ex = v.pos[0]; - float ey = v.pos[2]; - float ez = -v.pos[1]; - minX = std::min(minX, ex); - minY = std::min(minY, ey); - minZ = std::min(minZ, ez); - maxX = std::max(maxX, ex); - maxY = std::max(maxY, ey); - maxZ = std::max(maxZ, ez); - found = true; - } - } - return found; + return m_impl ? m_impl->GetLocalBounds(minX, minY, minZ, maxX, maxY, maxZ) : false; } Gr2SceneRenderer::Gr2SceneRenderer(int width, int height) { @@ -591,6 +232,7 @@ const Gr2SceneRenderer::TextureData* Gr2SceneRenderer::GetTexture(const std::str if (texturePath.empty()) return nullptr; auto it = m_textureCache.find(texturePath); if (it != m_textureCache.end()) { + it->second.lastUsed=m_textureFrame; return it->second.width > 0 ? &it->second : nullptr; } @@ -615,24 +257,10 @@ const Gr2SceneRenderer::TextureData* Gr2SceneRenderer::GetTexture(const std::str } } - std::vector roots = { - "", - "build/dev/", - "../", - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/" - }; - std::vector candidates; - for (const auto& bp : base_paths) { - std::string lower_bp = bp; - for (char& c : lower_bp) c = static_cast(std::tolower(static_cast(c))); - - for (const auto& root : roots) { - candidates.push_back(root + bp); - if (lower_bp != bp) { - candidates.push_back(root + lower_bp); - } - } + for (const auto& path : base_paths) { + auto resolved = CResourceManager::GetCandidatePaths(CResourceManager::NormalizePath(path.c_str())); + candidates.insert(candidates.end(), resolved.begin(), resolved.end()); } for (const auto& p : candidates) { @@ -642,7 +270,8 @@ const Gr2SceneRenderer::TextureData* Gr2SceneRenderer::GetTexture(const std::str TextureData td; td.width = img.w; td.height = img.h; - td.rgba = std::move(img.rgba); + td.rgba = std::move(img.rgba);td.lastUsed=m_textureFrame; + m_decodedTextureBytes+=td.rgba.size();++m_textureDecodeCount; m_textureCache[texturePath] = std::move(td); return &m_textureCache[texturePath]; } @@ -727,7 +356,8 @@ void Gr2SceneRenderer::SetFog(bool enable, uint32_t color, float density, float } void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw& draw) { - if (!targetSurface || draw.indices.size() < 3 || draw.positions.size() < 9) return; + const auto& mesh = draw.Mesh(); + if (!targetSurface || mesh.indices.size() < 3 || mesh.positions.size() < 9) return; int vpWidth = m_viewport[2]; int vpHeight = m_viewport[3]; @@ -739,7 +369,7 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw float mvp[16]; MultiplyMat4(mv, m_proj, mvp); - std::size_t num_verts = draw.positions.size() / 3; + std::size_t num_verts = mesh.positions.size() / 3; struct TransformedVertex { float x_clip = 0.0f, y_clip = 0.0f, z_clip = 0.0f, w_clip = 0.0f; float x_screen = 0.0f, y_screen = 0.0f, z_depth = 0.0f; @@ -756,9 +386,9 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw uint32_t default_diffuse = (mat_a << 24) | (mat_r << 16) | (mat_g << 8) | mat_b; for (std::size_t i = 0; i < num_verts; ++i) { - float px = draw.positions[i * 3 + 0]; - float py = draw.positions[i * 3 + 1]; - float pz = draw.positions[i * 3 + 2]; + float px = mesh.positions[i * 3 + 0]; + float py = mesh.positions[i * 3 + 1]; + float pz = mesh.positions[i * 3 + 2]; float clip[4]; TransformVec4(mvp, px, py, pz, 1.0f, clip); @@ -778,9 +408,9 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw xverts[i].z_depth = ndc_z; } - if (i * 3 + 2 < draw.normals.size()) { + if (i * 3 + 2 < mesh.normals.size()) { // Lit normals are transformed by the world 3x3 (D3DTS_WORLD) before N.L. - float on0 = draw.normals[i * 3 + 0], on1 = draw.normals[i * 3 + 1], on2 = draw.normals[i * 3 + 2]; + float on0 = mesh.normals[i * 3 + 0], on1 = mesh.normals[i * 3 + 1], on2 = mesh.normals[i * 3 + 2]; xverts[i].nx = on0 * draw.world[0] + on1 * draw.world[4] + on2 * draw.world[8]; xverts[i].ny = on0 * draw.world[1] + on1 * draw.world[5] + on2 * draw.world[9]; xverts[i].nz = on0 * draw.world[2] + on1 * draw.world[6] + on2 * draw.world[10]; @@ -788,15 +418,15 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw xverts[i].nx = 0.0f; xverts[i].ny = 1.0f; xverts[i].nz = 0.0f; } - if (i * 2 + 1 < draw.uv0.size()) { - xverts[i].u = draw.uv0[i * 2 + 0]; - xverts[i].v = draw.uv0[i * 2 + 1]; + if (i * 2 + 1 < mesh.uv0.size()) { + xverts[i].u = mesh.uv0[i * 2 + 0]; + xverts[i].v = mesh.uv0[i * 2 + 1]; } else { xverts[i].u = 0.0f; xverts[i].v = 0.0f; } - if (i < draw.diffuse.size()) { - xverts[i].diffuse = draw.diffuse[i]; + if (i < mesh.diffuse.size()) { + xverts[i].diffuse = mesh.diffuse[i]; } else { xverts[i].diffuse = default_diffuse; } @@ -820,7 +450,7 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw diffuse_tex = GetTexture(draw.texture0); } - std::size_t num_tris = draw.indices.size() / 3; + std::size_t num_tris = mesh.indices.size() / 3; auto make_screen_vertex = [&](TransformedVertex& v) { if (v.w_clip > 1e-5f) { @@ -921,8 +551,11 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw float b2 = w2 * invArea; float depth = b0 * v0.z_depth + b1 * v1.z_depth + b2 * v2.z_depth; - int depth_idx = py * vpWidth + px; - if (depth >= 0.0f && depth <= 1.0f && (!draw.z_enable || depth < m_depthBuffer[depth_idx])) { + int depth_x = px - m_viewport[0]; + int depth_y = py - m_viewport[1]; + if (depth_x < 0 || depth_x >= vpWidth || depth_y < 0 || depth_y >= vpHeight) continue; + int depth_idx = depth_y * vpWidth + depth_x; + if (depth >= 0.0f && depth <= 1.0f && (!draw.z_enable || depth <= m_depthBuffer[depth_idx])) { // Smooth Phong Normal Interpolation float nx = b0 * v0.nx + b1 * v1.nx + b2 * v2.nx; float ny = b0 * v0.ny + b1 * v1.ny + b2 * v2.ny; @@ -955,7 +588,7 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw pb = diffuse_tex->rgba[tex_idx + 2]; frag_alpha = static_cast(ta); - if (!draw.diffuse.empty()) { + if (!mesh.diffuse.empty()) { uint32_t d0 = v0.diffuse, d1 = v1.diffuse, d2 = v2.diffuse; float vr = (b0 * ((d0 >> 16) & 0xFF) + b1 * ((d1 >> 16) & 0xFF) + b2 * ((d2 >> 16) & 0xFF)) / 255.0f; float vg = (b0 * ((d0 >> 8) & 0xFF) + b1 * ((d1 >> 8) & 0xFF) + b2 * ((d2 >> 8) & 0xFF)) / 255.0f; @@ -1037,9 +670,9 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw constexpr float W_NEAR = 0.1f; for (std::size_t t = 0; t < num_tris; ++t) { - uint32_t i0 = draw.indices[t * 3 + 0]; - uint32_t i1 = draw.indices[t * 3 + 1]; - uint32_t i2 = draw.indices[t * 3 + 2]; + uint32_t i0 = mesh.indices[t * 3 + 0]; + uint32_t i1 = mesh.indices[t * 3 + 1]; + uint32_t i2 = mesh.indices[t * 3 + 2]; if (i0 >= num_verts || i1 >= num_verts || i2 >= num_verts) continue; const auto& v0 = xverts[i0]; @@ -1083,15 +716,17 @@ void Gr2SceneRenderer::RenderDraw(SDL_Surface* targetSurface, const Render3DDraw } void Gr2SceneRenderer::RenderScene(SDL_Surface* targetSurface, const std::vector& draws) { + ++m_textureFrame; for (const auto& draw : draws) { RenderDraw(targetSurface, draw); } + TrimTextureCaches(true); } void Gr2SceneRenderer::DestroyGPUTextures() { for (auto& pair : m_gpuTextureCache) { - if (pair.second) { - SDL_DestroyTexture(pair.second); + if (pair.second.texture) { + SDL_DestroyTexture(pair.second.texture); } } m_gpuTextureCache.clear(); @@ -1100,27 +735,20 @@ void Gr2SceneRenderer::DestroyGPUTextures() { SDL_Texture* Gr2SceneRenderer::GetGPUTexture(SDL_Renderer* renderer, const std::string& texturePath) { if (texturePath.empty() || !renderer) return nullptr; auto it = m_gpuTextureCache.find(texturePath); - if (it != m_gpuTextureCache.end()) return it->second; + if (it != m_gpuTextureCache.end()) {it->second.lastUsed=m_textureFrame;return it->second.texture;} const TextureData* td = GetTexture(texturePath); if (!td || td->rgba.empty() || td->width <= 0 || td->height <= 0) { - m_gpuTextureCache[texturePath] = nullptr; + m_gpuTextureCache[texturePath] = SDLTextureEntry{nullptr,0,m_textureFrame}; return nullptr; } std::vector cleanRgba = td->rgba; - for (size_t i = 0; i < cleanRgba.size(); i += 4) { - if (cleanRgba[i + 3] < 60) { - cleanRgba[i + 0] = 0; - cleanRgba[i + 1] = 0; - cleanRgba[i + 2] = 0; - cleanRgba[i + 3] = 0; - } - } + // Preserve RGB even where alpha is zero: opaque DDS uses alpha for specular data. SDL_Surface* surf = SDL_CreateSurfaceFrom(td->width, td->height, SDL_PIXELFORMAT_RGBA32, (void*)cleanRgba.data(), td->width * 4); if (!surf) { - m_gpuTextureCache[texturePath] = nullptr; + m_gpuTextureCache[texturePath] = SDLTextureEntry{nullptr,0,m_textureFrame}; return nullptr; } @@ -1128,15 +756,47 @@ SDL_Texture* Gr2SceneRenderer::GetGPUTexture(SDL_Renderer* renderer, const std:: SDL_DestroySurface(surf); if (tex) { SDL_SetTextureScaleMode(tex, SDL_SCALEMODE_LINEAR); - m_gpuTextureCache[texturePath] = tex; + m_gpuTextureCache[texturePath] = SDLTextureEntry{tex,td->rgba.size(),m_textureFrame}; return tex; } - m_gpuTextureCache[texturePath] = nullptr; + m_gpuTextureCache[texturePath] = SDLTextureEntry{nullptr,0,m_textureFrame}; return nullptr; } +void Gr2SceneRenderer::SetTextureBudgets(size_t cpuBytes,size_t gpuBytes) { + m_decodedTextureBudget=cpuBytes;m_gpuTextureBudget=gpuBytes; + if(m_hardware)m_hardware->SetTextureBudget(gpuBytes); +} +void Gr2SceneRenderer::TrimTextureCaches(bool protectDecodedWorkingSet) { + // Only evict after the scene: software draws can hold several decoded image pointers. + while(m_decodedTextureBytes>m_decodedTextureBudget || m_textureCache.size()>256) { + auto oldest=m_textureCache.end(); + for(auto it=m_textureCache.begin();it!=m_textureCache.end();++it) { + if(protectDecodedWorkingSet && it->second.lastUsed>=m_textureFrame)continue; + if(oldest==m_textureCache.end() || it->second.lastUsedsecond.lastUsed)oldest=it; + } + if(oldest==m_textureCache.end())break; + m_decodedTextureBytes-=oldest->second.rgba.size();m_textureCache.erase(oldest); + } + size_t bytes=0;for(const auto& [key,entry]:m_gpuTextureCache)bytes+=entry.bytes; + while(bytes>m_gpuTextureBudget || m_gpuTextureCache.size()>256) { + auto oldest=m_gpuTextureCache.end(); + for(auto it=m_gpuTextureCache.begin();it!=m_gpuTextureCache.end();++it) { + if(it->second.lastUsed>=m_textureFrame)continue; + if(oldest==m_gpuTextureCache.end() || it->second.lastUsedsecond.lastUsed)oldest=it; + } + if(oldest==m_gpuTextureCache.end())break; + bytes-=oldest->second.bytes;if(oldest->second.texture)SDL_DestroyTexture(oldest->second.texture);m_gpuTextureCache.erase(oldest); + } +} +void Gr2SceneRenderer::SetGPUDevice(SDL_GPUDevice* device) { + m_hardware = device ? std::make_unique(device) : nullptr; + if(m_hardware)m_hardware->SetTextureBudget(m_gpuTextureBudget); +} + void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector& draws) { if (!renderer || draws.empty()) return; + ++m_textureFrame; int vpWidth = m_viewport[2]; int vpHeight = m_viewport[3]; @@ -1149,14 +809,18 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< // 3: Alpha-tested geometry (speedtree foliage, hair) // 4: Translucent surfaces (water, glass) - sorted back-to-front // 5: Additive particles, weapon shining, skill ribbons - sorted back-to-front + m_hardwareVertices.clear(); + m_hardwareIndices.clear(); + m_hardwareBatches.clear(); m_scratchSortedDraws.clear(); m_scratchSortedDraws.reserve(draws.size()); for (const auto& d : draws) { DrawOrder ord; ord.draw = &d; - if (!d.positions.empty()) { - float cx = d.positions[0], cy = d.positions[1], cz = d.positions[2]; + const auto& sortedMesh = d.Mesh(); + if (!sortedMesh.positions.empty()) { + float cx = sortedMesh.positions[0], cy = sortedMesh.positions[1], cz = sortedMesh.positions[2]; float wx = cx * d.world[0] + cy * d.world[4] + cz * d.world[8] + d.world[12]; float wy = cx * d.world[1] + cy * d.world[5] + cz * d.world[9] + d.world[13]; float wz = cx * d.world[2] + cy * d.world[6] + cz * d.world[10] + d.world[14]; @@ -1166,6 +830,8 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< if (!d.z_enable) { ord.priority = 0; // Skybox + } else if (d.terrain) { + ord.priority = 1; } else if (d.blend_mode == 1) { ord.priority = 5; // Additive shining & effects } else if (d.texture0.find("water") != std::string::npos || d.texture0.find("wave") != std::string::npos) { @@ -1178,10 +844,17 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< m_scratchSortedDraws.push_back(ord); } - std::stable_sort(m_scratchSortedDraws.begin(), m_scratchSortedDraws.end(), [](const DrawOrder& a, const DrawOrder& b) { - if (a.priority != b.priority) return a.priority < b.priority; - if (a.priority >= 4) return a.depth > b.depth; // Back-to-front for transparent / additive - return a.depth < b.depth; // Front-to-back for opaque + std::stable_sort(m_scratchSortedDraws.begin(),m_scratchSortedDraws.end(),[this](const DrawOrder& a,const DrawOrder& b){ + if(a.priority!=b.priority)return a.priorityalpha_blend!=b.draw->alpha_blend)return !a.draw->alpha_blend; + if(!a.draw->alpha_blend) { + if(a.draw->texture0!=b.draw->texture0)return a.draw->texture0texture0; + if(a.draw->geometry.get()!=b.draw->geometry.get())return std::less{}(a.draw->geometry.get(),b.draw->geometry.get()); + return a.depthb.depth; }); float fog_r = static_cast((m_fog_color >> 16) & 0xFF) / 255.0f; @@ -1192,8 +865,9 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< for (const auto& ord : m_scratchSortedDraws) { const auto& draw = *ord.draw; - if (draw.indices.size() < 3 || draw.positions.size() < 9) continue; - if (draw.texture0.empty() && draw.diffuse.empty()) continue; + const auto& mesh = draw.Mesh(); + if (mesh.indices.size() < 3 || mesh.positions.size() < 9) continue; + if (draw.texture0.empty() && mesh.diffuse.empty()) continue; float mv[16]; MultiplyMat4(draw.world, m_view, mv); @@ -1211,14 +885,45 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< float mat_b = std::clamp(draw.material_diffuse[2], 0.0f, 1.0f); float mat_a = std::clamp(draw.material_diffuse[3], 0.0f, 1.0f); - size_t num_verts = draw.positions.size() / 3; + size_t num_verts = mesh.positions.size() / 3; + if (m_hardware) { + SDL_GPUTexture* texture=nullptr; + if (!draw.texture0.empty()) { + texture=m_hardware->FindTexture(draw.texture0); + if(!texture){const auto* data=GetTexture(draw.texture0);if(!data)continue; + texture=m_hardware->Texture(draw.texture0,data->width,data->height,data->rgba.data());} + if(!texture)continue; + } + HardwareBatch batch{};batch.texture=texture;batch.cull=draw.cull_mode; + batch.depth=draw.z_enable;batch.depthWrite=draw.z_enable&&draw.z_write; + batch.blend=draw.alpha_blend;batch.additive=draw.blend_mode==1; + batch.alphaRef=draw.alpha_test ? draw.alpha_ref/255.f : -1.f; + batch.geometry=draw.geometry; + auto& t=batch.transform;std::copy_n(draw.world,16,t.world);std::copy_n(mvp,16,t.mvp); + t.diffuse[0]=mat_r;t.diffuse[1]=mat_g;t.diffuse[2]=mat_b;t.diffuse[3]=mat_a; + std::copy_n(draw.material_ambient,4,t.ambient);std::copy_n(draw.material_emissive,4,t.emissive); + t.lightDirection[0]=lx;t.lightDirection[1]=ly;t.lightDirection[2]=lz; + std::copy_n(draw.light_ambient,3,t.lightAmbient);std::copy_n(draw.light_diffuse,3,t.lightDiffuse); + t.fogColor[0]=fog_r;t.fogColor[1]=fog_g;t.fogColor[2]=fog_b; + t.fogParams[0]=m_fog_density;t.fogParams[1]=m_fog_near;t.fogParams[2]=m_fog_far; + t.modes[0]=1;t.modes[1]=draw.lighting ? 1.f : 0.f;t.modes[2]=m_fog_enabled&&draw.fog ? (m_fog_exp ? 2.f : 1.f) : 0.f;t.modes[3]=draw.z_enable ? 0.f : 1.f; + if(draw.gpu_skinning){batch.palette=draw.bone_matrices;t.skin[0]=batch.palette.size()/16;} + batch.indexCount=mesh.indices.size(); + if(!batch.geometry) { + const uint32_t base=m_hardwareVertices.size();batch.firstIndex=m_hardwareIndices.size(); + bool valid=true;for(auto index:mesh.indices)if(index>=num_verts){valid=false;break;}if(!valid)continue; + for(size_t i=0;i 1e-4f) { + if (!m_hardware && clip[3] > 1e-4f) { float inv_w = 1.0f / clip[3]; float ndc_x = clip[0] * inv_w; float ndc_y = clip[1] * inv_w; @@ -1238,17 +943,17 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< xverts[i].y_screen = 0.0f; } - if (i * 2 + 1 < draw.uv0.size()) { - xverts[i].u = draw.uv0[i * 2 + 0]; - xverts[i].v = draw.uv0[i * 2 + 1]; + if (i * 2 + 1 < mesh.uv0.size()) { + xverts[i].u = mesh.uv0[i * 2 + 0]; + xverts[i].v = mesh.uv0[i * 2 + 1]; } else { xverts[i].u = 0.0f; xverts[i].v = 0.0f; } float vr = mat_r, vg = mat_g, vb = mat_b, va = mat_a; - if (i < draw.diffuse.size()) { - uint32_t d = draw.diffuse[i]; + if (i < mesh.diffuse.size()) { + uint32_t d = mesh.diffuse[i]; vr *= ((d >> 16) & 0xFF) / 255.0f; vg *= ((d >> 8) & 0xFF) / 255.0f; vb *= (d & 0xFF) / 255.0f; @@ -1258,8 +963,8 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< // D3D8 fixed-function vertex lighting with one directional light (D3DRS_AMBIENT 0): // Emissive + Material.Ambient*Light.Ambient + Diffuse*Light.Diffuse*max(0, N.L), clamped. // Normals go through the world matrix like D3DTS_WORLD does for lit vertices. - if (draw.lighting && i * 3 + 2 < draw.normals.size()) { - float on[3] = {draw.normals[i * 3 + 0], draw.normals[i * 3 + 1], draw.normals[i * 3 + 2]}; + if (draw.lighting && i * 3 + 2 < mesh.normals.size()) { + float on[3] = {mesh.normals[i * 3 + 0], mesh.normals[i * 3 + 1], mesh.normals[i * 3 + 2]}; float nx = on[0] * draw.world[0] + on[1] * draw.world[4] + on[2] * draw.world[8]; float ny = on[0] * draw.world[1] + on[1] * draw.world[5] + on[2] * draw.world[9]; float nz = on[0] * draw.world[2] + on[1] * draw.world[6] + on[2] * draw.world[10]; @@ -1292,8 +997,8 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< m_scratchSdlVertices.clear(); m_scratchSdlIndices.clear(); - m_scratchSdlVertices.reserve(draw.indices.size()); - m_scratchSdlIndices.reserve(draw.indices.size()); + m_scratchSdlVertices.reserve(mesh.indices.size()); + m_scratchSdlIndices.reserve(mesh.indices.size()); auto& vertices = m_scratchSdlVertices; auto& indices = m_scratchSdlIndices; @@ -1337,11 +1042,11 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< return out; }; - size_t num_tris = draw.indices.size() / 3; + size_t num_tris = mesh.indices.size() / 3; for (size_t t = 0; t < num_tris; ++t) { - uint32_t i0 = draw.indices[t * 3 + 0]; - uint32_t i1 = draw.indices[t * 3 + 1]; - uint32_t i2 = draw.indices[t * 3 + 2]; + uint32_t i0 = mesh.indices[t * 3 + 0]; + uint32_t i1 = mesh.indices[t * 3 + 1]; + uint32_t i2 = mesh.indices[t * 3 + 2]; if (i0 >= num_verts || i1 >= num_verts || i2 >= num_verts) continue; const auto& v0 = xverts[i0]; @@ -1408,7 +1113,7 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< } continue; // Avoid rendering raw untextured white shapes for missing textures } - } else if (draw.diffuse.empty()) { + } else if (mesh.diffuse.empty()) { // Neither texture nor vertex diffuse colors: skip blank geometry continue; } @@ -1416,13 +1121,23 @@ void Gr2SceneRenderer::RenderSceneGPU(SDL_Renderer* renderer, const std::vector< if (draw.blend_mode == 1) { SDL_SetRenderDrawBlendMode(renderer, SDL_BLENDMODE_ADD); if (gpuTex) SDL_SetTextureBlendMode(gpuTex, SDL_BLENDMODE_ADD); - } else { + } else if (draw.alpha_blend || draw.alpha_test) { SDL_SetRenderDrawBlendMode(renderer, SDL_BLENDMODE_BLEND); if (gpuTex) SDL_SetTextureBlendMode(gpuTex, SDL_BLENDMODE_BLEND); + } else { + // Armor DDS alpha carries specular data; opaque materials do not blend it. + SDL_SetRenderDrawBlendMode(renderer, SDL_BLENDMODE_NONE); + if (gpuTex) SDL_SetTextureBlendMode(gpuTex, SDL_BLENDMODE_NONE); } SDL_RenderGeometry(renderer, gpuTex, vertices.data(), static_cast(vertices.size()), indices.data(), static_cast(indices.size())); } + if (m_hardware && !m_hardware->Render(renderer, vpWidth, vpHeight, m_hardwareVertices, m_hardwareIndices, m_hardwareBatches)) { + SDL_Log("Hardware depth pipeline unavailable, using SDL geometry fallback: %s", SDL_GetError()); + m_hardware.reset(); + RenderSceneGPU(renderer, draws); + } + TrimTextureCaches(m_hardware==nullptr); } bool Gr2SceneRenderer::ProjectToScreen(float worldX, float worldY, float worldZ, float& screenX, float& screenY) const { diff --git a/src/eter_render/Gr2ModelRenderer.h b/src/eter_render/Gr2ModelRenderer.h index f7388362..2dd24b55 100644 --- a/src/eter_render/Gr2ModelRenderer.h +++ b/src/eter_render/Gr2ModelRenderer.h @@ -1,7 +1,9 @@ #pragma once #include "RenderCommands3D.h" +#include "HardwareScene.h" #include +#include #include #include #include @@ -12,7 +14,13 @@ namespace ava2 { class Gr2ModelInstance { public: + Gr2ModelInstance() = default; + static void SetHardwareSkinningEnabled(bool enabled); + explicit Gr2ModelInstance(std::shared_ptr impl) + : m_impl(std::move(impl)) {} + static std::unique_ptr Load(const std::string& filepath); + static std::unique_ptr LoadFromMemory(const uint8_t* data, size_t size, const std::string& name = ""); // Load external animation (.gr2) to animate this model bool LoadExternalAnimation(const std::string& anim_filepath); @@ -31,11 +39,11 @@ public: void SetAttachmentScale(const std::string& bone_name, float sx, float sy, float sz); // CGrannyModelInstance::SetMaterialImagePointer: textures whose StringPath matches src are drawn with dst. void SetSkin(const std::string& src_file_name, const std::string& dst_file_name); - void ClearSkins() { m_skins.clear(); } - const std::string& GetFilePath() const { return m_filepath; } + void ClearSkins(); + const std::string& GetFilePath() const; // Build 3D draw commands for this model and all attached components (weapons, hair, armor parts) - std::vector BuildDrawCommands(float animation_time = -1.0f, const float* world_matrix = nullptr); + std::vector BuildDrawCommands(float animation_time = -1.0f, const float* world_matrix = nullptr, bool forceCPU = false); // Build draw commands for a skinned part using an external bone palette std::vector BuildDrawCommandsWithPalette(const std::vector& skin_matrices, @@ -44,31 +52,17 @@ public: bool GetLocalBounds(float& minX, float& minY, float& minZ, float& maxX, float& maxY, float& maxZ) const; - const gr2::File& GetFile() const { return *m_file; } - const gr2::FileInfo& GetInfo() const { return m_file->file_info(); } + const gr2::File& GetFile() const { return m_impl->GetFile(); } + const gr2::FileInfo& GetInfo() const { return m_impl->GetInfo(); } + + std::shared_ptr GetImpl() const { return m_impl; } private: - struct AttachedModel { - std::string bone_name; - std::shared_ptr model; - float offset[16]; - bool animated = false; - bool scaled = false; - float scale[3] = {1.0f, 1.0f, 1.0f}; - }; - void ApplySkins(std::vector& draws, size_t first) const; - - std::unique_ptr m_file; - std::string m_filepath; - std::unique_ptr m_anim_file; - std::string m_anim_filepath; - - std::vector m_attached_models; + std::shared_ptr m_impl; + std::vector> m_attached_models; std::vector> m_attached_parts; - std::unordered_map m_skins; }; -// 3D Scene and Model Renderer (modeled after 40250 pipeline architecture) class Gr2SceneRenderer { public: Gr2SceneRenderer(int width = 1024, int height = 768); @@ -95,13 +89,19 @@ public: // Rasterize a list of draw commands (CPU software rasterizer) void RenderScene(SDL_Surface* targetSurface, const std::vector& draws); - // GPU Hardware-accelerated 3D Scene Rendering via SDL_RenderGeometry / Metal / Vulkan + // Native SDL_GPU depth/perspective pipeline; SDL geometry fallback for software renderers. void RenderSceneGPU(SDL_Renderer* renderer, const std::vector& draws); + void SetGPUDevice(SDL_GPUDevice* device); void DestroyGPUTextures(); SDL_Texture* GetGPUTexture(SDL_Renderer* renderer, const std::string& texturePath); // Exponential & Linear Depth Fog (modeled after 40250 CMapOutdoor fog) void SetFog(bool enable, uint32_t color = 0xFFCCDDEE, float density = 0.0003f, float fog_near = 300.0f, float fog_far = 3000.0f, bool exp_mode = true); + void SetTextureBudgets(size_t cpuBytes,size_t gpuBytes); + size_t GetHardwareTextureBytes() const {return m_hardware ? m_hardware->GetTextureBytes() : 0;} + size_t GetHardwareTextureUploadCount() const {return m_hardware ? m_hardware->GetTextureUploadCount() : 0;} + size_t GetDecodedTextureBytes() const { return m_decodedTextureBytes; } + size_t GetTextureDecodeCount() const { return m_textureDecodeCount; } bool IsFogEnabled() const { return m_fog_enabled; } uint32_t GetFogColor() const { return m_fog_color; } @@ -128,10 +128,12 @@ public: private: struct TextureData { + uint64_t lastUsed = 0; int width = 0; int height = 0; std::vector rgba; }; + void TrimTextureCaches(bool protectDecodedWorkingSet); const TextureData* GetTexture(const std::string& texturePath); struct GpuTransformedVertex { @@ -154,7 +156,10 @@ private: int m_logicalHeight = 0; std::vector m_depthBuffer; std::unordered_map m_textureCache; - std::unordered_map m_gpuTextureCache; + struct SDLTextureEntry {SDL_Texture* texture=nullptr;size_t bytes=0;uint64_t lastUsed=0;}; + std::unordered_map m_gpuTextureCache; + uint64_t m_textureFrame=0; + size_t m_decodedTextureBytes=0,m_textureDecodeCount=0,m_decodedTextureBudget=64u*1024u*1024u,m_gpuTextureBudget=256u*1024u*1024u; // Persistent scratch buffers to eliminate per-draw heap allocation churn in RenderSceneGPU std::vector m_scratchSortedDraws; @@ -162,6 +167,11 @@ private: std::vector m_scratchSdlVertices; std::vector m_scratchSdlIndices; + std::unique_ptr m_hardware; + std::vector m_hardwareVertices; + std::vector m_hardwareIndices; + std::vector m_hardwareBatches; + bool m_fog_enabled = false; uint32_t m_fog_color = 0xFFCCDDEE; float m_fog_density = 0.0003f; diff --git a/src/eter_render/HardwareScene.cpp b/src/eter_render/HardwareScene.cpp new file mode 100644 index 00000000..ad8e61b2 --- /dev/null +++ b/src/eter_render/HardwareScene.cpp @@ -0,0 +1,298 @@ +#include "HardwareScene.h" +#include "shaders/SceneSpirv.h" +#include +#include +#include +namespace ava2 { +namespace { +constexpr const char* metal = R"( +#include +using namespace metal; +struct Input { float4 position [[attribute(0)]]; float4 color [[attribute(1)]]; float2 uv [[attribute(2)]]; float4 normal [[attribute(3)]]; uint4 bones [[attribute(4)]]; float4 weights [[attribute(5)]]; }; +struct Transform { float4 world[4]; float4 mvp[4]; float4 diffuse,ambient,emissive,lightDirection,lightAmbient,lightDiffuse,fogColor,fogParams,modes,skin; }; +struct Output { float4 position [[position]]; float4 color; float2 uv; }; +float4 rows(float4 p,float4 a,float4 b,float4 c,float4 d){return p.x*a+p.y*b+p.z*c+p.w*d;} +vertex Output scene_vertex(Input in [[stage_in]], uint instance [[instance_id]], constant Transform& header [[buffer(0)]], constant float4* palette [[buffer(1)]], device const Transform* instances [[buffer(2)]]) { + Transform t=header.modes.x>1.5 ? instances[instance] : header; + float4 p=in.position; float3 n=in.normal.xyz; + if(t.skin.x>0.5){float4 sp=0;float3 sn=0;float total=0; + for(uint i=0;i<4;++i)if(in.weights[i]>0 && in.bones[i]0.0001){p=float4(sp.xyz,1);n=sn;} + } + float4 clip=p,c=in.color; + if(t.modes.x>0.5){ + clip=rows(p,t.mvp[0],t.mvp[1],t.mvp[2],t.mvp[3]);c*=t.diffuse; + if(t.modes.y>0.5 && in.normal.w>0.5){float3 wn=rows(float4(n,0),t.world[0],t.world[1],t.world[2],t.world[3]).xyz; + float len=length(wn);if(len>0.00001)wn/=len; + float ndotl=max(0.f,dot(wn,t.lightDirection.xyz));c.rgb=clamp(t.emissive.rgb+t.ambient.rgb*t.lightAmbient.rgb+c.rgb*t.lightDiffuse.rgb*ndotl,0.f,1.f); + } + if(t.modes.z>0.5 && clip.w>0){float f=t.modes.z>1.5 ? exp(-clamp(clip.w*t.fogParams.x,0.f,10.f)) : clamp((t.fogParams.z-clip.w)/(t.fogParams.z-t.fogParams.y),0.f,1.f);c.rgb=mix(t.fogColor.rgb,c.rgb,f);} + if(t.modes.w>0.5)clip.z=0; + } + Output out;out.position=clip;out.color=c;out.uv=in.uv;return out; +} +fragment float4 scene_fragment(Output in [[stage_in]], texture2d image [[texture(0)]], sampler sampling [[sampler(0)]], constant float4& params [[buffer(0)]]) { + float4 c=image.sample(sampling,in.uv)*in.color; + if(params.x>=0.0 && c.a<=params.x) discard_fragment(); + if(params.y>0.5) c.a=1.0; + return c; +} +)"; + +} +HardwareScene::~HardwareScene() { + for (auto& [key,mesh]:resident_) {SDL_ReleaseGPUBuffer(device_,mesh.vertices);SDL_ReleaseGPUBuffer(device_,mesh.indices);} + if(instances_)SDL_ReleaseGPUBuffer(device_,instances_); + if(instanceTransfer_)SDL_ReleaseGPUTransferBuffer(device_,instanceTransfer_); + if(output_) SDL_DestroyTexture(output_); + for(auto& [key,t]:textures_) SDL_ReleaseGPUTexture(device_,t.texture); + for(auto& [key,p]:pipelines_) SDL_ReleaseGPUGraphicsPipeline(device_,p); + if(color_) SDL_ReleaseGPUTexture(device_,color_); + if(depth_) SDL_ReleaseGPUTexture(device_,depth_); + if(vertex_) SDL_ReleaseGPUShader(device_,vertex_); + if(fragment_) SDL_ReleaseGPUShader(device_,fragment_); + if(sampler_) SDL_ReleaseGPUSampler(device_,sampler_); + if(vertices_) SDL_ReleaseGPUBuffer(device_,vertices_); + if(indices_) SDL_ReleaseGPUBuffer(device_,indices_); + if(transfer_) SDL_ReleaseGPUTransferBuffer(device_,transfer_); +} +SDL_GPUTexture* HardwareScene::FindTexture(const std::string& key) { + auto it=textures_.find(key);if(it==textures_.end())return nullptr; + it->second.lastUsed=frame_+1;return it->second.texture; +} +SDL_GPUTexture* HardwareScene::Texture(const std::string& key,int width,int height,const void* rgba) { + if(auto* found=FindTexture(key))return found; + // Own uploads on the same queue as the 3D pass. SDL_Renderer's pending + // texture uploads are submitted at Present, after our custom command buffer. + SDL_GPUTextureCreateInfo ti{};ti.type=SDL_GPU_TEXTURETYPE_2D;ti.format=SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM; + ti.usage=SDL_GPU_TEXTUREUSAGE_SAMPLER;ti.width=width;ti.height=height;ti.layer_count_or_depth=1;ti.num_levels=1; + auto* texture=SDL_CreateGPUTexture(device_,&ti);if(!texture)return nullptr; + SDL_GPUTransferBufferCreateInfo transferInfo{};transferInfo.usage=SDL_GPU_TRANSFERBUFFERUSAGE_UPLOAD;transferInfo.size=width*height*4; + auto* transfer=SDL_CreateGPUTransferBuffer(device_,&transferInfo); + auto* bytes=transfer ? SDL_MapGPUTransferBuffer(device_,transfer,false) : nullptr; + auto* command=bytes ? SDL_AcquireGPUCommandBuffer(device_) : nullptr; + if(!bytes || !command) { + if(bytes)SDL_UnmapGPUTransferBuffer(device_,transfer); + if(transfer)SDL_ReleaseGPUTransferBuffer(device_,transfer); + SDL_ReleaseGPUTexture(device_,texture);return nullptr; + } + std::memcpy(bytes,rgba,transferInfo.size);SDL_UnmapGPUTransferBuffer(device_,transfer); + auto* copy=SDL_BeginGPUCopyPass(command); + if(!copy){SDL_CancelGPUCommandBuffer(command);SDL_ReleaseGPUTransferBuffer(device_,transfer);SDL_ReleaseGPUTexture(device_,texture);return nullptr;} + SDL_GPUTextureTransferInfo source{};source.transfer_buffer=transfer;source.pixels_per_row=width;source.rows_per_layer=height; + SDL_GPUTextureRegion dest{};dest.texture=texture;dest.w=width;dest.h=height;dest.d=1; + SDL_UploadToGPUTexture(copy,&source,&dest,false);SDL_EndGPUCopyPass(copy); + const bool submitted=SDL_SubmitGPUCommandBuffer(command);SDL_ReleaseGPUTransferBuffer(device_,transfer); + if(!submitted){SDL_ReleaseGPUTexture(device_,texture);return nullptr;} + const size_t imageBytes=size_t(width)*height*4; + textures_.emplace(key,TextureEntry{texture,imageBytes,frame_+1});textureBytes_+=imageBytes;++textureUploads_;return texture; +} +bool HardwareScene::Initialize(SDL_Renderer* renderer,int width,int height) { + if(!vertex_) { + bool msl=(SDL_GetGPUShaderFormats(device_) & SDL_GPU_SHADERFORMAT_MSL)!=0; + SDL_GPUShaderCreateInfo info{}; + info.format=msl ? SDL_GPU_SHADERFORMAT_MSL : SDL_GPU_SHADERFORMAT_SPIRV; + info.stage=SDL_GPU_SHADERSTAGE_VERTEX; info.num_uniform_buffers=2;info.num_storage_buffers=1; + info.code=msl ? reinterpret_cast(metal) : scene_vert_spv; + info.code_size=msl ? std::strlen(metal) : sizeof(scene_vert_spv); + info.entrypoint=msl ? "scene_vertex" : "main"; + vertex_=SDL_CreateGPUShader(device_,&info); + info.stage=SDL_GPU_SHADERSTAGE_FRAGMENT; info.num_samplers=1;info.num_uniform_buffers=1;info.num_storage_buffers=0; + info.code=msl ? reinterpret_cast(metal) : scene_frag_spv; + info.code_size=msl ? std::strlen(metal) : sizeof(scene_frag_spv); + info.entrypoint=msl ? "scene_fragment" : "main"; + fragment_=SDL_CreateGPUShader(device_,&info); + SDL_GPUSamplerCreateInfo si{}; + si.min_filter=si.mag_filter=SDL_GPU_FILTER_LINEAR; + si.mipmap_mode=SDL_GPU_SAMPLERMIPMAPMODE_LINEAR; + si.address_mode_u=si.address_mode_v=si.address_mode_w=SDL_GPU_SAMPLERADDRESSMODE_REPEAT; + sampler_=SDL_CreateGPUSampler(device_,&si); + const Uint32 white=0xffffffff; + white_=Texture("__ava2_white",1,1,&white); + } + if(!vertex_ || !fragment_ || !sampler_ || !white_) return false; + if(width_!=width || height_!=height) { + if(output_) SDL_DestroyTexture(output_); + if(color_) SDL_ReleaseGPUTexture(device_,color_); + if(depth_) SDL_ReleaseGPUTexture(device_,depth_); + output_=nullptr;color_=depth_=nullptr; + SDL_GPUTextureCreateInfo ti{};ti.type=SDL_GPU_TEXTURETYPE_2D;ti.width=width;ti.height=height;ti.layer_count_or_depth=1;ti.num_levels=1; + ti.format=SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM;ti.usage=SDL_GPU_TEXTUREUSAGE_COLOR_TARGET|SDL_GPU_TEXTUREUSAGE_SAMPLER; + color_=SDL_CreateGPUTexture(device_,&ti); + ti.format=SDL_GPU_TEXTUREFORMAT_D32_FLOAT;ti.usage=SDL_GPU_TEXTUREUSAGE_DEPTH_STENCIL_TARGET; + depth_=SDL_CreateGPUTexture(device_,&ti); + if(!color_ || !depth_) return false; + auto props=SDL_CreateProperties(); + SDL_SetPointerProperty(props,SDL_PROP_TEXTURE_CREATE_GPU_TEXTURE_POINTER,color_); + SDL_SetNumberProperty(props,SDL_PROP_TEXTURE_CREATE_FORMAT_NUMBER,SDL_PIXELFORMAT_ABGR8888); + SDL_SetNumberProperty(props,SDL_PROP_TEXTURE_CREATE_WIDTH_NUMBER,width); + SDL_SetNumberProperty(props,SDL_PROP_TEXTURE_CREATE_HEIGHT_NUMBER,height); + output_=SDL_CreateTextureWithProperties(renderer,props);SDL_DestroyProperties(props); + if(!output_)return false; + // The target accumulates premultiplied colors. Transparent pixels keep + // the Python selection background and other existing 2D layers intact. + SDL_SetTextureBlendMode(output_,SDL_BLENDMODE_BLEND_PREMULTIPLIED); + width_=width;height_=height; + } + return true; +} +SDL_GPUGraphicsPipeline* HardwareScene::Pipeline(const HardwareBatch& b) { + unsigned key=b.cull|(b.depth<<3)|(b.depthWrite<<4)|(b.blend<<5)|(b.additive<<6); + auto it=pipelines_.find(key);if(it!=pipelines_.end())return it->second; + SDL_GPUGraphicsPipelineCreateInfo info{}; + info.vertex_shader=vertex_;info.fragment_shader=fragment_;info.primitive_type=SDL_GPU_PRIMITIVETYPE_TRIANGLELIST; + SDL_GPUVertexBufferDescription buffer{};buffer.slot=0;buffer.pitch=sizeof(HardwareVertex);buffer.input_rate=SDL_GPU_VERTEXINPUTRATE_VERTEX; + SDL_GPUVertexAttribute attributes[6]{}; + attributes[0]={0,0,SDL_GPU_VERTEXELEMENTFORMAT_FLOAT4,0}; + attributes[1]={1,0,SDL_GPU_VERTEXELEMENTFORMAT_FLOAT4,16}; + attributes[2]={2,0,SDL_GPU_VERTEXELEMENTFORMAT_FLOAT2,32}; + attributes[3]={3,0,SDL_GPU_VERTEXELEMENTFORMAT_FLOAT4,40}; + attributes[4]={4,0,SDL_GPU_VERTEXELEMENTFORMAT_UINT4,56}; + attributes[5]={5,0,SDL_GPU_VERTEXELEMENTFORMAT_FLOAT4,72}; + info.vertex_input_state={&buffer,1,attributes,6}; + info.rasterizer_state.fill_mode=SDL_GPU_FILLMODE_FILL; + info.rasterizer_state.front_face=SDL_GPU_FRONTFACE_COUNTER_CLOCKWISE; + info.rasterizer_state.cull_mode=b.cull==1 ? SDL_GPU_CULLMODE_NONE : b.cull==2 ? SDL_GPU_CULLMODE_BACK : SDL_GPU_CULLMODE_FRONT; + info.depth_stencil_state.compare_op=SDL_GPU_COMPAREOP_LESS_OR_EQUAL; + info.depth_stencil_state.enable_depth_test=b.depth; + info.depth_stencil_state.enable_depth_write=b.depthWrite; + SDL_GPUColorTargetDescription target{};target.format=SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM; + auto& blend=target.blend_state;blend.enable_blend=b.blend||b.additive; + blend.src_color_blendfactor=SDL_GPU_BLENDFACTOR_SRC_ALPHA; + blend.dst_color_blendfactor=b.additive ? SDL_GPU_BLENDFACTOR_ONE : SDL_GPU_BLENDFACTOR_ONE_MINUS_SRC_ALPHA; + blend.color_blend_op=blend.alpha_blend_op=SDL_GPU_BLENDOP_ADD; + blend.src_alpha_blendfactor=SDL_GPU_BLENDFACTOR_ONE;blend.dst_alpha_blendfactor=SDL_GPU_BLENDFACTOR_ONE_MINUS_SRC_ALPHA; + info.target_info.color_target_descriptions=⌖info.target_info.num_color_targets=1; + info.target_info.has_depth_stencil_target=true;info.target_info.depth_stencil_format=SDL_GPU_TEXTUREFORMAT_D32_FLOAT; + auto* p=SDL_CreateGPUGraphicsPipeline(device_,&info);if(p)pipelines_.emplace(key,p);return p; +} +HardwareVertex MakeHardwareVertex(const Render3DDraw& mesh,size_t i) { + HardwareVertex v{}; + v.position[0]=mesh.positions[i*3];v.position[1]=mesh.positions[i*3+1];v.position[2]=mesh.positions[i*3+2];v.position[3]=1; + uint32_t color=i>16)&255)/255.f;v.color[1]=((color>>8)&255)/255.f;v.color[2]=(color&255)/255.f;v.color[3]=(color>>24)/255.f; + if(i*2+1& geometry) { + auto it=resident_.find(geometry.get()); + if(it!=resident_.end()){it->second.lastUsed=frame_;return &it->second;} + const auto& mesh=*geometry; + const size_t count=mesh.positions.size()/3; + if(!count || mesh.indices.empty())return nullptr; + for(auto index:mesh.indices)if(index>=count)return nullptr; + std::vector packed;packed.reserve(count); + for(size_t i=0;i(SDL_MapGPUTransferBuffer(device_,transfer,false)) : nullptr; + auto* command=bytes && r.vertices && r.indices ? SDL_AcquireGPUCommandBuffer(device_) : nullptr; + if(!command){if(bytes)SDL_UnmapGPUTransferBuffer(device_,transfer);if(transfer)SDL_ReleaseGPUTransferBuffer(device_,transfer);if(r.vertices)SDL_ReleaseGPUBuffer(device_,r.vertices);if(r.indices)SDL_ReleaseGPUBuffer(device_,r.indices);return nullptr;} + std::memcpy(bytes,packed.data(),vb);std::memcpy(bytes+vb,mesh.indices.data(),ib);SDL_UnmapGPUTransferBuffer(device_,transfer); + auto* copy=SDL_BeginGPUCopyPass(command); + if(!copy){SDL_CancelGPUCommandBuffer(command);SDL_ReleaseGPUTransferBuffer(device_,transfer);SDL_ReleaseGPUBuffer(device_,r.vertices);SDL_ReleaseGPUBuffer(device_,r.indices);return nullptr;} + SDL_GPUTransferBufferLocation from{transfer,0};SDL_GPUBufferRegion to{r.vertices,0,vb};SDL_UploadToGPUBuffer(copy,&from,&to,false); + from.offset=vb;to={r.indices,0,ib};SDL_UploadToGPUBuffer(copy,&from,&to,false);SDL_EndGPUCopyPass(copy); + bool ok=SDL_SubmitGPUCommandBuffer(command);SDL_ReleaseGPUTransferBuffer(device_,transfer); + if(!ok){SDL_ReleaseGPUBuffer(device_,r.vertices);SDL_ReleaseGPUBuffer(device_,r.indices);return nullptr;} + r.count=mesh.indices.size();r.bytes=vb+ib;r.lastUsed=frame_;residentBytes_+=r.bytes;++residentUploads_; + return &resident_.emplace(geometry.get(),std::move(r)).first->second; +} +bool HardwareScene::Render(SDL_Renderer* renderer,int width,int height,const std::vector& vertices,const std::vector& indices,const std::vector& batches) { + if(batches.empty())return true; + const auto tick=SDL_GetPerformanceCounter();++frame_;lastDrawCalls_=0; + if(!Initialize(renderer,width,height))return false; + if(textureBytes_>textureBudget_) { + std::unordered_set activeTextures{white_}; + for(const auto& b:batches)if(b.texture)activeTextures.insert(b.texture); + for(auto& [key,entry]:textures_)if(activeTextures.count(entry.texture))entry.lastUsed=frame_; + while(textureBytes_>textureBudget_) { + auto oldest=textures_.end(); + for(auto it=textures_.begin();it!=textures_.end();++it) { + if(it->second.lastUsed>=frame_ || it->second.texture==white_)continue; + if(oldest==textures_.end() || it->second.lastUsedsecond.lastUsed)oldest=it; + } + if(oldest==textures_.end())break; // active working set is protected, even above the soft budget + textureBytes_-=oldest->second.bytes;SDL_ReleaseGPUTexture(device_,oldest->second.texture);textures_.erase(oldest); + } + } + // Cached buffers can be released without waiting; SDL defers GPU destruction. + for(auto it=resident_.begin();it!=resident_.end();) { + if(residentBytes_>256u*1024u*1024u && it->second.lastUsed+2second.bytes;SDL_ReleaseGPUBuffer(device_,it->second.vertices);SDL_ReleaseGPUBuffer(device_,it->second.indices);it=resident_.erase(it); + }else ++it; + } + std::vector meshes;meshes.reserve(batches.size()); + for(const auto& b:batches){if(!Pipeline(b))return false;auto* mesh=b.geometry ? Resident(b.geometry) : nullptr;if(b.geometry&&!mesh)return false;meshes.push_back(mesh);} + uint32_t vb=vertices.size()*sizeof(HardwareVertex),ib=indices.size()*sizeof(uint32_t); + lastDynamicBytes_=vb+ib; + if(vb>vertexBytes_||ib>indexBytes_) { + if(vertices_)SDL_ReleaseGPUBuffer(device_,vertices_);if(indices_)SDL_ReleaseGPUBuffer(device_,indices_);if(transfer_)SDL_ReleaseGPUTransferBuffer(device_,transfer_); + vertexBytes_=std::max(vb,vertexBytes_)*2;indexBytes_=std::max(ib,indexBytes_)*2; + SDL_GPUBufferCreateInfo bi{};bi.usage=SDL_GPU_BUFFERUSAGE_VERTEX;bi.size=vertexBytes_;vertices_=SDL_CreateGPUBuffer(device_,&bi); + bi.usage=SDL_GPU_BUFFERUSAGE_INDEX;bi.size=indexBytes_;indices_=SDL_CreateGPUBuffer(device_,&bi); + SDL_GPUTransferBufferCreateInfo ti{};ti.usage=SDL_GPU_TRANSFERBUFFERUSAGE_UPLOAD;ti.size=vertexBytes_+indexBytes_;transfer_=SDL_CreateGPUTransferBuffer(device_,&ti); + } + if(vb || ib){ + if(!vertices_||!indices_||!transfer_)return false; + auto* data=static_cast(SDL_MapGPUTransferBuffer(device_,transfer_,true));if(!data)return false; + std::memcpy(data,vertices.data(),vb);std::memcpy(data+vb,indices.data(),ib);SDL_UnmapGPUTransferBuffer(device_,transfer_); + } + const uint32_t instanceSize=std::max(1,batches.size())*sizeof(HardwareTransform); + if(instanceSize>instanceBytes_){ + if(instances_)SDL_ReleaseGPUBuffer(device_,instances_);if(instanceTransfer_)SDL_ReleaseGPUTransferBuffer(device_,instanceTransfer_); + instanceBytes_=instanceSize*2;SDL_GPUBufferCreateInfo bi{};bi.usage=SDL_GPU_BUFFERUSAGE_GRAPHICS_STORAGE_READ;bi.size=instanceBytes_;instances_=SDL_CreateGPUBuffer(device_,&bi); + SDL_GPUTransferBufferCreateInfo ti{};ti.usage=SDL_GPU_TRANSFERBUFFERUSAGE_UPLOAD;ti.size=instanceBytes_;instanceTransfer_=SDL_CreateGPUTransferBuffer(device_,&ti); + } + if(!instances_||!instanceTransfer_)return false; + auto* instData=static_cast(SDL_MapGPUTransferBuffer(device_,instanceTransfer_,true));if(!instData)return false; + for(size_t i=0;i0.5f) + while(i+countvertices : vertices_,0};SDL_BindGPUVertexBuffers(pass,0,&binding,1); + binding.buffer=mesh ? mesh->indices : indices_;SDL_BindGPUIndexBuffer(pass,&binding,SDL_GPU_INDEXELEMENTSIZE_32BIT); + SDL_BindGPUGraphicsPipeline(pass,Pipeline(batch)); + SDL_GPUTextureSamplerBinding texture{batch.texture ? batch.texture : white_,sampler_};SDL_BindGPUFragmentSamplers(pass,0,&texture,1); + float params[4]={batch.alphaRef,(!batch.blend&&!batch.additive)?1.f:0.f,0,0};SDL_PushGPUFragmentUniformData(cmd,0,params,sizeof(params)); + auto transform=batch.transform;if(count>1)transform.modes[0]=2; + SDL_PushGPUVertexUniformData(cmd,0,&transform,sizeof(transform)); + if(transform.skin[0]>0){std::fill(std::begin(palette),std::end(palette),0);std::copy_n(batch.palette.data(),std::min(batch.palette.size(),size_t(128*16)),palette);SDL_PushGPUVertexUniformData(cmd,1,palette,sizeof(palette));} + SDL_DrawGPUIndexedPrimitives(pass,batch.indexCount,count,mesh ? 0 : batch.firstIndex,0,count>1 ? i : 0);++lastDrawCalls_;i+=count; + } + SDL_EndGPURenderPass(pass);const auto beforeSubmit=SDL_GetPerformanceCounter(); + if(!SDL_SubmitGPUCommandBuffer(cmd))return false; + static unsigned count=0;if(++count%120==0)SDL_Log("Resident GPU batches=%zu calls=%zu dynamic=%zu resident=%zu uploads=%zu encode=%.2f submit=%.2f ms",batches.size(),lastDrawCalls_,lastDynamicBytes_,residentBytes_,residentUploads_,1000.0*(beforeSubmit-tick)/SDL_GetPerformanceFrequency(),1000.0*(SDL_GetPerformanceCounter()-beforeSubmit)/SDL_GetPerformanceFrequency()); + float w,h;SDL_Texture* target=SDL_GetRenderTarget(renderer); + if(target)SDL_GetTextureSize(target,&w,&h);else {int lw,lh;SDL_RendererLogicalPresentation lp;SDL_GetRenderLogicalPresentation(renderer,&lw,&lh,&lp);w=lw;h=lh;if(w<=0||h<=0){int pw,ph;SDL_GetRenderOutputSize(renderer,&pw,&ph);w=pw;h=ph;}} + SDL_FRect rect{0,0,w,h};return SDL_RenderTexture(renderer,output_,nullptr,&rect); +} +} diff --git a/src/eter_render/HardwareScene.h b/src/eter_render/HardwareScene.h new file mode 100644 index 00000000..8d1969c4 --- /dev/null +++ b/src/eter_render/HardwareScene.h @@ -0,0 +1,84 @@ +#pragma once +#include +#include +#include +#include +#include +#include +#include "RenderCommands3D.h" +namespace ava2 { +struct HardwareVertex { + float position[4], color[4], uv[2]; + float normal[4]{}; + uint32_t bones[4]{}; + float weights[4]{}; +}; +struct HardwareTransform { + float world[16]{}, mvp[16]{}; + float diffuse[4]{}, ambient[4]{}, emissive[4]{}; + float lightDirection[4]{}, lightAmbient[4]{}, lightDiffuse[4]{}; + float fogColor[4]{}, fogParams[4]{}; + float modes[4]{}; // raw vertices, lighting, fog type, disable depth + float skin[4]{}; // palette count +}; +static_assert(sizeof(HardwareTransform)==288); +HardwareVertex MakeHardwareVertex(const Render3DDraw& mesh, size_t index); +struct HardwareBatch { + uint32_t firstIndex, indexCount; + SDL_GPUTexture* texture; + uint32_t cull; + bool depth, depthWrite, blend, additive; + float alphaRef; + HardwareTransform transform{}; + std::shared_ptr geometry; + std::vector palette; + +}; +class HardwareScene { +public: + explicit HardwareScene(SDL_GPUDevice* device): device_(device) {} + ~HardwareScene(); + SDL_GPUTexture* FindTexture(const std::string& key); + void SetTextureBudget(size_t bytes) { textureBudget_=bytes; } + size_t GetTextureBytes() const { return textureBytes_; } + size_t GetTextureUploadCount() const { return textureUploads_; } + SDL_GPUTexture* Texture(const std::string& key, int width, int height, const void* rgba); + bool Render(SDL_Renderer* renderer, int width, int height, + const std::vector& vertices, + const std::vector& indices, + const std::vector& batches); + size_t GetResidentUploadCount() const { return residentUploads_; } + size_t GetLastDrawCallCount() const { return lastDrawCalls_; } + size_t GetLastDynamicUploadBytes() const { return lastDynamicBytes_; } +private: + struct ResidentMesh { + std::shared_ptr source; + SDL_GPUBuffer *vertices=nullptr, *indices=nullptr; + uint32_t count=0, bytes=0; + uint64_t lastUsed=0; + }; + ResidentMesh* Resident(const std::shared_ptr& geometry); + std::unordered_map resident_; + uint64_t frame_=0; + size_t residentBytes_=0, residentUploads_=0, lastDrawCalls_=0, lastDynamicBytes_=0; + SDL_GPUBuffer* instances_=nullptr; + SDL_GPUTransferBuffer* instanceTransfer_=nullptr; + uint32_t instanceBytes_=0; + bool Initialize(SDL_Renderer* renderer, int width, int height); + SDL_GPUGraphicsPipeline* Pipeline(const HardwareBatch& batch); + SDL_GPUDevice* device_; + SDL_GPUShader *vertex_=nullptr, *fragment_=nullptr; + SDL_GPUSampler* sampler_=nullptr; + SDL_GPUTexture *color_=nullptr, *depth_=nullptr; + SDL_Texture* output_=nullptr; + SDL_GPUTexture* white_=nullptr; + struct TextureEntry {SDL_GPUTexture* texture;size_t bytes;uint64_t lastUsed;}; + std::unordered_map textures_; + size_t textureBytes_=0,textureUploads_=0,textureBudget_=256u*1024u*1024u; + SDL_GPUBuffer *vertices_=nullptr, *indices_=nullptr; + SDL_GPUTransferBuffer* transfer_=nullptr; + uint32_t vertexBytes_=0, indexBytes_=0; + int width_=0,height_=0; + std::unordered_map pipelines_; +}; +} diff --git a/src/eter_render/MapObjectManager.cpp b/src/eter_render/MapObjectManager.cpp index 2d482b4f..f82c7b29 100644 --- a/src/eter_render/MapObjectManager.cpp +++ b/src/eter_render/MapObjectManager.cpp @@ -1,4 +1,5 @@ #include "MapObjectManager.h" +#include #include "src/eter_render/SpeedTreeForest.h" #include #include @@ -130,7 +131,7 @@ std::shared_ptr MapObjectManager::GetOrLoadModel(const std::st return nullptr; } -bool MapObjectManager::LoadAreaData(const std::string& areadata_path, float coord_scale, SpeedTreeForest* forest) { +bool MapObjectManager::LoadAreaData(const std::string& areadata_path, float coord_scale, SpeedTreeForest* forest, bool native_y) { std::ifstream file(areadata_path); if (!file.is_open()) { std::cerr << "MapObjectManager::LoadAreaData failed to open: " << areadata_path << std::endl; @@ -166,6 +167,8 @@ bool MapObjectManager::LoadAreaData(const std::string& areadata_path, float coor std::istringstream iss(block_lines[0]); iss >> px >> py >> pz; + // AVA2 areadata stores the render-space Y sign; packets use positive map Y. + if (native_y) py = -py; try { crc = static_cast(std::stoul(block_lines[1])); @@ -182,6 +185,12 @@ bool MapObjectManager::LoadAreaData(const std::string& areadata_path, float coor if (s2 != std::string::npos) { pitch = std::stof(rot_str.substr(s1 + 1, s2 - s1 - 1)); roll = std::stof(rot_str.substr(s2 + 1)); + if (native_y) { + // Native roll rotates about Z (up); that is engine Y yaw. + const float nativeYaw = yaw; + yaw = roll; + roll = -nativeYaw; + } } } else { try { yaw = std::stof(rot_str); } catch (...) {} @@ -296,8 +305,44 @@ bool MapObjectManager::AddObject(const std::string& model_path, float x, float y return true; } +const std::vector& MapObjectManager::CollisionCandidates(float x,float z,float radius) const { + constexpr double cell=512; + if(m_collisionCount!=m_objects.size()) { + m_collisionCells.clear();m_largeCollisionObjects.clear();m_allCollisionObjects.clear(); + for(size_t i=0;i1e9 || std::abs(cz)+r>1e9 || r>4096) { + m_largeCollisionObjects.push_back(i);continue; + } + const auto x0=int64_t(std::floor((cx-r)/cell)),x1=int64_t(std::floor((cx+r)/cell)); + const auto z0=int64_t(std::floor((cz-r)/cell)),z1=int64_t(std::floor((cz+r)/cell)); + if((x1-x0+1)*(z1-z0+1)>256){m_largeCollisionObjects.push_back(i);continue;} + for(auto gx=x0;gx<=x1;++gx)for(auto gz=z0;gz<=z1;++gz)m_collisionCells[{gx,gz}].push_back(i); + } + m_collisionCount=m_objects.size(); + } + m_collisionCandidates.clear(); + if(!std::isfinite(x) || !std::isfinite(z) || !std::isfinite(radius) || radius<0 || radius>4096 || std::abs(double(x))+radius>1e9 || std::abs(double(z))+radius>1e9) { + m_collisionCandidates=m_allCollisionObjects;return m_collisionCandidates; + } + m_collisionCandidates.insert(m_collisionCandidates.end(),m_largeCollisionObjects.begin(),m_largeCollisionObjects.end()); + const auto x0=int64_t(std::floor((double(x)-radius)/cell)),x1=int64_t(std::floor((double(x)+radius)/cell)); + const auto z0=int64_t(std::floor((double(z)-radius)/cell)),z1=int64_t(std::floor((double(z)+radius)/cell)); + for(auto gx=x0;gx<=x1;++gx)for(auto gz=z0;gz<=z1;++gz) { + auto it=m_collisionCells.find({gx,gz});if(it!=m_collisionCells.end())m_collisionCandidates.insert(m_collisionCandidates.end(),it->second.begin(),it->second.end()); + } + // Preserve the original first-hit normal when OBBs overlap, independent of cell order. + std::sort(m_collisionCandidates.begin(),m_collisionCandidates.end()); + m_collisionCandidates.erase(std::unique(m_collisionCandidates.begin(),m_collisionCandidates.end()),m_collisionCandidates.end()); + return m_collisionCandidates; +} + bool MapObjectManager::CheckCollision(float worldX, float worldZ, float actorRadius) const { - for (const auto& obj : m_objects) { + for (auto index : CollisionCandidates(worldX,worldZ,actorRadius)) { + const auto& obj=m_objects[index]; if (!obj.has_collision) continue; float maxR = std::max(obj.obb.halfExtents[0], obj.obb.halfExtents[2]) * 1.5f + actorRadius; float dx = worldX - obj.obb.centerX; @@ -312,7 +357,8 @@ bool MapObjectManager::CheckCollision(float worldX, float worldZ, float actorRad } bool MapObjectManager::CheckCollisionNormal(float worldX, float worldZ, float actorRadius, float& outNx, float& outNz) const { - for (const auto& obj : m_objects) { + for (auto index : CollisionCandidates(worldX,worldZ,actorRadius)) { + const auto& obj=m_objects[index]; if (!obj.has_collision) continue; float maxR = std::max(obj.obb.halfExtents[0], obj.obb.halfExtents[2]) * 1.5f + actorRadius; float dx = worldX - obj.obb.centerX; @@ -327,23 +373,46 @@ bool MapObjectManager::CheckCollisionNormal(float worldX, float worldZ, float ac return false; } -std::vector MapObjectManager::BuildDrawCommands() const { +std::vector MapObjectManager::BuildDrawCommands(const float* view, const float* proj) const { std::vector all_draws; for (const auto& obj : m_objects) { if (!obj.model) continue; float world[16]; MakeFullTransformMatrix(obj.yaw, obj.pitch, obj.roll, obj.x, obj.y, obj.z, obj.scale, world); - auto draws = obj.model->BuildDrawCommands(-1.0f, world); - for (auto& d : draws) { - all_draws.push_back(std::move(d)); + if (!obj.draws_cached) { + obj.cached_draws = obj.model->BuildDrawCommands(-1.0f, world, true); + std::fill_n(obj.bounds_min, 3, std::numeric_limits::max()); + std::fill_n(obj.bounds_max, 3, std::numeric_limits::lowest()); + for (const auto& draw : obj.cached_draws) { + for (size_t i=0; i+2::max(); + m_collisionCells.clear();m_allCollisionObjects.clear();m_largeCollisionObjects.clear();m_collisionCandidates.clear(); } } // namespace ava2 diff --git a/src/eter_render/MapObjectManager.h b/src/eter_render/MapObjectManager.h index 6d4a8225..ddfca8d8 100644 --- a/src/eter_render/MapObjectManager.h +++ b/src/eter_render/MapObjectManager.h @@ -7,6 +7,8 @@ #include #include #include +#include +#include #include #include @@ -96,6 +98,9 @@ struct MapObjectInstance { std::shared_ptr model; OrientedBoundingBox obb; bool has_collision = true; + mutable float bounds_min[3]{}, bounds_max[3]{}; + mutable bool draws_cached = false; + mutable std::vector cached_draws; }; class SpeedTreeForest; @@ -117,7 +122,7 @@ public: size_t ScanPropertyDirectory(const std::string& prop_dir); // Load AreaData.txt and instantiate objects (GR2 buildings and SpeedTree instances) - bool LoadAreaData(const std::string& areadata_path, float coord_scale = 1.0f, SpeedTreeForest* forest = nullptr); + bool LoadAreaData(const std::string& areadata_path, float coord_scale = 1.0f, SpeedTreeForest* forest = nullptr, bool native_y = false); // Manually add an object instance bool AddObject(const std::string& model_path, float x, float y, float z, @@ -128,12 +133,13 @@ public: bool CheckCollisionNormal(float worldX, float worldZ, float actorRadius, float& outNx, float& outNz) const; // Build 3D draw commands for all instantiated objects - std::vector BuildDrawCommands() const; + std::vector BuildDrawCommands(const float* view = nullptr, const float* proj = nullptr) const; // Clear all instantiated objects (retaining loaded model cache) void ClearObjects(); // Query stats + size_t GetLastCollisionCandidateCount() const { return m_collisionCandidates.size(); } size_t GetObjectCount() const { return m_objects.size(); } size_t GetPropertyCount() const { return m_property_map.size(); } size_t GetCachedModelCount() const { return m_model_cache.size(); } @@ -141,11 +147,16 @@ public: const std::vector& GetObjects() const { return m_objects; } private: + const std::vector& CollisionCandidates(float x,float z,float radius) const; + mutable size_t m_collisionCount=std::numeric_limits::max(); + mutable std::map,std::vector> m_collisionCells; + mutable std::vector m_largeCollisionObjects,m_allCollisionObjects,m_collisionCandidates; std::shared_ptr GetOrLoadModel(const std::string& path); static std::string NormalizePath(const std::string& path); std::unordered_map m_property_map; std::unordered_map> m_model_cache; + mutable std::unordered_map>> m_meshStreams; std::vector m_objects; }; diff --git a/src/eter_render/OrbitCamera.cpp b/src/eter_render/OrbitCamera.cpp index 35da7fca..203a4f79 100644 --- a/src/eter_render/OrbitCamera.cpp +++ b/src/eter_render/OrbitCamera.cpp @@ -49,10 +49,10 @@ void OrbitCamera::GetEye(float& eyeX, float& eyeY, float& eyeZ) const { eyeX = m_targetX - horiz * std::sin(yawRad); eyeY = m_targetY + m_targetHeight + vert; - eyeZ = m_targetZ - horiz * std::cos(yawRad); + eyeZ = m_targetZ + horiz * std::cos(yawRad); } -void OrbitCamera::UpdateWithTerrain(const TerrainHeightmap* terrain) { +void OrbitCamera::UpdateWithTerrain(const TerrainHeightSource* terrain) { if (!terrain) return; float pitchRad = m_pitch * DEG_TO_RAD; @@ -63,7 +63,7 @@ void OrbitCamera::UpdateWithTerrain(const TerrainHeightmap* terrain) { float eyeX = m_targetX - horiz * std::sin(yawRad); float eyeY = m_targetY + m_targetHeight + vert; - float eyeZ = m_targetZ - horiz * std::cos(yawRad); + float eyeZ = m_targetZ + horiz * std::cos(yawRad); float groundY = terrain->GetHeightAtWorld(eyeX, eyeZ); float minGroundY = groundY + 45.0f; @@ -103,7 +103,7 @@ void OrbitCamera::ApplyToRenderer(Gr2SceneRenderer& renderer) const { float tX = 0.0f, tY = 0.0f, tZ = 0.0f; GetLookTarget(tX, tY, tZ); - renderer.SetCameraLookAt(eyeX, eyeY, eyeZ, tX, tY, tZ, 0.0f, 1.0f, 0.0f); + renderer.SetCameraLookAtRH(eyeX, eyeY, eyeZ, tX, tY, tZ, 0.0f, 1.0f, 0.0f); } } // namespace ava2 diff --git a/src/eter_render/OrbitCamera.h b/src/eter_render/OrbitCamera.h index 9375ba89..f984ed2f 100644 --- a/src/eter_render/OrbitCamera.h +++ b/src/eter_render/OrbitCamera.h @@ -47,7 +47,7 @@ public: void Zoom(float wheelDelta, float zoomStep = 40.0f); // Collision avoidance with terrain heightmap - void UpdateWithTerrain(const class TerrainHeightmap* terrain); + void UpdateWithTerrain(const class TerrainHeightSource* terrain); // Coordinate Queries void GetEye(float& eyeX, float& eyeY, float& eyeZ) const; @@ -67,7 +67,7 @@ private: float m_yaw = 0.0f; float m_minDistance = 120.0f; - float m_maxDistance = 1800.0f; + float m_maxDistance = 2500.0f; float m_minPitch = 5.0f; float m_maxPitch = 85.0f; diff --git a/src/eter_render/RaceData.cpp b/src/eter_render/RaceData.cpp index 64cf70af..f5d3de5f 100644 --- a/src/eter_render/RaceData.cpp +++ b/src/eter_render/RaceData.cpp @@ -449,6 +449,21 @@ void RaceManager::LoadPlayerRaces() { case 2: race->RegisterAttachingBoneName(RaceData::PART_WEAPON, "equip_right"); break; } race->RegisterAttachingBoneName(RaceData::PART_SASH, "Bip01 Spine2"); // ENABLE_SASH_SYSTEM + race->RegisterMotionData(RaceData::NAME_INTRO_WAIT, kRaces[i].path + std::string("intro/wait.msa"), 100); + race->RegisterMotionData(RaceData::NAME_INTRO_SELECTED, kRaces[i].path + std::string("intro/selected.msa"), 100); + race->RegisterMotionData(RaceData::NAME_INTRO_NOT_SELECTED, kRaces[i].path + std::string("intro/not_selected.msa"), 100); + race->RegisterMotionData(RaceData::NAME_WAIT, kRaces[i].path + std::string("general/wait.msa"), 100); + race->RegisterMotionData(RaceData::NAME_WALK, kRaces[i].path + std::string("general/walk.msa"), 100); + race->RegisterMotionData(RaceData::NAME_RUN, kRaces[i].path + std::string("general/run.msa"), 100); + race->RegisterMotionData(RaceData::NAME_DEAD, kRaces[i].path + std::string("general/dead.msa"), 100); + // CPythonPlayerSettingsModule::__LoadHorse: mounted riders use a distinct pose. + race->RegisterMotionMode(9); + for (const auto& motion : {std::pair{RaceData::NAME_WAIT, "wait.msa"}, + std::pair{RaceData::NAME_WALK, "walk.msa"}, + std::pair{RaceData::NAME_RUN, "run.msa"}, + std::pair{RaceData::NAME_DEAD, "dead.msa"}}) + race->RegisterMotion(9, motion.first, kRaces[i].path + std::string("horse/") + motion.second, 100); + } } diff --git a/src/eter_render/RenderCommands3D.h b/src/eter_render/RenderCommands3D.h index a5bec3e4..079763e5 100644 --- a/src/eter_render/RenderCommands3D.h +++ b/src/eter_render/RenderCommands3D.h @@ -4,6 +4,7 @@ #include #include #include +#include namespace ava2 { @@ -17,9 +18,46 @@ inline void MakeTransformMatrix(float yawDegrees, float tx, float ty, float tz, out[12] = tx; out[13] = ty; out[14] = tz; out[15] = 1.0f; } +// Conservative homogeneous frustum rejection, including near/far planes. +// Reject only when every AABB corner is outside the same plane. +inline bool IsBoundsVisible(const float lo[3], const float hi[3], const float* view, const float* proj) { + if (!view || !proj) return true; + unsigned outside = 63; + for (unsigned corner = 0; corner < 8; ++corner) { + float p[4] = {corner&1 ? hi[0] : lo[0], corner&2 ? hi[1] : lo[1], corner&4 ? hi[2] : lo[2], 1}; + float v[4]{}, c[4]{}; + for (int j=0;j<4;++j) for(int k=0;k<4;++k) v[j]+=p[k]*view[k*4+j]; + for (int j=0;j<4;++j) for(int k=0;k<4;++k) c[j]+=v[k]*proj[k*4+j]; + unsigned bits = (c[0]<-c[3] ? 1:0) | (c[0]>c[3] ? 2:0) | (c[1]<-c[3] ? 4:0) | + (c[1]>c[3] ? 8:0) | (c[2]<0 ? 16:0) | (c[2]>c[3] ? 32:0); + outside &= bits; + if (!outside) return true; + } + return outside == 0; +} + // Intermediate 3D draw command structure, modeled after 40250 cross-platform architecture. // Decouples game logic/animation (GR2) from the underlying GPU/software renderer. struct Render3DDraw { + // Per-frame commands reference immutable mesh streams; transforms/material remain local. + std::shared_ptr geometry; + const Render3DDraw& Mesh() const { return geometry ? *geometry : *this; } + static Render3DDraw ShareGeometry(Render3DDraw source) { + Render3DDraw command = source; + command.positions.clear(); command.positions.shrink_to_fit(); + command.normals.clear(); command.normals.shrink_to_fit(); + command.uv0.clear(); command.uv0.shrink_to_fit(); + command.uv1.clear(); command.uv1.shrink_to_fit(); + command.diffuse.clear(); command.diffuse.shrink_to_fit(); + command.indices.clear(); command.indices.shrink_to_fit(); + command.bone_indices.clear(); command.bone_indices.shrink_to_fit(); + command.bone_weights.clear(); command.bone_weights.shrink_to_fit(); + command.bone_matrices.clear(); command.bone_matrices.shrink_to_fit(); + command.geometry = std::make_shared(std::move(source)); + return command; + } + + bool gpu_skinning = false; std::uint64_t geometry_key = 0; std::uint64_t geometry_revision = 0; @@ -56,15 +94,16 @@ struct Render3DDraw { bool alpha_test = false; std::uint32_t alpha_ref = 0; bool fog = true; + bool terrain = false; // SDL painter layers keep terrain splats ahead of actors. // Lighting & Material bool lighting = true; float material_diffuse[4] = {1.0f, 1.0f, 1.0f, 1.0f}; - float material_ambient[4] = {0.4f, 0.4f, 0.4f, 1.0f}; - float material_emissive[4] = {0.0f, 0.0f, 0.0f, 0.0f}; + float material_ambient[4] = {0.85f, 0.85f, 0.85f, 1.0f}; + float material_emissive[4] = {0.05f, 0.05f, 0.05f, 0.05f}; float light_direction[3] = {0.577f, 0.577f, -0.577f}; // Normalized key light float light_diffuse[4] = {1.0f, 1.0f, 1.0f, 1.0f}; - float light_ambient[4] = {0.3f, 0.3f, 0.3f, 1.0f}; + float light_ambient[4] = {0.55f, 0.55f, 0.55f, 1.0f}; }; } // namespace ava2 diff --git a/src/eter_render/SkyBox.cpp b/src/eter_render/SkyBox.cpp index 7c2d6aad..95b6c052 100644 --- a/src/eter_render/SkyBox.cpp +++ b/src/eter_render/SkyBox.cpp @@ -81,7 +81,7 @@ std::vector SkyBox::BuildDrawCommands(const float* viewMatrix, } // Radiant Sun Flare Billboard - if (m_env.lens_flare.main_flare_enable && !m_env.lens_flare.main_flare_file_name.empty()) { + if (m_env.lens_flare.enable && m_env.lens_flare.main_flare_enable && !m_env.lens_flare.main_flare_file_name.empty()) { draws.push_back(BuildSunFlareBillboard(viewMatrix, camEyeX, camEyeY, camEyeZ)); } @@ -89,137 +89,44 @@ std::vector SkyBox::BuildDrawCommands(const float* viewMatrix, } Render3DDraw SkyBox::BuildGradientSkyDome(float camEyeX, float camEyeY, float camEyeZ) { + // AVA2 EterLib/SkyBox.cpp SetSkyObjectQuadVertical/SetSkyColor: four + // vertical cube faces, upper/lower height bands, plus flat top and bottom. Render3DDraw draw; - draw.lighting = false; - draw.fog = false; - draw.z_enable = false; // Pure background layer - draw.z_write = false; - draw.cull_mode = 1; // Double-sided / interior facing - - constexpr int SECTORS = 24; - constexpr int NUM_UPPER = 8; - constexpr int NUM_LOWER = 4; - constexpr int NUM_RINGS = NUM_UPPER + NUM_LOWER + 1; - - struct RingLevel { - float y_offset; - float radius; - uint32_t color; + draw.lighting=draw.fog=draw.z_enable=draw.z_write=false; + draw.cull_mode=1; + const auto& sky=m_env.skybox; + const int upper=std::max(1,int(sky.gradient_level_upper)); + const int lower=std::max(1,int(sky.gradient_level_lower)); + const float sx=sky.scale[0]>0 ? sky.scale[0] : m_radius; + const float sy=sky.scale[2]>0 ? sky.scale[2] : m_radius; + const float sz=sky.scale[1]>0 ? sky.scale[1] : m_radius; + auto color=[&](int band,bool top) { + if(sky.gradients.empty())return 0xff80b3f2u; + const auto& gradient=sky.gradients[std::min(size_t(band),sky.gradients.size()-1)]; + return ColorToUint(top ? gradient.first : gradient.second) | 0xff000000; }; - - std::vector rings; - rings.reserve(NUM_RINGS); - - // Build upper rings (zenith 80 deg down to horizon 2 deg) - for (int k = 0; k <= NUM_UPPER; ++k) { - float t = static_cast(k) / static_cast(NUM_UPPER); // 0 at top, 1 at horizon - float angle_deg = 80.0f - t * 78.0f; // 80 -> 2 deg - float phi = angle_deg * DEG2RAD; - float y_off = m_radius * std::sin(phi); - float rad = m_radius * std::cos(phi); - - float col[4]; - float grad_t = t * 0.80f; // Maps to upper portion of gradients - InterpolateGradientColor(m_env.skybox.gradients, grad_t, col); - rings.push_back({y_off, rad, ColorToUint(col)}); + auto quad=[&](float x0,float z0,float x1,float z1,float bottom,float top,uint32_t lowColor,uint32_t highColor) { + uint32_t base=draw.positions.size()/3; + draw.positions.insert(draw.positions.end(),{camEyeX+x0,camEyeY+bottom,camEyeZ+z0, + camEyeX+x0,camEyeY+top,camEyeZ+z0,camEyeX+x1,camEyeY+bottom,camEyeZ+z1, + camEyeX+x1,camEyeY+top,camEyeZ+z1}); + draw.diffuse.insert(draw.diffuse.end(),{lowColor,highColor,lowColor,highColor}); + draw.indices.insert(draw.indices.end(),{base,base+1,base+2,base+2,base+1,base+3}); + }; + const float corners[4][2]={{-sx,-sz},{sx,-sz},{sx,sz},{-sx,sz}}; + for(int side=0;side<4;++side)for(int band=0;band(k) / static_cast(NUM_LOWER); - float angle_deg = -2.0f - t * 34.0f; // -2 -> -36 deg - float phi = angle_deg * DEG2RAD; - float y_off = m_radius * std::sin(phi); - float rad = m_radius * std::cos(phi); - - float col[4]; - float grad_t = 0.80f + t * 0.20f; - InterpolateGradientColor(m_env.skybox.gradients, grad_t, col); - rings.push_back({y_off, rad, ColorToUint(col)}); + for(int face=0;face<2;++face) { + uint32_t base=draw.positions.size()/3; + float height=(face ? -1.f : 1.f)*sy; + for(const auto& corner:corners)draw.positions.insert(draw.positions.end(),{camEyeX+corner[0],camEyeY+height,camEyeZ+corner[1]}); + draw.diffuse.insert(draw.diffuse.end(),4,color(face ? upper+lower-1 : 0,face==0)); + draw.indices.insert(draw.indices.end(),{base,base+1,base+2,base,base+2,base+3}); } - - int total_rings = static_cast(rings.size()); - - // Top zenith vertex - float top_col[4]; - InterpolateGradientColor(m_env.skybox.gradients, 0.0f, top_col); - uint32_t top_vertex_idx = 0; - draw.positions.push_back(camEyeX); - draw.positions.push_back(camEyeY + m_radius * 0.98f); - draw.positions.push_back(camEyeZ); - draw.diffuse.push_back(ColorToUint(top_col)); - draw.normals.push_back(0.0f); draw.normals.push_back(-1.0f); draw.normals.push_back(0.0f); - draw.uv0.push_back(0.5f); draw.uv0.push_back(0.0f); - - // Ring vertices - std::vector> ring_indices(total_rings, std::vector(SECTORS + 1)); - for (int r = 0; r < total_rings; ++r) { - for (int s = 0; s <= SECTORS; ++s) { - float theta = (2.0f * PI * static_cast(s)) / static_cast(SECTORS); - float vx = camEyeX + rings[r].radius * std::cos(theta); - float vy = camEyeY + rings[r].y_offset; - float vz = camEyeZ + rings[r].radius * std::sin(theta); - - uint32_t idx = static_cast(draw.positions.size() / 3); - ring_indices[r][s] = idx; - - draw.positions.push_back(vx); - draw.positions.push_back(vy); - draw.positions.push_back(vz); - draw.diffuse.push_back(rings[r].color); - - float nx = -std::cos(theta); - float ny = -rings[r].y_offset / m_radius; - float nz = -std::sin(theta); - draw.normals.push_back(nx); draw.normals.push_back(ny); draw.normals.push_back(nz); - draw.uv0.push_back(static_cast(s) / static_cast(SECTORS)); - draw.uv0.push_back(static_cast(r) / static_cast(total_rings)); - } - } - - // Bottom nadir vertex - float bot_col[4]; - InterpolateGradientColor(m_env.skybox.gradients, 1.0f, bot_col); - uint32_t bottom_vertex_idx = static_cast(draw.positions.size() / 3); - draw.positions.push_back(camEyeX); - draw.positions.push_back(camEyeY - m_radius * 0.65f); - draw.positions.push_back(camEyeZ); - draw.diffuse.push_back(ColorToUint(bot_col)); - draw.normals.push_back(0.0f); draw.normals.push_back(1.0f); draw.normals.push_back(0.0f); - draw.uv0.push_back(0.5f); draw.uv0.push_back(1.0f); - - // Top fan triangles - for (int s = 0; s < SECTORS; ++s) { - draw.indices.push_back(top_vertex_idx); - draw.indices.push_back(ring_indices[0][s + 1]); - draw.indices.push_back(ring_indices[0][s]); - } - - // Quads between successive rings - for (int r = 0; r < total_rings - 1; ++r) { - for (int s = 0; s < SECTORS; ++s) { - uint32_t v00 = ring_indices[r][s]; - uint32_t v01 = ring_indices[r][s + 1]; - uint32_t v10 = ring_indices[r + 1][s]; - uint32_t v11 = ring_indices[r + 1][s + 1]; - - draw.indices.push_back(v00); - draw.indices.push_back(v01); - draw.indices.push_back(v10); - - draw.indices.push_back(v01); - draw.indices.push_back(v11); - draw.indices.push_back(v10); - } - } - - // Bottom fan triangles - for (int s = 0; s < SECTORS; ++s) { - draw.indices.push_back(ring_indices[total_rings - 1][s]); - draw.indices.push_back(ring_indices[total_rings - 1][s + 1]); - draw.indices.push_back(bottom_vertex_idx); - } - return draw; } @@ -282,25 +189,24 @@ Render3DDraw SkyBox::BuildCloudPlane(float camEyeX, float camEyeY, float camEyeZ draw.blend_mode = 0; // Alpha blend constexpr int GRID = 8; - float half_size = m_radius * 0.85f; - float cloud_y = camEyeY + 750.0f; + float half_x = m_env.skybox.cloud_scale[0]; + float half_z = m_env.skybox.cloud_scale[1]; + float cloud_y = camEyeY + m_env.skybox.cloud_height; float scale_u = m_env.skybox.cloud_texture_scale[0] > 0.0f ? m_env.skybox.cloud_texture_scale[0] : 4.0f; float scale_v = m_env.skybox.cloud_texture_scale[1] > 0.0f ? m_env.skybox.cloud_texture_scale[1] : 4.0f; for (int j = 0; j <= GRID; ++j) { float fz = static_cast(j) / static_cast(GRID); - float z = camEyeZ + (fz - 0.5f) * 2.0f * half_size; + float z = camEyeZ + (fz - 0.5f) * 2.0f * half_z; for (int i = 0; i <= GRID; ++i) { float fx = static_cast(i) / static_cast(GRID); - float x = camEyeX + (fx - 0.5f) * 2.0f * half_size; + float x = camEyeX + (fx - 0.5f) * 2.0f * half_x; - float dx = (fx - 0.5f) * 2.0f; - float dz = (fz - 0.5f) * 2.0f; - float dist_sq = dx * dx + dz * dz; - float alpha = std::clamp(1.0f - dist_sq * 0.70f, 0.0f, 1.0f) * 0.78f; - uint32_t a_byte = static_cast(alpha * 255.0f); - uint32_t col = (a_byte << 24) | 0x00FFFFFF; + float cloudColor[4]; + for(int channel=0;channel<4;++channel) + cloudColor[channel]=m_env.skybox.cloud_color.first[channel]*(1.f-fz)+m_env.skybox.cloud_color.second[channel]*fz; + uint32_t col=ColorToUint(cloudColor); draw.positions.push_back(x); draw.positions.push_back(cloud_y); diff --git a/src/eter_render/SpeedTreeRT.cpp b/src/eter_render/SpeedTreeRT.cpp index d857cb20..7156dd6e 100644 --- a/src/eter_render/SpeedTreeRT.cpp +++ b/src/eter_render/SpeedTreeRT.cpp @@ -1,665 +1,88 @@ #include "src/eter_render/SpeedTreeRT.h" -#include -#include -#include -#include -#include -#include -#include +#include "src/eter_resource/ResourceManager.h" +#include namespace ava2 { -namespace { - -constexpr float kPI = 3.14159265358979323846f; -constexpr float kTAU = 2.0f * kPI; - -std::string ToLower(std::string s) { - std::transform(s.begin(), s.end(), s.begin(), [](unsigned char c) { - return static_cast(std::tolower(c)); - }); - return s; -} - -std::string BaseName(std::string p) { - for (char& c : p) if (c == '\\') c = '/'; - size_t s = p.find_last_of('/'); - return (s == std::string::npos) ? p : p.substr(s + 1); -} - -std::string StripQuotes(const std::string& s) { - size_t start = s.find_first_not_of(" \t\r\n\""); - if (start == std::string::npos) return ""; - size_t end = s.find_last_not_of(" \t\r\n\""); - return s.substr(start, end - start + 1); -} - -bool EndsWithCI(const std::string& s, const char* suf) { - size_t n = std::strlen(suf); - if (s.size() < n) return false; - for (size_t i = 0; i < n; ++i) { - if (std::tolower((unsigned char)s[s.size() - n + i]) != std::tolower((unsigned char)suf[i])) - return false; - } - return true; -} - -std::string AsDds(std::string s) { - if (s.empty()) return s; - size_t dot = s.find_last_of('.'); - if (dot != std::string::npos) s.resize(dot); - return s + ".dds"; -} - -bool IsConifer(const std::string& name) { - std::string s = ToLower(name); - return s.find("pine") != std::string::npos || s.find("cypress") != std::string::npos || - s.find("fir") != std::string::npos || s.find("spruce") != std::string::npos || - s.find("cedar") != std::string::npos || s.find("conifer") != std::string::npos || - s.find("tanne") != std::string::npos; -} - -bool IsGrassOrShrubSpecies(const std::string& name) { - std::string s = ToLower(name); - return s.find("grass") != std::string::npos || s.find("flower") != std::string::npos || - s.find("plant") != std::string::npos || s.find("bush") != std::string::npos || - s.find("shrub") != std::string::npos || s.find("tufis") != std::string::npos || - s.find("duester") != std::string::npos; -} - -std::string ResolvePath(const std::string& path) { - if (path.empty()) return ""; - std::string clean = path; - for (char& c : clean) if (c == '\\') c = '/'; - if (clean.size() > 2 && clean[1] == ':') { - clean = clean.substr(2); - while (!clean.empty() && clean[0] == '/') clean = clean.substr(1); - } - std::vector roots = { - "", - "build/dev/", - "../", - "ymir work/", - "build/dev/ymir work/", - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/", - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/property/", - "/Users/shen/Work/Code/Metin2/ava2-client/" - }; - for (const auto& r : roots) { - std::string cand = r + clean; - std::ifstream f(cand, std::ios::binary); - if (f.good()) return cand; - } - return clean; -} - -} // namespace - -bool SpeedTreeProperty::LoadFromFile(const std::string& filename, SpeedTreeProperty& out) { - std::string resolved = ResolvePath(filename); - std::ifstream file(resolved); - if (!file.is_open()) return false; - - std::string line; - bool has_yprt = false; - while (std::getline(file, line)) { - std::istringstream iss(line); - std::string token; - if (!(iss >> token)) continue; - - if (token == "YPRT") { - has_yprt = true; - if (file >> out.crc) { - // crc parsed - } - } else if (token == "propertyname") { - std::string rem; - std::getline(iss, rem); - out.property_name = StripQuotes(rem); - } else if (token == "propertytype") { - // expected "Tree" - } else if (token == "treefile") { - std::string rem; - std::getline(iss, rem); - out.tree_file = StripQuotes(rem); - } else if (token == "treesize") { - std::string rem; - std::getline(iss, rem); - try { out.tree_size = std::stof(StripQuotes(rem)); } catch (...) {} - } else if (token == "treevariance") { - std::string rem; - std::getline(iss, rem); - try { out.tree_variance = std::stof(StripQuotes(rem)); } catch (...) {} - } - } - return has_yprt && out.crc != 0; -} - -bool SpeedTreeSptInfo::SniffMemory(const uint8_t* p, size_t n, SpeedTreeSptInfo& out) { - out = SpeedTreeSptInfo{}; - if (!p || n < 20) return false; - - // Check magic - std::string bytes(reinterpret_cast(p), n); - size_t magic_pos = bytes.find("__IdvSpt_02_"); - if (magic_pos != std::string::npos) { - out.ok = true; - } - - auto i32_at = [&](size_t o) -> int32_t { - if (o + 4 > n) return 0; - int32_t val = 0; - std::memcpy(&val, p + o, 4); - return val; - }; - - // Parse tokens if structured - for (size_t o = 0; o + 12 <= n; ++o) { - int32_t token = i32_at(o); - if (token == 2000) { - // branch texture name - int32_t len = i32_at(o + 4); - if (len > 0 && len < 256 && o + 8 + len <= n) { - std::string s(reinterpret_cast(p + o + 8), len); - out.bark_texture = BaseName(s); - } - } else if (token == 2001) { - float sz = 0.0f; - std::memcpy(&sz, p + o + 4, 4); - if (sz > 1.0f && sz < 50000.0f) out.size = sz; - } else if (token == 2002) { - float var = 0.0f; - std::memcpy(&var, p + o + 4, 4); - out.variance = var; - } else if (token == 10000 && i32_at(o + 4) == 10002) { - // Texture coordinates section: 10002 leaf maps - size_t c = o + 4; - for (int32_t section : {10002, 10003, 10004}) { - if (c + 8 > n || i32_at(c) != section) break; - int32_t count = i32_at(c + 4); - c += 8; - if (count <= 0 || count > 64 || c + count * 32 > n) break; - auto& target = (section == 10002) ? out.leaf_uvs : (section == 10003 ? out.frond_uvs : out.billboard_uvs); - for (int32_t i = 0; i < count; ++i, c += 32) { - float f[8]; - std::memcpy(f, p + c, sizeof(f)); - target.push_back({f[2], 1.0f - f[1], f[0], 1.0f - f[5]}); - } - } - } - } - - // String scan fallback for bark & composite maps - std::string cur; - std::vector str_refs; - for (size_t i = 0; i < n; ++i) { - unsigned char c = p[i]; - if (c >= 0x20 && c < 0x7F) { - cur += static_cast(c); - } else { - if (cur.size() >= 4 && (EndsWithCI(cur, ".tga") || EndsWithCI(cur, ".dds"))) { - str_refs.push_back(BaseName(cur)); - } - cur.clear(); - } - } - - for (const auto& r : str_refs) { - std::string low = ToLower(r); - if (out.bark_texture.empty() && low.find("bark") != std::string::npos) { - out.bark_texture = AsDds(r); - } else if (out.leaf_texture.empty() && (low.find("leaf") != std::string::npos || low.find("leaves") != std::string::npos || low.find("grass") != std::string::npos)) { - out.leaf_texture = AsDds(r); - } - } - - // Check composite maps - auto find_token = [&](const char* needle) -> std::string { - size_t pos = bytes.find(needle); - if (pos == std::string::npos) return ""; - size_t end = pos + std::strlen(needle); - while (end < bytes.size() && (std::isalnum((unsigned char)bytes[end]) || bytes[end] == '_' || bytes[end] == '-')) { - ++end; - } - return bytes.substr(pos, end - pos); - }; - - std::string comp = find_token("CompositeMap"); - if (!comp.empty()) out.leaf_texture = AsDds(comp); - std::string shadow = find_token("CompositeShadowMap"); - if (!shadow.empty()) out.shadow_texture = AsDds(shadow); - - if (out.leaf_texture.empty() && !str_refs.empty()) { - out.leaf_texture = AsDds(str_refs.front()); - } - - return out.ok || !out.bark_texture.empty() || !out.leaf_texture.empty(); -} - -bool SpeedTreeSptInfo::SniffSpt(const std::string& filepath, SpeedTreeSptInfo& out) { - std::string resolved = ResolvePath(filepath); - std::ifstream file(resolved, std::ios::binary); - if (!file.is_open()) return false; - std::vector buffer((std::istreambuf_iterator(file)), std::istreambuf_iterator()); - return SniffMemory(buffer.data(), buffer.size(), out); -} - -SpeedTreeModel::SpeedTreeModel() {} - std::shared_ptr SpeedTreeModel::Create(const std::string& sptPath, float treeSize) { - auto model = std::make_shared(); - model->m_spt_path = sptPath; - model->m_name = BaseName(sptPath); - model->m_height = treeSize > 1.0f ? treeSize : 1000.0f; - model->m_radius = model->m_height * 0.35f; - model->m_is_grass_or_shrub = IsGrassOrShrubSpecies(model->m_name); - - SpeedTreeSptInfo info; - SpeedTreeSptInfo::SniffSpt(sptPath, info); - if (info.size > 1.0f && treeSize <= 0.0f) { - model->m_height = info.size; - model->m_radius = model->m_height * 0.35f; + std::string resolved = CResourceManager::NormalizePath(sptPath.c_str()); + for (const auto& candidate : CResourceManager::GetCandidatePaths(resolved)) { + if (std::filesystem::is_regular_file(candidate)) { resolved = candidate; break; } } - - model->BuildGeometry(info); + auto impl = speedtree::SpeedTreeModel::CreateFromSpt(resolved, treeSize); + if (!impl) return nullptr; + auto model = std::make_shared(std::move(impl)); + model->m_textureDirectory = std::filesystem::path(resolved).parent_path().string(); return model; } std::shared_ptr SpeedTreeModel::CreateProcedural(const std::string& name, float treeSize, const std::string& barkTex, const std::string& leafTex) { - auto model = std::make_shared(); - model->m_name = name; - model->m_height = treeSize > 1.0f ? treeSize : 1000.0f; - model->m_radius = model->m_height * 0.35f; - model->m_is_grass_or_shrub = IsGrassOrShrubSpecies(name); - - SpeedTreeSptInfo info; - info.ok = true; - info.bark_texture = barkTex; - info.leaf_texture = leafTex; - info.size = treeSize; - - model->BuildGeometry(info); - return model; -} - -static bool TextureFileExists(const std::string& p) { - if (p.empty()) return false; - std::string s = p; - for (char& c : s) if (c == '\\') c = '/'; - if (std::filesystem::exists(s)) return true; - if (std::filesystem::exists("build/dev/" + s)) return true; - std::string lower = s; - for (char& c : lower) c = static_cast(std::tolower(static_cast(c))); - if (std::filesystem::exists(lower)) return true; - if (std::filesystem::exists("build/dev/" + lower)) return true; - return false; -} - -static std::string ResolveExistingTexture(const std::string& candidate, - const std::string& dir, - const std::string& modelName, - bool isGrass, - bool isBark) { - std::string lowerName = modelName; - for (char& c : lowerName) c = static_cast(std::tolower(static_cast(c))); - - // Specific species exact mappings for Metin2 authentic assets - if (lowerName.find("scotchpine") != std::string::npos || lowerName.find("pine") != std::string::npos) { - if (isBark && TextureFileExists("ymir work/palnts_2/all/ot/treescotchpinebark.dds")) - return "ymir work/palnts_2/all/ot/treescotchpinebark.dds"; - if (!isBark && TextureFileExists("ymir work/palnts_2/all/ot/treescotchpineleaves.dds")) - return "ymir work/palnts_2/all/ot/treescotchpineleaves.dds"; - } - if (lowerName.find("willowoak") != std::string::npos || lowerName.find("oak") != std::string::npos) { - if (isBark && TextureFileExists("ymir work/palnts_2/all/ot/treewillowoakbarkmoss.dds")) - return "ymir work/palnts_2/all/ot/treewillowoakbarkmoss.dds"; - if (!isBark && TextureFileExists("ymir work/palnts_2/all/ot/treewillowoakleavessu.dds")) - return "ymir work/palnts_2/all/ot/treewillowoakleavessu.dds"; - } - if (lowerName.find("beech") != std::string::npos) { - if (isBark && TextureFileExists("ymir work/zone/b/tree/1/beechbark.dds")) - return "ymir work/zone/b/tree/1/beechbark.dds"; - if (!isBark && TextureFileExists("ymir work/zone/b/tree/1/compositemap.dds")) - return "ymir work/zone/b/tree/1/compositemap.dds"; - } - - if (!candidate.empty()) { - std::string p1 = candidate; - std::string p2 = dir + candidate; - if (TextureFileExists(p1)) return p1; - if (TextureFileExists(p2)) return p2; - } - - if (isGrass) { - if (!isBark) { - std::vector grass_cands = { - dir + "plant_grass.dds", - dir + "compositemapn2.dds", - dir + "plant_grass_bush1.dds", - "ymir work/plants/plant_grass.dds", - "ymir work/plants/compositemapn2.dds", - "ymir work/plants/plant_grass_bush1.dds", - "ymir work/palnts_2/all/os/shrubgenericelderberryleavessu.dds", - "ymir work/zone/b/tree/1/compositemap.dds" - }; - for (const auto& g : grass_cands) if (TextureFileExists(g)) return g; - } else { - std::vector bark_cands = { - dir + "aloeverabark.dds", - "ymir work/plants/aloeverabark.dds", - "ymir work/zone/b/tree/1/beechbark.dds" - }; - for (const auto& b : bark_cands) if (TextureFileExists(b)) return b; - } - } else { - if (isBark) { - std::vector bark_cands = { - dir + "beechbark.dds", - dir + "treewillowoakbarkmoss.dds", - dir + "treescotchpinebark.dds", - "ymir work/zone/b/tree/1/beechbark.dds", - "ymir work/palnts_2/all/ot/treewillowoakbarkmoss.dds", - "ymir work/palnts_2/all/ot/treescotchpinebark.dds", - "ymir work/zone/b/tree/c/englishoakbark.dds" - }; - for (const auto& b : bark_cands) if (TextureFileExists(b)) return b; - } else { - std::vector leaf_cands = { - dir + "compositemap.dds", - dir + "treewillowoakleavessu.dds", - dir + "treescotchpineleaves.dds", - "ymir work/zone/b/tree/1/compositemap.dds", - "ymir work/zone/b/tree/c/compositemap.dds", - "ymir work/palnts_2/all/ot/treewillowoakleavessu.dds", - "ymir work/palnts_2/all/ot/treescotchpineleaves.dds" - }; - for (const auto& l : leaf_cands) if (TextureFileExists(l)) return l; - } - } - return isBark ? "ymir work/zone/b/tree/1/beechbark.dds" : "ymir work/zone/b/tree/1/compositemap.dds"; -} - -void SpeedTreeModel::BuildGeometry(const SpeedTreeSptInfo& info) { - // Resolve textures with directory prefixes if known - std::string dir = ""; - size_t last_slash = m_spt_path.find_last_of("/\\"); - if (last_slash != std::string::npos) { - dir = m_spt_path.substr(0, last_slash + 1); - } - - m_bark_texture = ResolveExistingTexture(info.bark_texture, dir, m_name, m_is_grass_or_shrub, true); - m_leaf_texture = ResolveExistingTexture(info.leaf_texture, dir, m_name, m_is_grass_or_shrub, false); - - if (m_is_grass_or_shrub) { - BuildGrassShrubGeometry(m_height, info); - } else { - BuildTreeGeometry(m_height, info); - } -} - -void SpeedTreeModel::BuildGrassShrubGeometry(float H, const SpeedTreeSptInfo& info) { - // 3 intersecting vertical quads (Star pattern at 0, 60, 120 degrees) - m_leaf_template.positions.clear(); - m_leaf_template.normals.clear(); - m_leaf_template.uv0.clear(); - m_leaf_template.diffuse.clear(); - m_leaf_template.indices.clear(); - - m_leaf_template.texture0 = m_leaf_texture; - m_leaf_template.alpha_test = true; - m_leaf_template.alpha_ref = 70; - m_leaf_template.cull_mode = 1; // Double-sided - m_leaf_template.lighting = true; - m_leaf_template.z_enable = true; - m_leaf_template.z_write = true; - - float W = H * 0.85f; - float hW = W * 0.5f; - - float angles[] = {0.0f, kPI / 3.0f, 2.0f * kPI / 3.0f}; - for (int p = 0; p < 3; ++p) { - float a = angles[p]; - float dx = std::cos(a) * hW; - float dz = std::sin(a) * hW; - float nx = -std::sin(a); - float nz = std::cos(a); - - uint32_t base_idx = static_cast(m_leaf_template.positions.size() / 3); - - // 4 corners of vertical plane - // Bottom-left, Bottom-right, Top-right, Top-left - float corners[4][3] = { - {-dx, 0.0f, -dz}, - { dx, 0.0f, dz}, - { dx, H, dz}, - {-dx, H, -dz} - }; - - for (int c = 0; c < 4; ++c) { - m_leaf_template.positions.push_back(corners[c][0]); - m_leaf_template.positions.push_back(corners[c][1]); - m_leaf_template.positions.push_back(corners[c][2]); - - m_leaf_template.normals.push_back(nx); - m_leaf_template.normals.push_back(0.3f); - m_leaf_template.normals.push_back(nz); - - m_leaf_template.diffuse.push_back(0xFFFFFFFF); - } - - m_leaf_template.uv0.push_back(0.0f); m_leaf_template.uv0.push_back(1.0f); - m_leaf_template.uv0.push_back(1.0f); m_leaf_template.uv0.push_back(1.0f); - m_leaf_template.uv0.push_back(1.0f); m_leaf_template.uv0.push_back(0.0f); - m_leaf_template.uv0.push_back(0.0f); m_leaf_template.uv0.push_back(0.0f); - - m_leaf_template.indices.push_back(base_idx + 0); - m_leaf_template.indices.push_back(base_idx + 1); - m_leaf_template.indices.push_back(base_idx + 2); - m_leaf_template.indices.push_back(base_idx + 0); - m_leaf_template.indices.push_back(base_idx + 2); - m_leaf_template.indices.push_back(base_idx + 3); - } -} - -void SpeedTreeModel::BuildTreeGeometry(float H, const SpeedTreeSptInfo& info) { - bool conifer = IsConifer(m_name); - - // 1. Build Trunk Cylindrical Tube - m_trunk_template.positions.clear(); - m_trunk_template.normals.clear(); - m_trunk_template.uv0.clear(); - m_trunk_template.diffuse.clear(); - m_trunk_template.indices.clear(); - - m_trunk_template.texture0 = m_bark_texture; - m_trunk_template.alpha_test = false; - m_trunk_template.cull_mode = 2; // Backface cull - m_trunk_template.lighting = true; - m_trunk_template.z_enable = true; - m_trunk_template.z_write = true; - - constexpr int SEGS = 8; - constexpr int LEVELS = 4; - float trunk_top = H * (conifer ? 0.90f : 0.72f); - float r_base = H * 0.038f; - float r_top = H * 0.012f; - - for (int l = 0; l <= LEVELS; ++l) { - float f = static_cast(l) / LEVELS; - float y = f * trunk_top; - float r = r_base * (1.0f - f) + r_top * f; - float v = f * 3.0f; // Tile bark vertically - - for (int s = 0; s <= SEGS; ++s) { - float a = static_cast(s) / SEGS * kTAU; - float cos_a = std::cos(a); - float sin_a = std::sin(a); - - m_trunk_template.positions.push_back(cos_a * r); - m_trunk_template.positions.push_back(y); - m_trunk_template.positions.push_back(sin_a * r); - - m_trunk_template.normals.push_back(cos_a); - m_trunk_template.normals.push_back(0.0f); - m_trunk_template.normals.push_back(sin_a); - - m_trunk_template.uv0.push_back(static_cast(s) / SEGS); - m_trunk_template.uv0.push_back(v); - - m_trunk_template.diffuse.push_back(0xFFFFFFFF); - } - } - - int stride = SEGS + 1; - for (int l = 0; l < LEVELS; ++l) { - for (int s = 0; s < SEGS; ++s) { - uint32_t i0 = l * stride + s; - uint32_t i1 = l * stride + (s + 1); - uint32_t i2 = (l + 1) * stride + s; - uint32_t i3 = (l + 1) * stride + (s + 1); - - m_trunk_template.indices.push_back(i0); - m_trunk_template.indices.push_back(i2); - m_trunk_template.indices.push_back(i1); - - m_trunk_template.indices.push_back(i1); - m_trunk_template.indices.push_back(i2); - m_trunk_template.indices.push_back(i3); - } - } - - // 2. Build Foliage Canopy Clusters (Multiple Cross Quads) - m_leaf_template.positions.clear(); - m_leaf_template.normals.clear(); - m_leaf_template.uv0.clear(); - m_leaf_template.diffuse.clear(); - m_leaf_template.indices.clear(); - - m_leaf_template.texture0 = m_leaf_texture; - m_leaf_template.alpha_test = true; - m_leaf_template.alpha_ref = 84; - m_leaf_template.cull_mode = 1; // Double sided - m_leaf_template.lighting = true; - m_leaf_template.z_enable = true; - m_leaf_template.z_write = true; - - UVRect default_uv{0.0f, 0.0f, 1.0f, 1.0f}; - const auto& uv_pool = info.leaf_uvs.empty() ? (info.frond_uvs.empty() ? std::vector{default_uv} : info.frond_uvs) : info.leaf_uvs; - - int cluster_count = conifer ? 14 : 12; - for (int k = 0; k < cluster_count; ++k) { - float f = static_cast(k) / cluster_count; - float y = H * (conifer ? (0.28f + f * 0.65f) : (0.42f + f * 0.48f)); - float spread = H * (conifer ? (0.24f * (1.0f - f * 0.70f)) : (0.28f * std::sin(f * kPI))); - float angle = f * kTAU * 1.618f; - - float cx = (k == cluster_count - 1) ? 0.0f : (std::cos(angle) * spread); - float cz = (k == cluster_count - 1) ? 0.0f : (std::sin(angle) * spread); - - float quad_w = H * (conifer ? 0.28f : 0.38f); - float quad_h = H * (conifer ? 0.24f : 0.32f); - float hw = quad_w * 0.5f; - float hh = quad_h * 0.5f; - - UVRect uv = uv_pool[k % uv_pool.size()]; - - // 2 perpendicular planes per cluster (0 and 90 deg) - for (int p = 0; p < 2; ++p) { - float pa = angle + p * (kPI * 0.5f); - float dx = std::cos(pa) * hw; - float dz = std::sin(pa) * hw; - - uint32_t bidx = static_cast(m_leaf_template.positions.size() / 3); - - float pts[4][3] = { - {cx - dx, y - hh, cz - dz}, - {cx + dx, y - hh, cz + dz}, - {cx + dx, y + hh, cz + dz}, - {cx - dx, y + hh, cz - dz} - }; - - for (int i = 0; i < 4; ++i) { - m_leaf_template.positions.push_back(pts[i][0]); - m_leaf_template.positions.push_back(pts[i][1]); - m_leaf_template.positions.push_back(pts[i][2]); - - m_leaf_template.normals.push_back(std::cos(pa + kPI * 0.5f)); - m_leaf_template.normals.push_back(0.4f); - m_leaf_template.normals.push_back(std::sin(pa + kPI * 0.5f)); - - m_leaf_template.diffuse.push_back(0xFFFFFFFF); - } - - m_leaf_template.uv0.push_back(uv.u0); m_leaf_template.uv0.push_back(uv.v1); - m_leaf_template.uv0.push_back(uv.u1); m_leaf_template.uv0.push_back(uv.v1); - m_leaf_template.uv0.push_back(uv.u1); m_leaf_template.uv0.push_back(uv.v0); - m_leaf_template.uv0.push_back(uv.u0); m_leaf_template.uv0.push_back(uv.v0); - - m_leaf_template.indices.push_back(bidx + 0); - m_leaf_template.indices.push_back(bidx + 1); - m_leaf_template.indices.push_back(bidx + 2); - m_leaf_template.indices.push_back(bidx + 0); - m_leaf_template.indices.push_back(bidx + 2); - m_leaf_template.indices.push_back(bidx + 3); - } - } + auto impl = speedtree::SpeedTreeModel::CreateProcedural(name, treeSize, barkTex, leafTex); + if (!impl) return nullptr; + return std::make_shared(std::move(impl)); } std::vector SpeedTreeModel::BuildDrawCommands(float worldX, float worldY, float worldZ, float yawDeg, float scale, float windTime, float windStrength) const { std::vector results; - float rad = yawDeg * (kPI / 180.0f); - float cos_y = std::cos(rad); - float sin_y = std::sin(rad); + if (!m_impl) return results; - auto transform_mesh = [&](const Render3DDraw& tmpl, bool is_canopy) -> Render3DDraw { - Render3DDraw out = tmpl; - size_t nverts = tmpl.positions.size() / 3; - out.positions.resize(tmpl.positions.size()); - out.normals.resize(tmpl.normals.size()); + speedtree::WindParameters wind; + wind.time = windTime; + wind.strength = windStrength * 0.05f; - float inv_H = 1.0f / (m_height * scale); + auto build_draw = [&](const speedtree::SpeedTreeMesh& mesh, bool is_canopy) { + if (mesh.vertices.empty() || mesh.indices.empty()) return; - for (size_t i = 0; i < nverts; ++i) { - float lx = tmpl.positions[i * 3 + 0] * scale; - float ly = tmpl.positions[i * 3 + 1] * scale; - float lz = tmpl.positions[i * 3 + 2] * scale; - - // Rotate around Y - float rx = lx * cos_y + lz * sin_y; - float ry = ly; - float rz = -lx * sin_y + lz * cos_y; - - // Wind Sway displacement proportional to height squared - float h_factor = std::clamp(ry * inv_H, 0.0f, 1.2f); - float flex = is_canopy ? (h_factor * h_factor) : (h_factor * h_factor * 0.4f); - - float sway_x = std::sin(windTime * 2.2f + worldX * 0.008f + worldZ * 0.008f) * windStrength * flex; - float sway_z = std::cos(windTime * 1.8f + worldX * 0.012f) * windStrength * flex * 0.6f; - - out.positions[i * 3 + 0] = worldX + rx + sway_x; - out.positions[i * 3 + 1] = worldY + ry; - out.positions[i * 3 + 2] = worldZ + rz + sway_z; - - // Rotate normal - float nx = tmpl.normals[i * 3 + 0]; - float ny = tmpl.normals[i * 3 + 1]; - float nz = tmpl.normals[i * 3 + 2]; - out.normals[i * 3 + 0] = nx * cos_y + nz * sin_y; - out.normals[i * 3 + 1] = ny; - out.normals[i * 3 + 2] = -nx * sin_y + nz * cos_y; + Render3DDraw draw; + draw.texture0 = mesh.texture; + if (!m_textureDirectory.empty() && !mesh.texture.empty()) { + // SPT materials often contain only a filename, relative to the tree file. + auto name = CResourceManager::NormalizePath(mesh.texture.c_str()); + auto candidate = std::filesystem::path(m_textureDirectory) / std::filesystem::path(name).filename(); + if (std::filesystem::is_regular_file(candidate)) draw.texture0 = candidate.string(); } - return out; + draw.indices = mesh.indices; + + m_impl->EvaluateCpuTransformedVertices(mesh, draw.positions, draw.normals, + worldX, worldY, worldZ, + yawDeg, scale, wind); + + size_t nverts = mesh.vertices.size(); + draw.uv0.resize(nverts * 2); + draw.diffuse.resize(nverts); + for (size_t i = 0; i < nverts; ++i) { + draw.uv0[i * 2 + 0] = mesh.vertices[i].uv[0]; + draw.uv0[i * 2 + 1] = mesh.vertices[i].uv[1]; + draw.diffuse[i] = mesh.vertices[i].diffuse; + } + + if (is_canopy) { + draw.alpha_test = true; + draw.alpha_ref = 84; + draw.cull_mode = 1; // Double sided + draw.lighting = true; + } else { + draw.alpha_test = false; + draw.alpha_ref = 0; + draw.cull_mode = 2; // CW + draw.lighting = true; + } + + results.push_back(std::move(draw)); }; - if (!m_trunk_template.positions.empty()) { - results.push_back(transform_mesh(m_trunk_template, false)); + const auto& trunk = m_impl->GetTrunkMesh(); + if (!trunk.vertices.empty()) { + build_draw(trunk, false); } - if (!m_leaf_template.positions.empty()) { - results.push_back(transform_mesh(m_leaf_template, true)); + + const auto& leaf = m_impl->GetLeafMesh(); + if (!leaf.vertices.empty()) { + build_draw(leaf, true); } return results; diff --git a/src/eter_render/SpeedTreeRT.h b/src/eter_render/SpeedTreeRT.h index 06beb7af..79a7f57a 100644 --- a/src/eter_render/SpeedTreeRT.h +++ b/src/eter_render/SpeedTreeRT.h @@ -1,6 +1,7 @@ #pragma once #include "src/eter_render/Gr2ModelRenderer.h" +#include #include #include #include @@ -8,38 +9,15 @@ namespace ava2 { -struct UVRect { - float u0 = 0.0f, v0 = 0.0f, u1 = 1.0f, v1 = 1.0f; -}; - -struct SpeedTreeProperty { - uint32_t crc = 0; - std::string property_name; - std::string tree_file; - float tree_size = 1000.0f; - float tree_variance = 0.0f; - - static bool LoadFromFile(const std::string& filename, SpeedTreeProperty& out); -}; - -struct SpeedTreeSptInfo { - bool ok = false; - float size = 1000.0f; - float variance = 0.0f; - std::string bark_texture; - std::string leaf_texture; - std::string shadow_texture; - std::vector leaf_uvs; - std::vector frond_uvs; - std::vector billboard_uvs; - - static bool SniffSpt(const std::string& filepath, SpeedTreeSptInfo& out); - static bool SniffMemory(const uint8_t* data, size_t size, SpeedTreeSptInfo& out); -}; +using UVRect = speedtree::UVRect; +using SpeedTreeProperty = speedtree::SpeedTreeProperty; +using SpeedTreeSptInfo = speedtree::SpeedTreeSptInfo; class SpeedTreeModel { public: - SpeedTreeModel(); + SpeedTreeModel() = default; + explicit SpeedTreeModel(std::shared_ptr impl) + : m_impl(std::move(impl)) {} ~SpeedTreeModel() = default; static std::shared_ptr Create(const std::string& sptPath, float treeSize = 1000.0f); @@ -51,30 +29,19 @@ public: float yawDeg, float scale, float windTime, float windStrength = 15.0f) const; - float GetHeight() const { return m_height; } - float GetRadius() const { return m_radius; } - bool IsGrassOrShrub() const { return m_is_grass_or_shrub; } - const std::string& GetName() const { return m_name; } - const std::string& GetBarkTexture() const { return m_bark_texture; } - const std::string& GetLeafTexture() const { return m_leaf_texture; } + float GetHeight() const { return m_impl ? m_impl->GetHeight() : 1000.0f; } + float GetRadius() const { return m_impl ? m_impl->GetRadius() : 350.0f; } + bool IsGrassOrShrub() const { return m_impl ? m_impl->IsGrassOrShrub() : false; } + const std::string& GetName() const { static const std::string empty; return m_impl ? m_impl->GetName() : empty; } + const std::string& GetBarkTexture() const { static const std::string empty; return m_impl ? m_impl->GetBarkTexture() : empty; } + const std::string& GetLeafTexture() const { static const std::string empty; return m_impl ? m_impl->GetLeafTexture() : empty; } + const speedtree::SpeedTreeSptInfo& GetSptInfo() const { static const speedtree::SpeedTreeSptInfo empty; return m_impl ? m_impl->GetSptInfo() : empty; } + + std::shared_ptr GetImpl() const { return m_impl; } private: - void BuildGeometry(const SpeedTreeSptInfo& info); - void BuildTreeGeometry(float H, const SpeedTreeSptInfo& info); - void BuildGrassShrubGeometry(float H, const SpeedTreeSptInfo& info); - - std::string m_name; - std::string m_spt_path; - float m_height = 1000.0f; - float m_radius = 350.0f; - bool m_is_grass_or_shrub = false; - - std::string m_bark_texture; - std::string m_leaf_texture; - - // Base mesh templates in model local space (Z-forward / Y-up) - Render3DDraw m_trunk_template; - Render3DDraw m_leaf_template; + std::shared_ptr m_impl; + std::string m_textureDirectory; }; } // namespace ava2 diff --git a/src/eter_render/TerrainHeightmap.cpp b/src/eter_render/TerrainHeightmap.cpp index 0ac2b96e..7f5cac94 100644 --- a/src/eter_render/TerrainHeightmap.cpp +++ b/src/eter_render/TerrainHeightmap.cpp @@ -4,6 +4,7 @@ #include #include #include +#include namespace ava2 { @@ -101,6 +102,7 @@ bool TerrainHeightmap::LoadRaw(const std::string& raw_path, float height_scale, } bool TerrainHeightmap::LoadFromBuffer(const uint16_t* raw_data, size_t count, float height_scale, float cell_scale) { + m_patchDrawCache.clear(); if (!raw_data || count < static_cast(RAW_XSIZE * RAW_YSIZE)) { return false; } @@ -153,6 +155,7 @@ bool TerrainHeightmap::LoadTileRaw(const std::string& tile_path) { } bool TerrainHeightmap::LoadTileFromBuffer(const uint8_t* tile_data, size_t count) { + m_patchDrawCache.clear(); if (!tile_data || count < static_cast(TILEMAP_RAW_XSIZE * TILEMAP_RAW_YSIZE)) { return false; } @@ -228,6 +231,7 @@ bool TerrainHeightmap::LoadTextureSet(const std::string& textureset_path) { } bool TerrainHeightmap::LoadTextureSetFromString(const std::string& content) { + m_patchDrawCache.clear(); std::istringstream file(content); std::string line; int current_id = 0; @@ -272,6 +276,7 @@ bool TerrainHeightmap::LoadTextureSetFromString(const std::string& content) { } void TerrainHeightmap::GenerateProcedural(int width, int height, float cell_scale, float hill_amplitude) { + m_patchDrawCache.clear(); m_width = std::max(width, 16); m_height = std::max(height, 16); m_cell_scale = cell_scale; @@ -313,6 +318,7 @@ void TerrainHeightmap::UpdateBounds() { } void TerrainHeightmap::SetWorldOrigin(float min_x, float min_z) { + m_patchDrawCache.clear(); m_has_origin = true; m_origin_x = min_x; m_origin_z = min_z; @@ -418,8 +424,9 @@ uint8_t TerrainHeightmap::GetTileAtGrid(int x, int y) const { uint8_t TerrainHeightmap::GetTileAtWorld(float world_x, float world_z) const { if (m_tiles.empty() || m_tile_width <= 0 || m_tile_height <= 0) return 0; - float grid_x = (world_x - m_world_min_x) / (static_cast(m_width - 1) * m_cell_scale) * static_cast(m_tile_width - 1); - float grid_z = (world_z - m_world_min_z) / (static_cast(m_height - 1) * m_cell_scale) * static_cast(m_tile_height - 1); + // AVA2 height.raw has a one-height-sample border; tile.raw has a one-tile border. + float grid_x = (world_x - m_world_min_x) / (m_cell_scale * 0.5f) - 1.0f; + float grid_z = (world_z - m_world_min_z) / (m_cell_scale * 0.5f) - 1.0f; int tx = std::clamp(static_cast(std::round(grid_x)), 0, m_tile_width - 1); int tz = std::clamp(static_cast(std::round(grid_z)), 0, m_tile_height - 1); return m_tiles[tz * m_tile_width + tx]; @@ -620,10 +627,14 @@ std::vector TerrainHeightmap::BuildCulledDraws(const float view[16 float dist = std::sqrt(dx * dx + dz * dz); int step = (dist > 2200.0f) ? 2 : 1; - auto d = BuildPatchDraw(patch.patch_x, patch.patch_y, step); - if (!d.positions.empty()) { - draws.push_back(std::move(d)); + const auto key = std::tuple{patch.patch_x, patch.patch_y, step}; + auto it = m_patchDrawCache.find(key); + if (it == m_patchDrawCache.end()) { + auto patchDraws = BuildPatchDraws(patch.patch_x, patch.patch_y, step); + for (auto& draw : patchDraws) draw = Render3DDraw::ShareGeometry(std::move(draw)); + it = m_patchDrawCache.emplace(key, std::move(patchDraws)).first; } + draws.insert(draws.end(), it->second.begin(), it->second.end()); } return draws; @@ -639,6 +650,7 @@ Render3DDraw TerrainHeightmap::BuildPatchDraw(int patch_x, int patch_y, int step dom_tile = m_patches[p_idx].dominant_tile; } draw.texture0 = GetTexturePathForTile(dom_tile); + draw.terrain = true; draw.cull_mode = 1; // D3DCULL_NONE: double-sided for terrain meshes step = std::max(1, step); @@ -708,6 +720,44 @@ Render3DDraw TerrainHeightmap::BuildPatchDraw(int patch_x, int patch_y, int step return draw; } +std::vector TerrainHeightmap::BuildPatchDraws(int patch_x, int patch_y, int step) const { + auto base = BuildPatchDraw(patch_x, patch_y, step); + if (m_tiles.empty()) return {std::move(base)}; + const size_t count = base.positions.size() / 3; + std::map> weights; + for (size_t v = 0; v < count; ++v) { + const int tx = int(std::round((base.positions[v * 3] - m_world_min_x) / (m_cell_scale * 0.5f))) - 1; + const int ty = int(std::round((base.positions[v * 3 + 2] - m_world_min_z) / (m_cell_scale * 0.5f))) - 1; + // Smooth the native tile mask around each height vertex, as terrain splat layers do. + for (int dy = -1; dy <= 1; ++dy) for (int dx = -1; dx <= 1; ++dx) { + const auto tile = m_tiles[std::clamp(ty + dy, 0, m_tile_height - 1) * m_tile_width + std::clamp(tx + dx, 0, m_tile_width - 1)]; + auto& layer = weights[tile]; + if (layer.empty()) layer.resize(count); + layer[v] += 1.0f / 9.0f; + } + } + std::vector draws{base}; + std::vector accumulated(count); + for (const auto& [tile, layer] : weights) { + auto draw = base; + draw.texture0 = GetTexturePathForTile(tile); + draw.alpha_blend = true; + draw.z_write = false; + draw.indices.clear(); + for (size_t v = 0; v < count; ++v) { + accumulated[v] += layer[v]; + const float alpha = accumulated[v] > 0 ? layer[v] / accumulated[v] : 0; + draw.diffuse[v] = (uint32_t(std::round(alpha * 255)) << 24) | 0xffffff; + } + for (size_t t = 0; t + 2 < base.indices.size(); t += 3) { + if (layer[base.indices[t]] + layer[base.indices[t + 1]] + layer[base.indices[t + 2]] > 0) + draw.indices.insert(draw.indices.end(), base.indices.begin() + t, base.indices.begin() + t + 3); + } + if (!draw.indices.empty()) draws.push_back(std::move(draw)); + } + return draws; +} + Render3DDraw TerrainHeightmap::BuildDrawCommand(const float world[16], int step) const { Render3DDraw draw; if (m_heights.empty() || m_width < 2 || m_height < 2) return draw; diff --git a/src/eter_render/TerrainHeightmap.h b/src/eter_render/TerrainHeightmap.h index 96ea240c..7ecf3c1e 100644 --- a/src/eter_render/TerrainHeightmap.h +++ b/src/eter_render/TerrainHeightmap.h @@ -6,6 +6,8 @@ #include #include #include +#include +#include namespace ava2 { @@ -123,6 +125,7 @@ public: // Build patch draw command for a single patch Render3DDraw BuildPatchDraw(int patch_x, int patch_y, int step = 1) const; + std::vector BuildPatchDraws(int patch_x, int patch_y, int step = 1) const; // QuadTree & Patch hierarchy size_t GetPatchCount() const { return m_patches.size(); } @@ -181,6 +184,7 @@ private: std::unordered_map m_textureSet; // tile_id -> texture dds path + mutable std::map, std::vector> m_patchDrawCache; std::vector m_patches; // 8x8 = 64 patches std::unique_ptr m_quadtreeRoot; }; diff --git a/src/eter_render/TextTailManager.cpp b/src/eter_render/TextTailManager.cpp index df8e1a68..c9c27bad 100644 --- a/src/eter_render/TextTailManager.cpp +++ b/src/eter_render/TextTailManager.cpp @@ -455,9 +455,9 @@ void TextTailManager::ArrangeTextTail() { for (auto& tail : m_characterList) { if (!tail) continue; - float nameWidth = static_cast(tail->name.size()) * 8.0f; - float titleWidth = tail->title.empty() ? 0.0f : (static_cast(tail->title.size()) * 8.0f); - float levelWidth = tail->level.empty() ? 0.0f : (static_cast(tail->level.size()) * 8.0f); + float nameWidth = TextWidth(tail->name); + float titleWidth = tail->title.empty() ? 0.0f : (TextWidth(tail->title)); + float levelWidth = tail->level.empty() ? 0.0f : (TextWidth(tail->level)); float totalW = nameWidth; if (!tail->title.empty()) totalW += titleWidth + 6.0f; @@ -493,6 +493,7 @@ void TextTailManager::RenderTextTailBox(SDL_Renderer* renderer, const TextTailIt void TextTailManager::RenderText(SDL_Renderer* renderer, float x, float y, const std::string& text, uint32_t color, float scale, bool shadow) { if (text.empty()) return; + if (m_textPainter) { m_textPainter(x,y,text,color,scale,shadow); return; } uint8_t a = (color >> 24) & 0xFF; if (a == 0) a = 0xFF; @@ -520,7 +521,7 @@ void TextTailManager::RenderText(SDL_Renderer* renderer, float x, float y, const void TextTailManager::RenderChatBubble(SDL_Renderer* renderer, const TextTailItem& tail) { if (!tail.hasChat || tail.chatText.empty()) return; - float textW = static_cast(tail.chatText.size()) * 8.0f; + float textW = TextWidth(tail.chatText); float bubbleW = textW + 16.0f; float bubbleH = 22.0f; float bx = tail.x - bubbleW * 0.5f; @@ -562,7 +563,7 @@ void TextTailManager::Render(SDL_Renderer* renderer, const Gr2SceneRenderer* sce RenderTextTailBox(renderer, *tail); - float textW = static_cast(tail->name.size()) * 8.0f; + float textW = TextWidth(tail->name); float tx = tail->x - textW * 0.5f; float ty = tail->y - 10.0f; @@ -580,7 +581,7 @@ void TextTailManager::Render(SDL_Renderer* renderer, const Gr2SceneRenderer* sce std::snprintf(buf, sizeof(buf), "(%dm %ds) ", m, s); ownerTag = std::string(buf) + ownerTag; } - float owW = static_cast(ownerTag.size()) * 8.0f * 0.9f; + float owW = TextWidth(ownerTag, 0.9f); uint32_t owColor = tail->isMineItem ? 0xFFFFD700 : 0xFFFF6060; RenderText(renderer, tail->x - owW * 0.5f, ty - 14.0f, ownerTag, owColor, 0.9f, true); } @@ -590,27 +591,31 @@ void TextTailManager::Render(SDL_Renderer* renderer, const Gr2SceneRenderer* sce for (const auto& tail : m_characterList) { if (!tail) continue; - float nameW = static_cast(tail->name.size()) * 8.0f; - float titleW = tail->title.empty() ? 0.0f : (static_cast(tail->title.size()) * 8.0f); - float levelW = tail->level.empty() ? 0.0f : (static_cast(tail->level.size()) * 8.0f); + float nameW = TextWidth(tail->name); + float titleW = tail->title.empty() ? 0.0f : (TextWidth(tail->title)); + float levelW = tail->level.empty() ? 0.0f : (TextWidth(tail->level)); float totalW = nameW; if (!tail->title.empty()) totalW += titleW + 6.0f; if (!tail->level.empty()) totalW += levelW + 6.0f; - float curX = tail->x - totalW * 0.5f; - float curY = tail->y - 10.0f; + // Original AVA2 keeps the name centered on the actor; level and title + // extend to its left rather than moving the whole nameplate to the right. + float curX = tail->x + 4.0f - nameW * 0.5f; + if (!tail->title.empty()) curX -= titleW + 4.0f; + if (!tail->level.empty()) curX -= levelW + 4.0f; + float curY = tail->y - 14.0f; // Level tag e.g. "[Lv. 99]" in lime green if (!tail->level.empty()) { RenderText(renderer, curX, curY, tail->level, tail->levelColor, 1.0f, true); - curX += levelW + 6.0f; + curX += levelW + 4.0f; } // Title e.g. "Noble" in gold if (!tail->title.empty()) { RenderText(renderer, curX, curY, tail->title, tail->titleColor, 1.0f, true); - curX += titleW + 6.0f; + curX += titleW + 4.0f; } // Character Name in tail->color (white / red / yellow / etc.) @@ -619,7 +624,7 @@ void TextTailManager::Render(SDL_Renderer* renderer, const Gr2SceneRenderer* sce // Guild Name e.g. "[GuildName]" in light cyan above character name, with Guild Mark if (!tail->guildName.empty()) { std::string gStr = "[" + tail->guildName + "]"; - float gW = static_cast(gStr.size()) * 8.0f * 0.9f; + float gW = TextWidth(gStr, 0.9f); float totalW = gW; bool hasMark = false; float u0 = 0.0f, v0 = 0.0f, u1 = 0.0f, v1 = 0.0f; diff --git a/src/eter_render/TextTailManager.h b/src/eter_render/TextTailManager.h index 69084b82..ce095cb4 100644 --- a/src/eter_render/TextTailManager.h +++ b/src/eter_render/TextTailManager.h @@ -7,6 +7,7 @@ #include #include #include +#include namespace ava2 { @@ -121,6 +122,9 @@ public: // Rendering void Render(SDL_Renderer* renderer, const Gr2SceneRenderer* sceneRenderer = nullptr); + using TextPainter = std::function; + using TextMeasure = std::function; + void SetTextPainter(TextPainter painter, TextMeasure measure) { m_textPainter = std::move(painter); m_textMeasure = std::move(measure); } // Queries & Getters size_t GetCharacterCount() const { return m_characterMap.size(); } @@ -134,11 +138,19 @@ public: const std::shared_ptr GetItemTail(uint32_t vid) const; // Active renderer reference for Python bindings - void SetCurrentSceneRenderer(const Gr2SceneRenderer* renderer) { m_currentSceneRenderer = renderer; } + void SetCurrentSceneRenderer(Gr2SceneRenderer* renderer) { m_currentSceneRenderer = renderer; } + Gr2SceneRenderer* GetCurrentSceneRenderer() { return m_currentSceneRenderer; } const Gr2SceneRenderer* GetCurrentSceneRenderer() const { return m_currentSceneRenderer; } void SetCurrentRenderer(SDL_Renderer* renderer) { m_currentRenderer = renderer; } + SDL_Renderer* GetCurrentRenderer() { return m_currentRenderer; } + const SDL_Renderer* GetCurrentRenderer() const { return m_currentRenderer; } private: + TextPainter m_textPainter; + TextMeasure m_textMeasure; + float TextWidth(const std::string& text, float scale = 1.0f) const { + return m_textMeasure ? m_textMeasure(text, scale) : float(text.size()) * 8.0f * scale; + } bool isIn(const TextTailItem& src, const TextTailItem& tgt) const; void RenderTextTailBox(SDL_Renderer* renderer, const TextTailItem& tail); void RenderText(SDL_Renderer* renderer, float x, float y, const std::string& text, uint32_t color, float scale = 1.0f, bool shadow = true); @@ -152,7 +164,7 @@ private: bool m_pkTitleEnable = true; uint32_t m_selectedItemVID = 0; - const Gr2SceneRenderer* m_currentSceneRenderer = nullptr; + Gr2SceneRenderer* m_currentSceneRenderer = nullptr; SDL_Renderer* m_currentRenderer = nullptr; }; diff --git a/src/eter_render/shaders/SceneSpirv.h b/src/eter_render/shaders/SceneSpirv.h new file mode 100644 index 00000000..996914fb --- /dev/null +++ b/src/eter_render/shaders/SceneSpirv.h @@ -0,0 +1,673 @@ +// Generated by tools/compile_scene_shaders.py; do not edit. +#pragma once +alignas(4) inline constexpr unsigned char scene_vert_spv[] = { +3,2,35,7,0,0,1,0,11,0,13,0,15,2,0,0,0,0,0,0,17,0,2,0, +1,0,0,0,11,0,6,0,1,0,0,0,71,76,83,76,46,115,116,100,46,52,53,48, +0,0,0,0,14,0,3,0,0,0,0,0,1,0,0,0,15,0,15,0,0,0,0,0, +4,0,0,0,109,97,105,110,0,0,0,0,74,0,0,0,200,0,0,0,205,0,0,0, +229,0,0,0,239,0,0,0,89,1,0,0,3,2,0,0,7,2,0,0,11,2,0,0, +13,2,0,0,3,0,3,0,2,0,0,0,194,1,0,0,4,0,10,0,71,76,95,71, +79,79,71,76,69,95,99,112,112,95,115,116,121,108,101,95,108,105,110,101,95,100,105,114, +101,99,116,105,118,101,0,0,4,0,8,0,71,76,95,71,79,79,71,76,69,95,105,110, +99,108,117,100,101,95,100,105,114,101,99,116,105,118,101,0,5,0,4,0,4,0,0,0, +109,97,105,110,0,0,0,0,5,0,11,0,15,0,0,0,116,114,97,110,115,102,111,114, +109,82,111,119,115,40,118,102,52,59,118,102,52,59,118,102,52,59,118,102,52,59,118,102, +52,59,0,0,5,0,3,0,10,0,0,0,112,0,0,0,5,0,3,0,11,0,0,0, +97,0,0,0,5,0,3,0,12,0,0,0,98,0,0,0,5,0,3,0,13,0,0,0, +99,0,0,0,5,0,3,0,14,0,0,0,100,0,0,0,5,0,5,0,46,0,0,0, +84,114,97,110,115,102,111,114,109,0,0,0,6,0,5,0,46,0,0,0,0,0,0,0, +119,111,114,108,100,0,0,0,6,0,4,0,46,0,0,0,1,0,0,0,109,118,112,0, +6,0,5,0,46,0,0,0,2,0,0,0,100,105,102,102,117,115,101,0,6,0,5,0, +46,0,0,0,3,0,0,0,97,109,98,105,101,110,116,0,6,0,6,0,46,0,0,0, +4,0,0,0,101,109,105,115,115,105,118,101,0,0,0,0,6,0,7,0,46,0,0,0, +5,0,0,0,108,105,103,104,116,68,105,114,101,99,116,105,111,110,0,0,6,0,7,0, +46,0,0,0,6,0,0,0,108,105,103,104,116,65,109,98,105,101,110,116,0,0,0,0, +6,0,7,0,46,0,0,0,7,0,0,0,108,105,103,104,116,68,105,102,102,117,115,101, +0,0,0,0,6,0,6,0,46,0,0,0,8,0,0,0,102,111,103,67,111,108,111,114, +0,0,0,0,6,0,6,0,46,0,0,0,9,0,0,0,102,111,103,80,97,114,97,109, +115,0,0,0,6,0,5,0,46,0,0,0,10,0,0,0,109,111,100,101,115,0,0,0, +6,0,5,0,46,0,0,0,11,0,0,0,115,107,105,110,0,0,0,0,5,0,3,0, +48,0,0,0,116,0,0,0,5,0,5,0,51,0,0,0,84,114,97,110,115,102,111,114, +109,0,0,0,6,0,5,0,51,0,0,0,0,0,0,0,119,111,114,108,100,0,0,0, +6,0,4,0,51,0,0,0,1,0,0,0,109,118,112,0,6,0,5,0,51,0,0,0, +2,0,0,0,100,105,102,102,117,115,101,0,6,0,5,0,51,0,0,0,3,0,0,0, +97,109,98,105,101,110,116,0,6,0,6,0,51,0,0,0,4,0,0,0,101,109,105,115, +115,105,118,101,0,0,0,0,6,0,7,0,51,0,0,0,5,0,0,0,108,105,103,104, +116,68,105,114,101,99,116,105,111,110,0,0,6,0,7,0,51,0,0,0,6,0,0,0, +108,105,103,104,116,65,109,98,105,101,110,116,0,0,0,0,6,0,7,0,51,0,0,0, +7,0,0,0,108,105,103,104,116,68,105,102,102,117,115,101,0,0,0,0,6,0,6,0, +51,0,0,0,8,0,0,0,102,111,103,67,111,108,111,114,0,0,0,0,6,0,6,0, +51,0,0,0,9,0,0,0,102,111,103,80,97,114,97,109,115,0,0,0,6,0,5,0, +51,0,0,0,10,0,0,0,109,111,100,101,115,0,0,0,6,0,5,0,51,0,0,0, +11,0,0,0,115,107,105,110,0,0,0,0,5,0,4,0,52,0,0,0,72,101,97,100, +101,114,0,0,6,0,5,0,52,0,0,0,0,0,0,0,104,101,97,100,101,114,0,0, +5,0,3,0,54,0,0,0,0,0,0,0,5,0,5,0,64,0,0,0,84,114,97,110, +115,102,111,114,109,0,0,0,6,0,5,0,64,0,0,0,0,0,0,0,119,111,114,108, +100,0,0,0,6,0,4,0,64,0,0,0,1,0,0,0,109,118,112,0,6,0,5,0, +64,0,0,0,2,0,0,0,100,105,102,102,117,115,101,0,6,0,5,0,64,0,0,0, +3,0,0,0,97,109,98,105,101,110,116,0,6,0,6,0,64,0,0,0,4,0,0,0, +101,109,105,115,115,105,118,101,0,0,0,0,6,0,7,0,64,0,0,0,5,0,0,0, +108,105,103,104,116,68,105,114,101,99,116,105,111,110,0,0,6,0,7,0,64,0,0,0, +6,0,0,0,108,105,103,104,116,65,109,98,105,101,110,116,0,0,0,0,6,0,7,0, +64,0,0,0,7,0,0,0,108,105,103,104,116,68,105,102,102,117,115,101,0,0,0,0, +6,0,6,0,64,0,0,0,8,0,0,0,102,111,103,67,111,108,111,114,0,0,0,0, +6,0,6,0,64,0,0,0,9,0,0,0,102,111,103,80,97,114,97,109,115,0,0,0, +6,0,5,0,64,0,0,0,10,0,0,0,109,111,100,101,115,0,0,0,6,0,5,0, +64,0,0,0,11,0,0,0,115,107,105,110,0,0,0,0,5,0,5,0,70,0,0,0, +73,110,115,116,97,110,99,101,115,0,0,0,6,0,6,0,70,0,0,0,0,0,0,0, +105,110,115,116,97,110,99,101,115,0,0,0,5,0,3,0,72,0,0,0,0,0,0,0, +5,0,7,0,74,0,0,0,103,108,95,73,110,115,116,97,110,99,101,73,110,100,101,120, +0,0,0,0,5,0,3,0,198,0,0,0,112,0,0,0,5,0,5,0,200,0,0,0, +112,111,115,105,116,105,111,110,0,0,0,0,5,0,3,0,204,0,0,0,110,0,0,0, +5,0,4,0,205,0,0,0,110,111,114,109,97,108,0,0,5,0,4,0,214,0,0,0, +115,107,105,110,110,101,100,0,5,0,3,0,217,0,0,0,115,110,0,0,5,0,4,0, +219,0,0,0,116,111,116,97,108,0,0,0,5,0,3,0,221,0,0,0,105,0,0,0, +5,0,4,0,229,0,0,0,119,101,105,103,104,116,115,0,5,0,4,0,239,0,0,0, +98,111,110,101,115,0,0,0,5,0,3,0,252,0,0,0,98,0,0,0,5,0,3,0, +1,1,0,0,119,0,0,0,5,0,4,0,7,1,0,0,80,97,108,101,116,116,101,0, +6,0,5,0,7,1,0,0,0,0,0,0,112,97,108,101,116,116,101,0,5,0,3,0, +9,1,0,0,0,0,0,0,5,0,4,0,17,1,0,0,112,97,114,97,109,0,0,0, +5,0,4,0,19,1,0,0,112,97,114,97,109,0,0,0,5,0,4,0,23,1,0,0, +112,97,114,97,109,0,0,0,5,0,4,0,26,1,0,0,112,97,114,97,109,0,0,0, +5,0,4,0,29,1,0,0,112,97,114,97,109,0,0,0,5,0,4,0,49,1,0,0, +112,97,114,97,109,0,0,0,5,0,4,0,50,1,0,0,112,97,114,97,109,0,0,0, +5,0,4,0,53,1,0,0,112,97,114,97,109,0,0,0,5,0,4,0,56,1,0,0, +112,97,114,97,109,0,0,0,5,0,4,0,59,1,0,0,112,97,114,97,109,0,0,0, +5,0,4,0,86,1,0,0,99,108,105,112,0,0,0,0,5,0,3,0,88,1,0,0, +99,0,0,0,5,0,4,0,89,1,0,0,99,111,108,111,114,0,0,0,5,0,4,0, +96,1,0,0,112,97,114,97,109,0,0,0,5,0,4,0,98,1,0,0,112,97,114,97, +109,0,0,0,5,0,4,0,101,1,0,0,112,97,114,97,109,0,0,0,5,0,4,0, +104,1,0,0,112,97,114,97,109,0,0,0,5,0,4,0,107,1,0,0,112,97,114,97, +109,0,0,0,5,0,3,0,126,1,0,0,119,110,0,0,5,0,4,0,132,1,0,0, +112,97,114,97,109,0,0,0,5,0,4,0,133,1,0,0,112,97,114,97,109,0,0,0, +5,0,4,0,136,1,0,0,112,97,114,97,109,0,0,0,5,0,4,0,139,1,0,0, +112,97,114,97,109,0,0,0,5,0,4,0,142,1,0,0,112,97,114,97,109,0,0,0, +5,0,3,0,147,1,0,0,108,101,110,0,5,0,4,0,159,1,0,0,110,100,111,116, +108,0,0,0,5,0,3,0,206,1,0,0,102,0,0,0,5,0,6,0,1,2,0,0, +103,108,95,80,101,114,86,101,114,116,101,120,0,0,0,0,6,0,6,0,1,2,0,0, +0,0,0,0,103,108,95,80,111,115,105,116,105,111,110,0,6,0,7,0,1,2,0,0, +1,0,0,0,103,108,95,80,111,105,110,116,83,105,122,101,0,0,0,0,6,0,7,0, +1,2,0,0,2,0,0,0,103,108,95,67,108,105,112,68,105,115,116,97,110,99,101,0, +6,0,7,0,1,2,0,0,3,0,0,0,103,108,95,67,117,108,108,68,105,115,116,97, +110,99,101,0,5,0,3,0,3,2,0,0,0,0,0,0,5,0,4,0,7,2,0,0, +118,99,111,108,111,114,0,0,5,0,3,0,11,2,0,0,118,117,118,0,5,0,3,0, +13,2,0,0,117,118,0,0,71,0,4,0,49,0,0,0,6,0,0,0,16,0,0,0, +71,0,4,0,50,0,0,0,6,0,0,0,16,0,0,0,72,0,5,0,51,0,0,0, +0,0,0,0,35,0,0,0,0,0,0,0,72,0,5,0,51,0,0,0,1,0,0,0, +35,0,0,0,64,0,0,0,72,0,5,0,51,0,0,0,2,0,0,0,35,0,0,0, +128,0,0,0,72,0,5,0,51,0,0,0,3,0,0,0,35,0,0,0,144,0,0,0, +72,0,5,0,51,0,0,0,4,0,0,0,35,0,0,0,160,0,0,0,72,0,5,0, +51,0,0,0,5,0,0,0,35,0,0,0,176,0,0,0,72,0,5,0,51,0,0,0, +6,0,0,0,35,0,0,0,192,0,0,0,72,0,5,0,51,0,0,0,7,0,0,0, +35,0,0,0,208,0,0,0,72,0,5,0,51,0,0,0,8,0,0,0,35,0,0,0, +224,0,0,0,72,0,5,0,51,0,0,0,9,0,0,0,35,0,0,0,240,0,0,0, +72,0,5,0,51,0,0,0,10,0,0,0,35,0,0,0,0,1,0,0,72,0,5,0, +51,0,0,0,11,0,0,0,35,0,0,0,16,1,0,0,71,0,3,0,52,0,0,0, +2,0,0,0,72,0,5,0,52,0,0,0,0,0,0,0,35,0,0,0,0,0,0,0, +71,0,4,0,54,0,0,0,33,0,0,0,0,0,0,0,71,0,4,0,54,0,0,0, +34,0,0,0,1,0,0,0,71,0,4,0,69,0,0,0,6,0,0,0,32,1,0,0, +71,0,3,0,70,0,0,0,3,0,0,0,72,0,4,0,70,0,0,0,0,0,0,0, +24,0,0,0,72,0,5,0,70,0,0,0,0,0,0,0,35,0,0,0,0,0,0,0, +71,0,3,0,72,0,0,0,24,0,0,0,71,0,4,0,72,0,0,0,33,0,0,0, +0,0,0,0,71,0,4,0,72,0,0,0,34,0,0,0,0,0,0,0,71,0,4,0, +74,0,0,0,11,0,0,0,43,0,0,0,71,0,4,0,200,0,0,0,30,0,0,0, +0,0,0,0,71,0,4,0,205,0,0,0,30,0,0,0,3,0,0,0,71,0,4,0, +229,0,0,0,30,0,0,0,5,0,0,0,71,0,4,0,239,0,0,0,30,0,0,0, +4,0,0,0,71,0,4,0,6,1,0,0,6,0,0,0,16,0,0,0,71,0,3,0, +7,1,0,0,2,0,0,0,72,0,5,0,7,1,0,0,0,0,0,0,35,0,0,0, +0,0,0,0,71,0,4,0,9,1,0,0,33,0,0,0,1,0,0,0,71,0,4,0, +9,1,0,0,34,0,0,0,1,0,0,0,71,0,4,0,89,1,0,0,30,0,0,0, +1,0,0,0,71,0,3,0,1,2,0,0,2,0,0,0,72,0,5,0,1,2,0,0, +0,0,0,0,11,0,0,0,0,0,0,0,72,0,5,0,1,2,0,0,1,0,0,0, +11,0,0,0,1,0,0,0,72,0,5,0,1,2,0,0,2,0,0,0,11,0,0,0, +3,0,0,0,72,0,5,0,1,2,0,0,3,0,0,0,11,0,0,0,4,0,0,0, +71,0,4,0,7,2,0,0,30,0,0,0,0,0,0,0,71,0,4,0,11,2,0,0, +30,0,0,0,1,0,0,0,71,0,4,0,13,2,0,0,30,0,0,0,2,0,0,0, +19,0,2,0,2,0,0,0,33,0,3,0,3,0,0,0,2,0,0,0,22,0,3,0, +6,0,0,0,32,0,0,0,23,0,4,0,7,0,0,0,6,0,0,0,4,0,0,0, +32,0,4,0,8,0,0,0,7,0,0,0,7,0,0,0,33,0,8,0,9,0,0,0, +7,0,0,0,8,0,0,0,8,0,0,0,8,0,0,0,8,0,0,0,8,0,0,0, +21,0,4,0,17,0,0,0,32,0,0,0,0,0,0,0,43,0,4,0,17,0,0,0, +18,0,0,0,0,0,0,0,32,0,4,0,19,0,0,0,7,0,0,0,6,0,0,0, +43,0,4,0,17,0,0,0,24,0,0,0,1,0,0,0,43,0,4,0,17,0,0,0, +30,0,0,0,2,0,0,0,43,0,4,0,17,0,0,0,36,0,0,0,3,0,0,0, +43,0,4,0,17,0,0,0,44,0,0,0,4,0,0,0,28,0,4,0,45,0,0,0, +7,0,0,0,44,0,0,0,30,0,14,0,46,0,0,0,45,0,0,0,45,0,0,0, +7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0, +7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,32,0,4,0,47,0,0,0, +7,0,0,0,46,0,0,0,28,0,4,0,49,0,0,0,7,0,0,0,44,0,0,0, +28,0,4,0,50,0,0,0,7,0,0,0,44,0,0,0,30,0,14,0,51,0,0,0, +49,0,0,0,50,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0, +7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0, +30,0,3,0,52,0,0,0,51,0,0,0,32,0,4,0,53,0,0,0,2,0,0,0, +52,0,0,0,59,0,4,0,53,0,0,0,54,0,0,0,2,0,0,0,21,0,4,0, +55,0,0,0,32,0,0,0,1,0,0,0,43,0,4,0,55,0,0,0,56,0,0,0, +0,0,0,0,43,0,4,0,55,0,0,0,57,0,0,0,10,0,0,0,32,0,4,0, +58,0,0,0,2,0,0,0,6,0,0,0,43,0,4,0,6,0,0,0,61,0,0,0, +0,0,192,63,20,0,2,0,62,0,0,0,30,0,14,0,64,0,0,0,45,0,0,0, +45,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0, +7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,7,0,0,0,32,0,4,0, +65,0,0,0,7,0,0,0,64,0,0,0,29,0,3,0,69,0,0,0,51,0,0,0, +30,0,3,0,70,0,0,0,69,0,0,0,32,0,4,0,71,0,0,0,2,0,0,0, +70,0,0,0,59,0,4,0,71,0,0,0,72,0,0,0,2,0,0,0,32,0,4,0, +73,0,0,0,1,0,0,0,55,0,0,0,59,0,4,0,73,0,0,0,74,0,0,0, +1,0,0,0,32,0,4,0,76,0,0,0,2,0,0,0,51,0,0,0,32,0,4,0, +80,0,0,0,7,0,0,0,45,0,0,0,43,0,4,0,55,0,0,0,85,0,0,0, +1,0,0,0,43,0,4,0,55,0,0,0,88,0,0,0,2,0,0,0,43,0,4,0, +55,0,0,0,91,0,0,0,3,0,0,0,43,0,4,0,55,0,0,0,108,0,0,0, +4,0,0,0,43,0,4,0,55,0,0,0,111,0,0,0,5,0,0,0,43,0,4,0, +55,0,0,0,114,0,0,0,6,0,0,0,43,0,4,0,55,0,0,0,117,0,0,0, +7,0,0,0,43,0,4,0,55,0,0,0,120,0,0,0,8,0,0,0,43,0,4,0, +55,0,0,0,123,0,0,0,9,0,0,0,43,0,4,0,55,0,0,0,128,0,0,0, +11,0,0,0,32,0,4,0,199,0,0,0,1,0,0,0,7,0,0,0,59,0,4,0, +199,0,0,0,200,0,0,0,1,0,0,0,23,0,4,0,202,0,0,0,6,0,0,0, +3,0,0,0,32,0,4,0,203,0,0,0,7,0,0,0,202,0,0,0,59,0,4,0, +199,0,0,0,205,0,0,0,1,0,0,0,43,0,4,0,6,0,0,0,210,0,0,0, +0,0,0,63,43,0,4,0,6,0,0,0,215,0,0,0,0,0,0,0,44,0,7,0, +7,0,0,0,216,0,0,0,215,0,0,0,215,0,0,0,215,0,0,0,215,0,0,0, +44,0,6,0,202,0,0,0,218,0,0,0,215,0,0,0,215,0,0,0,215,0,0,0, +32,0,4,0,220,0,0,0,7,0,0,0,55,0,0,0,59,0,4,0,199,0,0,0, +229,0,0,0,1,0,0,0,32,0,4,0,231,0,0,0,1,0,0,0,6,0,0,0, +23,0,4,0,237,0,0,0,17,0,0,0,4,0,0,0,32,0,4,0,238,0,0,0, +1,0,0,0,237,0,0,0,59,0,4,0,238,0,0,0,239,0,0,0,1,0,0,0, +32,0,4,0,241,0,0,0,1,0,0,0,17,0,0,0,32,0,4,0,251,0,0,0, +7,0,0,0,17,0,0,0,43,0,4,0,17,0,0,0,5,1,0,0,0,2,0,0, +28,0,4,0,6,1,0,0,7,0,0,0,5,1,0,0,30,0,3,0,7,1,0,0, +6,1,0,0,32,0,4,0,8,1,0,0,2,0,0,0,7,1,0,0,59,0,4,0, +8,1,0,0,9,1,0,0,2,0,0,0,32,0,4,0,20,1,0,0,2,0,0,0, +7,0,0,0,43,0,4,0,6,0,0,0,74,1,0,0,23,183,209,56,43,0,4,0, +6,0,0,0,80,1,0,0,0,0,128,63,59,0,4,0,199,0,0,0,89,1,0,0, +1,0,0,0,43,0,4,0,6,0,0,0,151,1,0,0,172,197,39,55,43,0,4,0, +6,0,0,0,218,1,0,0,0,0,32,65,28,0,4,0,0,2,0,0,6,0,0,0, +24,0,0,0,30,0,6,0,1,2,0,0,7,0,0,0,6,0,0,0,0,2,0,0, +0,2,0,0,32,0,4,0,2,2,0,0,3,0,0,0,1,2,0,0,59,0,4,0, +2,2,0,0,3,2,0,0,3,0,0,0,32,0,4,0,5,2,0,0,3,0,0,0, +7,0,0,0,59,0,4,0,5,2,0,0,7,2,0,0,3,0,0,0,23,0,4,0, +9,2,0,0,6,0,0,0,2,0,0,0,32,0,4,0,10,2,0,0,3,0,0,0, +9,2,0,0,59,0,4,0,10,2,0,0,11,2,0,0,3,0,0,0,32,0,4,0, +12,2,0,0,1,0,0,0,9,2,0,0,59,0,4,0,12,2,0,0,13,2,0,0, +1,0,0,0,54,0,5,0,2,0,0,0,4,0,0,0,0,0,0,0,3,0,0,0, +248,0,2,0,5,0,0,0,59,0,4,0,47,0,0,0,48,0,0,0,7,0,0,0, +59,0,4,0,65,0,0,0,66,0,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +198,0,0,0,7,0,0,0,59,0,4,0,203,0,0,0,204,0,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,214,0,0,0,7,0,0,0,59,0,4,0,203,0,0,0, +217,0,0,0,7,0,0,0,59,0,4,0,19,0,0,0,219,0,0,0,7,0,0,0, +59,0,4,0,220,0,0,0,221,0,0,0,7,0,0,0,59,0,4,0,251,0,0,0, +252,0,0,0,7,0,0,0,59,0,4,0,19,0,0,0,1,1,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,17,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +19,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0,23,1,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,26,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +29,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0,49,1,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,50,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +53,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0,56,1,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,59,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +86,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0,88,1,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,96,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +98,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0,101,1,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,104,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +107,1,0,0,7,0,0,0,59,0,4,0,203,0,0,0,126,1,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,132,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +133,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0,136,1,0,0,7,0,0,0, +59,0,4,0,8,0,0,0,139,1,0,0,7,0,0,0,59,0,4,0,8,0,0,0, +142,1,0,0,7,0,0,0,59,0,4,0,19,0,0,0,147,1,0,0,7,0,0,0, +59,0,4,0,19,0,0,0,159,1,0,0,7,0,0,0,59,0,4,0,19,0,0,0, +206,1,0,0,7,0,0,0,59,0,4,0,19,0,0,0,210,1,0,0,7,0,0,0, +65,0,7,0,58,0,0,0,59,0,0,0,54,0,0,0,56,0,0,0,57,0,0,0, +18,0,0,0,61,0,4,0,6,0,0,0,60,0,0,0,59,0,0,0,186,0,5,0, +62,0,0,0,63,0,0,0,60,0,0,0,61,0,0,0,247,0,3,0,68,0,0,0, +0,0,0,0,250,0,4,0,63,0,0,0,67,0,0,0,130,0,0,0,248,0,2,0, +67,0,0,0,61,0,4,0,55,0,0,0,75,0,0,0,74,0,0,0,65,0,6,0, +76,0,0,0,77,0,0,0,72,0,0,0,56,0,0,0,75,0,0,0,61,0,4,0, +51,0,0,0,78,0,0,0,77,0,0,0,81,0,5,0,49,0,0,0,79,0,0,0, +78,0,0,0,0,0,0,0,65,0,5,0,80,0,0,0,81,0,0,0,66,0,0,0, +56,0,0,0,81,0,5,0,7,0,0,0,82,0,0,0,79,0,0,0,0,0,0,0, +65,0,5,0,8,0,0,0,83,0,0,0,81,0,0,0,56,0,0,0,62,0,3,0, +83,0,0,0,82,0,0,0,81,0,5,0,7,0,0,0,84,0,0,0,79,0,0,0, +1,0,0,0,65,0,5,0,8,0,0,0,86,0,0,0,81,0,0,0,85,0,0,0, +62,0,3,0,86,0,0,0,84,0,0,0,81,0,5,0,7,0,0,0,87,0,0,0, +79,0,0,0,2,0,0,0,65,0,5,0,8,0,0,0,89,0,0,0,81,0,0,0, +88,0,0,0,62,0,3,0,89,0,0,0,87,0,0,0,81,0,5,0,7,0,0,0, +90,0,0,0,79,0,0,0,3,0,0,0,65,0,5,0,8,0,0,0,92,0,0,0, +81,0,0,0,91,0,0,0,62,0,3,0,92,0,0,0,90,0,0,0,81,0,5,0, +50,0,0,0,93,0,0,0,78,0,0,0,1,0,0,0,65,0,5,0,80,0,0,0, +94,0,0,0,66,0,0,0,85,0,0,0,81,0,5,0,7,0,0,0,95,0,0,0, +93,0,0,0,0,0,0,0,65,0,5,0,8,0,0,0,96,0,0,0,94,0,0,0, +56,0,0,0,62,0,3,0,96,0,0,0,95,0,0,0,81,0,5,0,7,0,0,0, +97,0,0,0,93,0,0,0,1,0,0,0,65,0,5,0,8,0,0,0,98,0,0,0, +94,0,0,0,85,0,0,0,62,0,3,0,98,0,0,0,97,0,0,0,81,0,5,0, +7,0,0,0,99,0,0,0,93,0,0,0,2,0,0,0,65,0,5,0,8,0,0,0, +100,0,0,0,94,0,0,0,88,0,0,0,62,0,3,0,100,0,0,0,99,0,0,0, +81,0,5,0,7,0,0,0,101,0,0,0,93,0,0,0,3,0,0,0,65,0,5,0, +8,0,0,0,102,0,0,0,94,0,0,0,91,0,0,0,62,0,3,0,102,0,0,0, +101,0,0,0,81,0,5,0,7,0,0,0,103,0,0,0,78,0,0,0,2,0,0,0, +65,0,5,0,8,0,0,0,104,0,0,0,66,0,0,0,88,0,0,0,62,0,3,0, +104,0,0,0,103,0,0,0,81,0,5,0,7,0,0,0,105,0,0,0,78,0,0,0, +3,0,0,0,65,0,5,0,8,0,0,0,106,0,0,0,66,0,0,0,91,0,0,0, +62,0,3,0,106,0,0,0,105,0,0,0,81,0,5,0,7,0,0,0,107,0,0,0, +78,0,0,0,4,0,0,0,65,0,5,0,8,0,0,0,109,0,0,0,66,0,0,0, +108,0,0,0,62,0,3,0,109,0,0,0,107,0,0,0,81,0,5,0,7,0,0,0, +110,0,0,0,78,0,0,0,5,0,0,0,65,0,5,0,8,0,0,0,112,0,0,0, +66,0,0,0,111,0,0,0,62,0,3,0,112,0,0,0,110,0,0,0,81,0,5,0, +7,0,0,0,113,0,0,0,78,0,0,0,6,0,0,0,65,0,5,0,8,0,0,0, +115,0,0,0,66,0,0,0,114,0,0,0,62,0,3,0,115,0,0,0,113,0,0,0, +81,0,5,0,7,0,0,0,116,0,0,0,78,0,0,0,7,0,0,0,65,0,5,0, +8,0,0,0,118,0,0,0,66,0,0,0,117,0,0,0,62,0,3,0,118,0,0,0, +116,0,0,0,81,0,5,0,7,0,0,0,119,0,0,0,78,0,0,0,8,0,0,0, +65,0,5,0,8,0,0,0,121,0,0,0,66,0,0,0,120,0,0,0,62,0,3,0, +121,0,0,0,119,0,0,0,81,0,5,0,7,0,0,0,122,0,0,0,78,0,0,0, +9,0,0,0,65,0,5,0,8,0,0,0,124,0,0,0,66,0,0,0,123,0,0,0, +62,0,3,0,124,0,0,0,122,0,0,0,81,0,5,0,7,0,0,0,125,0,0,0, +78,0,0,0,10,0,0,0,65,0,5,0,8,0,0,0,126,0,0,0,66,0,0,0, +57,0,0,0,62,0,3,0,126,0,0,0,125,0,0,0,81,0,5,0,7,0,0,0, +127,0,0,0,78,0,0,0,11,0,0,0,65,0,5,0,8,0,0,0,129,0,0,0, +66,0,0,0,128,0,0,0,62,0,3,0,129,0,0,0,127,0,0,0,249,0,2,0, +68,0,0,0,248,0,2,0,130,0,0,0,65,0,5,0,76,0,0,0,131,0,0,0, +54,0,0,0,56,0,0,0,61,0,4,0,51,0,0,0,132,0,0,0,131,0,0,0, +81,0,5,0,49,0,0,0,133,0,0,0,132,0,0,0,0,0,0,0,65,0,5,0, +80,0,0,0,134,0,0,0,66,0,0,0,56,0,0,0,81,0,5,0,7,0,0,0, +135,0,0,0,133,0,0,0,0,0,0,0,65,0,5,0,8,0,0,0,136,0,0,0, +134,0,0,0,56,0,0,0,62,0,3,0,136,0,0,0,135,0,0,0,81,0,5,0, +7,0,0,0,137,0,0,0,133,0,0,0,1,0,0,0,65,0,5,0,8,0,0,0, +138,0,0,0,134,0,0,0,85,0,0,0,62,0,3,0,138,0,0,0,137,0,0,0, +81,0,5,0,7,0,0,0,139,0,0,0,133,0,0,0,2,0,0,0,65,0,5,0, +8,0,0,0,140,0,0,0,134,0,0,0,88,0,0,0,62,0,3,0,140,0,0,0, +139,0,0,0,81,0,5,0,7,0,0,0,141,0,0,0,133,0,0,0,3,0,0,0, +65,0,5,0,8,0,0,0,142,0,0,0,134,0,0,0,91,0,0,0,62,0,3,0, +142,0,0,0,141,0,0,0,81,0,5,0,50,0,0,0,143,0,0,0,132,0,0,0, +1,0,0,0,65,0,5,0,80,0,0,0,144,0,0,0,66,0,0,0,85,0,0,0, +81,0,5,0,7,0,0,0,145,0,0,0,143,0,0,0,0,0,0,0,65,0,5,0, +8,0,0,0,146,0,0,0,144,0,0,0,56,0,0,0,62,0,3,0,146,0,0,0, +145,0,0,0,81,0,5,0,7,0,0,0,147,0,0,0,143,0,0,0,1,0,0,0, +65,0,5,0,8,0,0,0,148,0,0,0,144,0,0,0,85,0,0,0,62,0,3,0, +148,0,0,0,147,0,0,0,81,0,5,0,7,0,0,0,149,0,0,0,143,0,0,0, +2,0,0,0,65,0,5,0,8,0,0,0,150,0,0,0,144,0,0,0,88,0,0,0, +62,0,3,0,150,0,0,0,149,0,0,0,81,0,5,0,7,0,0,0,151,0,0,0, +143,0,0,0,3,0,0,0,65,0,5,0,8,0,0,0,152,0,0,0,144,0,0,0, +91,0,0,0,62,0,3,0,152,0,0,0,151,0,0,0,81,0,5,0,7,0,0,0, +153,0,0,0,132,0,0,0,2,0,0,0,65,0,5,0,8,0,0,0,154,0,0,0, +66,0,0,0,88,0,0,0,62,0,3,0,154,0,0,0,153,0,0,0,81,0,5,0, +7,0,0,0,155,0,0,0,132,0,0,0,3,0,0,0,65,0,5,0,8,0,0,0, +156,0,0,0,66,0,0,0,91,0,0,0,62,0,3,0,156,0,0,0,155,0,0,0, +81,0,5,0,7,0,0,0,157,0,0,0,132,0,0,0,4,0,0,0,65,0,5,0, +8,0,0,0,158,0,0,0,66,0,0,0,108,0,0,0,62,0,3,0,158,0,0,0, +157,0,0,0,81,0,5,0,7,0,0,0,159,0,0,0,132,0,0,0,5,0,0,0, +65,0,5,0,8,0,0,0,160,0,0,0,66,0,0,0,111,0,0,0,62,0,3,0, +160,0,0,0,159,0,0,0,81,0,5,0,7,0,0,0,161,0,0,0,132,0,0,0, +6,0,0,0,65,0,5,0,8,0,0,0,162,0,0,0,66,0,0,0,114,0,0,0, +62,0,3,0,162,0,0,0,161,0,0,0,81,0,5,0,7,0,0,0,163,0,0,0, +132,0,0,0,7,0,0,0,65,0,5,0,8,0,0,0,164,0,0,0,66,0,0,0, +117,0,0,0,62,0,3,0,164,0,0,0,163,0,0,0,81,0,5,0,7,0,0,0, +165,0,0,0,132,0,0,0,8,0,0,0,65,0,5,0,8,0,0,0,166,0,0,0, +66,0,0,0,120,0,0,0,62,0,3,0,166,0,0,0,165,0,0,0,81,0,5,0, +7,0,0,0,167,0,0,0,132,0,0,0,9,0,0,0,65,0,5,0,8,0,0,0, +168,0,0,0,66,0,0,0,123,0,0,0,62,0,3,0,168,0,0,0,167,0,0,0, +81,0,5,0,7,0,0,0,169,0,0,0,132,0,0,0,10,0,0,0,65,0,5,0, +8,0,0,0,170,0,0,0,66,0,0,0,57,0,0,0,62,0,3,0,170,0,0,0, +169,0,0,0,81,0,5,0,7,0,0,0,171,0,0,0,132,0,0,0,11,0,0,0, +65,0,5,0,8,0,0,0,172,0,0,0,66,0,0,0,128,0,0,0,62,0,3,0, +172,0,0,0,171,0,0,0,249,0,2,0,68,0,0,0,248,0,2,0,68,0,0,0, +61,0,4,0,64,0,0,0,173,0,0,0,66,0,0,0,81,0,5,0,45,0,0,0, +174,0,0,0,173,0,0,0,0,0,0,0,65,0,5,0,80,0,0,0,175,0,0,0, +48,0,0,0,56,0,0,0,62,0,3,0,175,0,0,0,174,0,0,0,81,0,5,0, +45,0,0,0,176,0,0,0,173,0,0,0,1,0,0,0,65,0,5,0,80,0,0,0, +177,0,0,0,48,0,0,0,85,0,0,0,62,0,3,0,177,0,0,0,176,0,0,0, +81,0,5,0,7,0,0,0,178,0,0,0,173,0,0,0,2,0,0,0,65,0,5,0, +8,0,0,0,179,0,0,0,48,0,0,0,88,0,0,0,62,0,3,0,179,0,0,0, +178,0,0,0,81,0,5,0,7,0,0,0,180,0,0,0,173,0,0,0,3,0,0,0, +65,0,5,0,8,0,0,0,181,0,0,0,48,0,0,0,91,0,0,0,62,0,3,0, +181,0,0,0,180,0,0,0,81,0,5,0,7,0,0,0,182,0,0,0,173,0,0,0, +4,0,0,0,65,0,5,0,8,0,0,0,183,0,0,0,48,0,0,0,108,0,0,0, +62,0,3,0,183,0,0,0,182,0,0,0,81,0,5,0,7,0,0,0,184,0,0,0, +173,0,0,0,5,0,0,0,65,0,5,0,8,0,0,0,185,0,0,0,48,0,0,0, +111,0,0,0,62,0,3,0,185,0,0,0,184,0,0,0,81,0,5,0,7,0,0,0, +186,0,0,0,173,0,0,0,6,0,0,0,65,0,5,0,8,0,0,0,187,0,0,0, +48,0,0,0,114,0,0,0,62,0,3,0,187,0,0,0,186,0,0,0,81,0,5,0, +7,0,0,0,188,0,0,0,173,0,0,0,7,0,0,0,65,0,5,0,8,0,0,0, +189,0,0,0,48,0,0,0,117,0,0,0,62,0,3,0,189,0,0,0,188,0,0,0, +81,0,5,0,7,0,0,0,190,0,0,0,173,0,0,0,8,0,0,0,65,0,5,0, +8,0,0,0,191,0,0,0,48,0,0,0,120,0,0,0,62,0,3,0,191,0,0,0, +190,0,0,0,81,0,5,0,7,0,0,0,192,0,0,0,173,0,0,0,9,0,0,0, +65,0,5,0,8,0,0,0,193,0,0,0,48,0,0,0,123,0,0,0,62,0,3,0, +193,0,0,0,192,0,0,0,81,0,5,0,7,0,0,0,194,0,0,0,173,0,0,0, +10,0,0,0,65,0,5,0,8,0,0,0,195,0,0,0,48,0,0,0,57,0,0,0, +62,0,3,0,195,0,0,0,194,0,0,0,81,0,5,0,7,0,0,0,196,0,0,0, +173,0,0,0,11,0,0,0,65,0,5,0,8,0,0,0,197,0,0,0,48,0,0,0, +128,0,0,0,62,0,3,0,197,0,0,0,196,0,0,0,61,0,4,0,7,0,0,0, +201,0,0,0,200,0,0,0,62,0,3,0,198,0,0,0,201,0,0,0,61,0,4,0, +7,0,0,0,206,0,0,0,205,0,0,0,79,0,8,0,202,0,0,0,207,0,0,0, +206,0,0,0,206,0,0,0,0,0,0,0,1,0,0,0,2,0,0,0,62,0,3,0, +204,0,0,0,207,0,0,0,65,0,6,0,19,0,0,0,208,0,0,0,48,0,0,0, +128,0,0,0,18,0,0,0,61,0,4,0,6,0,0,0,209,0,0,0,208,0,0,0, +186,0,5,0,62,0,0,0,211,0,0,0,209,0,0,0,210,0,0,0,247,0,3,0, +213,0,0,0,0,0,0,0,250,0,4,0,211,0,0,0,212,0,0,0,213,0,0,0, +248,0,2,0,212,0,0,0,62,0,3,0,214,0,0,0,216,0,0,0,62,0,3,0, +217,0,0,0,218,0,0,0,62,0,3,0,219,0,0,0,215,0,0,0,62,0,3,0, +221,0,0,0,56,0,0,0,249,0,2,0,222,0,0,0,248,0,2,0,222,0,0,0, +246,0,4,0,224,0,0,0,225,0,0,0,0,0,0,0,249,0,2,0,226,0,0,0, +248,0,2,0,226,0,0,0,61,0,4,0,55,0,0,0,227,0,0,0,221,0,0,0, +177,0,5,0,62,0,0,0,228,0,0,0,227,0,0,0,108,0,0,0,250,0,4,0, +228,0,0,0,223,0,0,0,224,0,0,0,248,0,2,0,223,0,0,0,61,0,4,0, +55,0,0,0,230,0,0,0,221,0,0,0,65,0,5,0,231,0,0,0,232,0,0,0, +229,0,0,0,230,0,0,0,61,0,4,0,6,0,0,0,233,0,0,0,232,0,0,0, +186,0,5,0,62,0,0,0,234,0,0,0,233,0,0,0,215,0,0,0,247,0,3,0, +236,0,0,0,0,0,0,0,250,0,4,0,234,0,0,0,235,0,0,0,236,0,0,0, +248,0,2,0,235,0,0,0,61,0,4,0,55,0,0,0,240,0,0,0,221,0,0,0, +65,0,5,0,241,0,0,0,242,0,0,0,239,0,0,0,240,0,0,0,61,0,4,0, +17,0,0,0,243,0,0,0,242,0,0,0,65,0,6,0,19,0,0,0,244,0,0,0, +48,0,0,0,128,0,0,0,18,0,0,0,61,0,4,0,6,0,0,0,245,0,0,0, +244,0,0,0,109,0,4,0,17,0,0,0,246,0,0,0,245,0,0,0,176,0,5,0, +62,0,0,0,247,0,0,0,243,0,0,0,246,0,0,0,249,0,2,0,236,0,0,0, +248,0,2,0,236,0,0,0,245,0,7,0,62,0,0,0,248,0,0,0,234,0,0,0, +223,0,0,0,247,0,0,0,235,0,0,0,247,0,3,0,250,0,0,0,0,0,0,0, +250,0,4,0,248,0,0,0,249,0,0,0,250,0,0,0,248,0,2,0,249,0,0,0, +61,0,4,0,55,0,0,0,253,0,0,0,221,0,0,0,65,0,5,0,241,0,0,0, +254,0,0,0,239,0,0,0,253,0,0,0,61,0,4,0,17,0,0,0,255,0,0,0, +254,0,0,0,132,0,5,0,17,0,0,0,0,1,0,0,255,0,0,0,44,0,0,0, +62,0,3,0,252,0,0,0,0,1,0,0,61,0,4,0,55,0,0,0,2,1,0,0, +221,0,0,0,65,0,5,0,231,0,0,0,3,1,0,0,229,0,0,0,2,1,0,0, +61,0,4,0,6,0,0,0,4,1,0,0,3,1,0,0,62,0,3,0,1,1,0,0, +4,1,0,0,61,0,4,0,17,0,0,0,10,1,0,0,252,0,0,0,61,0,4,0, +17,0,0,0,11,1,0,0,252,0,0,0,128,0,5,0,17,0,0,0,12,1,0,0, +11,1,0,0,24,0,0,0,61,0,4,0,17,0,0,0,13,1,0,0,252,0,0,0, +128,0,5,0,17,0,0,0,14,1,0,0,13,1,0,0,30,0,0,0,61,0,4,0, +17,0,0,0,15,1,0,0,252,0,0,0,128,0,5,0,17,0,0,0,16,1,0,0, +15,1,0,0,36,0,0,0,61,0,4,0,7,0,0,0,18,1,0,0,198,0,0,0, +62,0,3,0,17,1,0,0,18,1,0,0,65,0,6,0,20,1,0,0,21,1,0,0, +9,1,0,0,56,0,0,0,10,1,0,0,61,0,4,0,7,0,0,0,22,1,0,0, +21,1,0,0,62,0,3,0,19,1,0,0,22,1,0,0,65,0,6,0,20,1,0,0, +24,1,0,0,9,1,0,0,56,0,0,0,12,1,0,0,61,0,4,0,7,0,0,0, +25,1,0,0,24,1,0,0,62,0,3,0,23,1,0,0,25,1,0,0,65,0,6,0, +20,1,0,0,27,1,0,0,9,1,0,0,56,0,0,0,14,1,0,0,61,0,4,0, +7,0,0,0,28,1,0,0,27,1,0,0,62,0,3,0,26,1,0,0,28,1,0,0, +65,0,6,0,20,1,0,0,30,1,0,0,9,1,0,0,56,0,0,0,16,1,0,0, +61,0,4,0,7,0,0,0,31,1,0,0,30,1,0,0,62,0,3,0,29,1,0,0, +31,1,0,0,57,0,9,0,7,0,0,0,32,1,0,0,15,0,0,0,17,1,0,0, +19,1,0,0,23,1,0,0,26,1,0,0,29,1,0,0,61,0,4,0,6,0,0,0, +33,1,0,0,1,1,0,0,142,0,5,0,7,0,0,0,34,1,0,0,32,1,0,0, +33,1,0,0,61,0,4,0,7,0,0,0,35,1,0,0,214,0,0,0,129,0,5,0, +7,0,0,0,36,1,0,0,35,1,0,0,34,1,0,0,62,0,3,0,214,0,0,0, +36,1,0,0,61,0,4,0,202,0,0,0,37,1,0,0,204,0,0,0,81,0,5,0, +6,0,0,0,38,1,0,0,37,1,0,0,0,0,0,0,81,0,5,0,6,0,0,0, +39,1,0,0,37,1,0,0,1,0,0,0,81,0,5,0,6,0,0,0,40,1,0,0, +37,1,0,0,2,0,0,0,80,0,7,0,7,0,0,0,41,1,0,0,38,1,0,0, +39,1,0,0,40,1,0,0,215,0,0,0,61,0,4,0,17,0,0,0,42,1,0,0, +252,0,0,0,61,0,4,0,17,0,0,0,43,1,0,0,252,0,0,0,128,0,5,0, +17,0,0,0,44,1,0,0,43,1,0,0,24,0,0,0,61,0,4,0,17,0,0,0, +45,1,0,0,252,0,0,0,128,0,5,0,17,0,0,0,46,1,0,0,45,1,0,0, +30,0,0,0,61,0,4,0,17,0,0,0,47,1,0,0,252,0,0,0,128,0,5,0, +17,0,0,0,48,1,0,0,47,1,0,0,36,0,0,0,62,0,3,0,49,1,0,0, +41,1,0,0,65,0,6,0,20,1,0,0,51,1,0,0,9,1,0,0,56,0,0,0, +42,1,0,0,61,0,4,0,7,0,0,0,52,1,0,0,51,1,0,0,62,0,3,0, +50,1,0,0,52,1,0,0,65,0,6,0,20,1,0,0,54,1,0,0,9,1,0,0, +56,0,0,0,44,1,0,0,61,0,4,0,7,0,0,0,55,1,0,0,54,1,0,0, +62,0,3,0,53,1,0,0,55,1,0,0,65,0,6,0,20,1,0,0,57,1,0,0, +9,1,0,0,56,0,0,0,46,1,0,0,61,0,4,0,7,0,0,0,58,1,0,0, +57,1,0,0,62,0,3,0,56,1,0,0,58,1,0,0,65,0,6,0,20,1,0,0, +60,1,0,0,9,1,0,0,56,0,0,0,48,1,0,0,61,0,4,0,7,0,0,0, +61,1,0,0,60,1,0,0,62,0,3,0,59,1,0,0,61,1,0,0,57,0,9,0, +7,0,0,0,62,1,0,0,15,0,0,0,49,1,0,0,50,1,0,0,53,1,0,0, +56,1,0,0,59,1,0,0,79,0,8,0,202,0,0,0,63,1,0,0,62,1,0,0, +62,1,0,0,0,0,0,0,1,0,0,0,2,0,0,0,61,0,4,0,6,0,0,0, +64,1,0,0,1,1,0,0,142,0,5,0,202,0,0,0,65,1,0,0,63,1,0,0, +64,1,0,0,61,0,4,0,202,0,0,0,66,1,0,0,217,0,0,0,129,0,5,0, +202,0,0,0,67,1,0,0,66,1,0,0,65,1,0,0,62,0,3,0,217,0,0,0, +67,1,0,0,61,0,4,0,6,0,0,0,68,1,0,0,1,1,0,0,61,0,4,0, +6,0,0,0,69,1,0,0,219,0,0,0,129,0,5,0,6,0,0,0,70,1,0,0, +69,1,0,0,68,1,0,0,62,0,3,0,219,0,0,0,70,1,0,0,249,0,2,0, +250,0,0,0,248,0,2,0,250,0,0,0,249,0,2,0,225,0,0,0,248,0,2,0, +225,0,0,0,61,0,4,0,55,0,0,0,71,1,0,0,221,0,0,0,128,0,5,0, +55,0,0,0,72,1,0,0,71,1,0,0,85,0,0,0,62,0,3,0,221,0,0,0, +72,1,0,0,249,0,2,0,222,0,0,0,248,0,2,0,224,0,0,0,61,0,4,0, +6,0,0,0,73,1,0,0,219,0,0,0,186,0,5,0,62,0,0,0,75,1,0,0, +73,1,0,0,74,1,0,0,247,0,3,0,77,1,0,0,0,0,0,0,250,0,4,0, +75,1,0,0,76,1,0,0,77,1,0,0,248,0,2,0,76,1,0,0,61,0,4,0, +7,0,0,0,78,1,0,0,214,0,0,0,79,0,8,0,202,0,0,0,79,1,0,0, +78,1,0,0,78,1,0,0,0,0,0,0,1,0,0,0,2,0,0,0,81,0,5,0, +6,0,0,0,81,1,0,0,79,1,0,0,0,0,0,0,81,0,5,0,6,0,0,0, +82,1,0,0,79,1,0,0,1,0,0,0,81,0,5,0,6,0,0,0,83,1,0,0, +79,1,0,0,2,0,0,0,80,0,7,0,7,0,0,0,84,1,0,0,81,1,0,0, +82,1,0,0,83,1,0,0,80,1,0,0,62,0,3,0,198,0,0,0,84,1,0,0, +61,0,4,0,202,0,0,0,85,1,0,0,217,0,0,0,62,0,3,0,204,0,0,0, +85,1,0,0,249,0,2,0,77,1,0,0,248,0,2,0,77,1,0,0,249,0,2,0, +213,0,0,0,248,0,2,0,213,0,0,0,61,0,4,0,7,0,0,0,87,1,0,0, +198,0,0,0,62,0,3,0,86,1,0,0,87,1,0,0,61,0,4,0,7,0,0,0, +90,1,0,0,89,1,0,0,62,0,3,0,88,1,0,0,90,1,0,0,65,0,6,0, +19,0,0,0,91,1,0,0,48,0,0,0,57,0,0,0,18,0,0,0,61,0,4,0, +6,0,0,0,92,1,0,0,91,1,0,0,186,0,5,0,62,0,0,0,93,1,0,0, +92,1,0,0,210,0,0,0,247,0,3,0,95,1,0,0,0,0,0,0,250,0,4,0, +93,1,0,0,94,1,0,0,95,1,0,0,248,0,2,0,94,1,0,0,61,0,4,0, +7,0,0,0,97,1,0,0,198,0,0,0,62,0,3,0,96,1,0,0,97,1,0,0, +65,0,6,0,8,0,0,0,99,1,0,0,48,0,0,0,85,0,0,0,56,0,0,0, +61,0,4,0,7,0,0,0,100,1,0,0,99,1,0,0,62,0,3,0,98,1,0,0, +100,1,0,0,65,0,6,0,8,0,0,0,102,1,0,0,48,0,0,0,85,0,0,0, +85,0,0,0,61,0,4,0,7,0,0,0,103,1,0,0,102,1,0,0,62,0,3,0, +101,1,0,0,103,1,0,0,65,0,6,0,8,0,0,0,105,1,0,0,48,0,0,0, +85,0,0,0,88,0,0,0,61,0,4,0,7,0,0,0,106,1,0,0,105,1,0,0, +62,0,3,0,104,1,0,0,106,1,0,0,65,0,6,0,8,0,0,0,108,1,0,0, +48,0,0,0,85,0,0,0,91,0,0,0,61,0,4,0,7,0,0,0,109,1,0,0, +108,1,0,0,62,0,3,0,107,1,0,0,109,1,0,0,57,0,9,0,7,0,0,0, +110,1,0,0,15,0,0,0,96,1,0,0,98,1,0,0,101,1,0,0,104,1,0,0, +107,1,0,0,62,0,3,0,86,1,0,0,110,1,0,0,65,0,5,0,8,0,0,0, +111,1,0,0,48,0,0,0,88,0,0,0,61,0,4,0,7,0,0,0,112,1,0,0, +111,1,0,0,61,0,4,0,7,0,0,0,113,1,0,0,88,1,0,0,133,0,5,0, +7,0,0,0,114,1,0,0,113,1,0,0,112,1,0,0,62,0,3,0,88,1,0,0, +114,1,0,0,65,0,6,0,19,0,0,0,115,1,0,0,48,0,0,0,57,0,0,0, +24,0,0,0,61,0,4,0,6,0,0,0,116,1,0,0,115,1,0,0,186,0,5,0, +62,0,0,0,117,1,0,0,116,1,0,0,210,0,0,0,247,0,3,0,119,1,0,0, +0,0,0,0,250,0,4,0,117,1,0,0,118,1,0,0,119,1,0,0,248,0,2,0, +118,1,0,0,65,0,5,0,231,0,0,0,120,1,0,0,205,0,0,0,36,0,0,0, +61,0,4,0,6,0,0,0,121,1,0,0,120,1,0,0,186,0,5,0,62,0,0,0, +122,1,0,0,121,1,0,0,210,0,0,0,249,0,2,0,119,1,0,0,248,0,2,0, +119,1,0,0,245,0,7,0,62,0,0,0,123,1,0,0,117,1,0,0,94,1,0,0, +122,1,0,0,118,1,0,0,247,0,3,0,125,1,0,0,0,0,0,0,250,0,4,0, +123,1,0,0,124,1,0,0,125,1,0,0,248,0,2,0,124,1,0,0,61,0,4,0, +202,0,0,0,127,1,0,0,204,0,0,0,81,0,5,0,6,0,0,0,128,1,0,0, +127,1,0,0,0,0,0,0,81,0,5,0,6,0,0,0,129,1,0,0,127,1,0,0, +1,0,0,0,81,0,5,0,6,0,0,0,130,1,0,0,127,1,0,0,2,0,0,0, +80,0,7,0,7,0,0,0,131,1,0,0,128,1,0,0,129,1,0,0,130,1,0,0, +215,0,0,0,62,0,3,0,132,1,0,0,131,1,0,0,65,0,6,0,8,0,0,0, +134,1,0,0,48,0,0,0,56,0,0,0,56,0,0,0,61,0,4,0,7,0,0,0, +135,1,0,0,134,1,0,0,62,0,3,0,133,1,0,0,135,1,0,0,65,0,6,0, +8,0,0,0,137,1,0,0,48,0,0,0,56,0,0,0,85,0,0,0,61,0,4,0, +7,0,0,0,138,1,0,0,137,1,0,0,62,0,3,0,136,1,0,0,138,1,0,0, +65,0,6,0,8,0,0,0,140,1,0,0,48,0,0,0,56,0,0,0,88,0,0,0, +61,0,4,0,7,0,0,0,141,1,0,0,140,1,0,0,62,0,3,0,139,1,0,0, +141,1,0,0,65,0,6,0,8,0,0,0,143,1,0,0,48,0,0,0,56,0,0,0, +91,0,0,0,61,0,4,0,7,0,0,0,144,1,0,0,143,1,0,0,62,0,3,0, +142,1,0,0,144,1,0,0,57,0,9,0,7,0,0,0,145,1,0,0,15,0,0,0, +132,1,0,0,133,1,0,0,136,1,0,0,139,1,0,0,142,1,0,0,79,0,8,0, +202,0,0,0,146,1,0,0,145,1,0,0,145,1,0,0,0,0,0,0,1,0,0,0, +2,0,0,0,62,0,3,0,126,1,0,0,146,1,0,0,61,0,4,0,202,0,0,0, +148,1,0,0,126,1,0,0,12,0,6,0,6,0,0,0,149,1,0,0,1,0,0,0, +66,0,0,0,148,1,0,0,62,0,3,0,147,1,0,0,149,1,0,0,61,0,4,0, +6,0,0,0,150,1,0,0,147,1,0,0,186,0,5,0,62,0,0,0,152,1,0,0, +150,1,0,0,151,1,0,0,247,0,3,0,154,1,0,0,0,0,0,0,250,0,4,0, +152,1,0,0,153,1,0,0,154,1,0,0,248,0,2,0,153,1,0,0,61,0,4,0, +6,0,0,0,155,1,0,0,147,1,0,0,61,0,4,0,202,0,0,0,156,1,0,0, +126,1,0,0,80,0,6,0,202,0,0,0,157,1,0,0,155,1,0,0,155,1,0,0, +155,1,0,0,136,0,5,0,202,0,0,0,158,1,0,0,156,1,0,0,157,1,0,0, +62,0,3,0,126,1,0,0,158,1,0,0,249,0,2,0,154,1,0,0,248,0,2,0, +154,1,0,0,61,0,4,0,202,0,0,0,160,1,0,0,126,1,0,0,65,0,5,0, +8,0,0,0,161,1,0,0,48,0,0,0,111,0,0,0,61,0,4,0,7,0,0,0, +162,1,0,0,161,1,0,0,79,0,8,0,202,0,0,0,163,1,0,0,162,1,0,0, +162,1,0,0,0,0,0,0,1,0,0,0,2,0,0,0,148,0,5,0,6,0,0,0, +164,1,0,0,160,1,0,0,163,1,0,0,12,0,7,0,6,0,0,0,165,1,0,0, +1,0,0,0,40,0,0,0,215,0,0,0,164,1,0,0,62,0,3,0,159,1,0,0, +165,1,0,0,65,0,5,0,8,0,0,0,166,1,0,0,48,0,0,0,108,0,0,0, +61,0,4,0,7,0,0,0,167,1,0,0,166,1,0,0,79,0,8,0,202,0,0,0, +168,1,0,0,167,1,0,0,167,1,0,0,0,0,0,0,1,0,0,0,2,0,0,0, +65,0,5,0,8,0,0,0,169,1,0,0,48,0,0,0,91,0,0,0,61,0,4,0, +7,0,0,0,170,1,0,0,169,1,0,0,79,0,8,0,202,0,0,0,171,1,0,0, +170,1,0,0,170,1,0,0,0,0,0,0,1,0,0,0,2,0,0,0,65,0,5,0, +8,0,0,0,172,1,0,0,48,0,0,0,114,0,0,0,61,0,4,0,7,0,0,0, +173,1,0,0,172,1,0,0,79,0,8,0,202,0,0,0,174,1,0,0,173,1,0,0, +173,1,0,0,0,0,0,0,1,0,0,0,2,0,0,0,133,0,5,0,202,0,0,0, +175,1,0,0,171,1,0,0,174,1,0,0,129,0,5,0,202,0,0,0,176,1,0,0, +168,1,0,0,175,1,0,0,61,0,4,0,7,0,0,0,177,1,0,0,88,1,0,0, +79,0,8,0,202,0,0,0,178,1,0,0,177,1,0,0,177,1,0,0,0,0,0,0, +1,0,0,0,2,0,0,0,65,0,5,0,8,0,0,0,179,1,0,0,48,0,0,0, +117,0,0,0,61,0,4,0,7,0,0,0,180,1,0,0,179,1,0,0,79,0,8,0, +202,0,0,0,181,1,0,0,180,1,0,0,180,1,0,0,0,0,0,0,1,0,0,0, +2,0,0,0,133,0,5,0,202,0,0,0,182,1,0,0,178,1,0,0,181,1,0,0, +61,0,4,0,6,0,0,0,183,1,0,0,159,1,0,0,142,0,5,0,202,0,0,0, +184,1,0,0,182,1,0,0,183,1,0,0,129,0,5,0,202,0,0,0,185,1,0,0, +176,1,0,0,184,1,0,0,80,0,6,0,202,0,0,0,186,1,0,0,215,0,0,0, +215,0,0,0,215,0,0,0,80,0,6,0,202,0,0,0,187,1,0,0,80,1,0,0, +80,1,0,0,80,1,0,0,12,0,8,0,202,0,0,0,188,1,0,0,1,0,0,0, +43,0,0,0,185,1,0,0,186,1,0,0,187,1,0,0,65,0,5,0,19,0,0,0, +189,1,0,0,88,1,0,0,18,0,0,0,81,0,5,0,6,0,0,0,190,1,0,0, +188,1,0,0,0,0,0,0,62,0,3,0,189,1,0,0,190,1,0,0,65,0,5,0, +19,0,0,0,191,1,0,0,88,1,0,0,24,0,0,0,81,0,5,0,6,0,0,0, +192,1,0,0,188,1,0,0,1,0,0,0,62,0,3,0,191,1,0,0,192,1,0,0, +65,0,5,0,19,0,0,0,193,1,0,0,88,1,0,0,30,0,0,0,81,0,5,0, +6,0,0,0,194,1,0,0,188,1,0,0,2,0,0,0,62,0,3,0,193,1,0,0, +194,1,0,0,249,0,2,0,125,1,0,0,248,0,2,0,125,1,0,0,65,0,6,0, +19,0,0,0,195,1,0,0,48,0,0,0,57,0,0,0,30,0,0,0,61,0,4,0, +6,0,0,0,196,1,0,0,195,1,0,0,186,0,5,0,62,0,0,0,197,1,0,0, +196,1,0,0,210,0,0,0,247,0,3,0,199,1,0,0,0,0,0,0,250,0,4,0, +197,1,0,0,198,1,0,0,199,1,0,0,248,0,2,0,198,1,0,0,65,0,5,0, +19,0,0,0,200,1,0,0,86,1,0,0,36,0,0,0,61,0,4,0,6,0,0,0, +201,1,0,0,200,1,0,0,186,0,5,0,62,0,0,0,202,1,0,0,201,1,0,0, +215,0,0,0,249,0,2,0,199,1,0,0,248,0,2,0,199,1,0,0,245,0,7,0, +62,0,0,0,203,1,0,0,197,1,0,0,125,1,0,0,202,1,0,0,198,1,0,0, +247,0,3,0,205,1,0,0,0,0,0,0,250,0,4,0,203,1,0,0,204,1,0,0, +205,1,0,0,248,0,2,0,204,1,0,0,65,0,6,0,19,0,0,0,207,1,0,0, +48,0,0,0,57,0,0,0,30,0,0,0,61,0,4,0,6,0,0,0,208,1,0,0, +207,1,0,0,186,0,5,0,62,0,0,0,209,1,0,0,208,1,0,0,61,0,0,0, +247,0,3,0,212,1,0,0,0,0,0,0,250,0,4,0,209,1,0,0,211,1,0,0, +222,1,0,0,248,0,2,0,211,1,0,0,65,0,5,0,19,0,0,0,213,1,0,0, +86,1,0,0,36,0,0,0,61,0,4,0,6,0,0,0,214,1,0,0,213,1,0,0, +65,0,6,0,19,0,0,0,215,1,0,0,48,0,0,0,123,0,0,0,18,0,0,0, +61,0,4,0,6,0,0,0,216,1,0,0,215,1,0,0,133,0,5,0,6,0,0,0, +217,1,0,0,214,1,0,0,216,1,0,0,12,0,8,0,6,0,0,0,219,1,0,0, +1,0,0,0,43,0,0,0,217,1,0,0,215,0,0,0,218,1,0,0,127,0,4,0, +6,0,0,0,220,1,0,0,219,1,0,0,12,0,6,0,6,0,0,0,221,1,0,0, +1,0,0,0,27,0,0,0,220,1,0,0,62,0,3,0,210,1,0,0,221,1,0,0, +249,0,2,0,212,1,0,0,248,0,2,0,222,1,0,0,65,0,6,0,19,0,0,0, +223,1,0,0,48,0,0,0,123,0,0,0,30,0,0,0,61,0,4,0,6,0,0,0, +224,1,0,0,223,1,0,0,65,0,5,0,19,0,0,0,225,1,0,0,86,1,0,0, +36,0,0,0,61,0,4,0,6,0,0,0,226,1,0,0,225,1,0,0,131,0,5,0, +6,0,0,0,227,1,0,0,224,1,0,0,226,1,0,0,65,0,6,0,19,0,0,0, +228,1,0,0,48,0,0,0,123,0,0,0,30,0,0,0,61,0,4,0,6,0,0,0, +229,1,0,0,228,1,0,0,65,0,6,0,19,0,0,0,230,1,0,0,48,0,0,0, +123,0,0,0,24,0,0,0,61,0,4,0,6,0,0,0,231,1,0,0,230,1,0,0, +131,0,5,0,6,0,0,0,232,1,0,0,229,1,0,0,231,1,0,0,136,0,5,0, +6,0,0,0,233,1,0,0,227,1,0,0,232,1,0,0,12,0,8,0,6,0,0,0, +234,1,0,0,1,0,0,0,43,0,0,0,233,1,0,0,215,0,0,0,80,1,0,0, +62,0,3,0,210,1,0,0,234,1,0,0,249,0,2,0,212,1,0,0,248,0,2,0, +212,1,0,0,61,0,4,0,6,0,0,0,235,1,0,0,210,1,0,0,62,0,3,0, +206,1,0,0,235,1,0,0,65,0,5,0,8,0,0,0,236,1,0,0,48,0,0,0, +120,0,0,0,61,0,4,0,7,0,0,0,237,1,0,0,236,1,0,0,79,0,8,0, +202,0,0,0,238,1,0,0,237,1,0,0,237,1,0,0,0,0,0,0,1,0,0,0, +2,0,0,0,61,0,4,0,7,0,0,0,239,1,0,0,88,1,0,0,79,0,8,0, +202,0,0,0,240,1,0,0,239,1,0,0,239,1,0,0,0,0,0,0,1,0,0,0, +2,0,0,0,61,0,4,0,6,0,0,0,241,1,0,0,206,1,0,0,80,0,6,0, +202,0,0,0,242,1,0,0,241,1,0,0,241,1,0,0,241,1,0,0,12,0,8,0, +202,0,0,0,243,1,0,0,1,0,0,0,46,0,0,0,238,1,0,0,240,1,0,0, +242,1,0,0,65,0,5,0,19,0,0,0,244,1,0,0,88,1,0,0,18,0,0,0, +81,0,5,0,6,0,0,0,245,1,0,0,243,1,0,0,0,0,0,0,62,0,3,0, +244,1,0,0,245,1,0,0,65,0,5,0,19,0,0,0,246,1,0,0,88,1,0,0, +24,0,0,0,81,0,5,0,6,0,0,0,247,1,0,0,243,1,0,0,1,0,0,0, +62,0,3,0,246,1,0,0,247,1,0,0,65,0,5,0,19,0,0,0,248,1,0,0, +88,1,0,0,30,0,0,0,81,0,5,0,6,0,0,0,249,1,0,0,243,1,0,0, +2,0,0,0,62,0,3,0,248,1,0,0,249,1,0,0,249,0,2,0,205,1,0,0, +248,0,2,0,205,1,0,0,65,0,6,0,19,0,0,0,250,1,0,0,48,0,0,0, +57,0,0,0,36,0,0,0,61,0,4,0,6,0,0,0,251,1,0,0,250,1,0,0, +186,0,5,0,62,0,0,0,252,1,0,0,251,1,0,0,210,0,0,0,247,0,3,0, +254,1,0,0,0,0,0,0,250,0,4,0,252,1,0,0,253,1,0,0,254,1,0,0, +248,0,2,0,253,1,0,0,65,0,5,0,19,0,0,0,255,1,0,0,86,1,0,0, +30,0,0,0,62,0,3,0,255,1,0,0,215,0,0,0,249,0,2,0,254,1,0,0, +248,0,2,0,254,1,0,0,249,0,2,0,95,1,0,0,248,0,2,0,95,1,0,0, +61,0,4,0,7,0,0,0,4,2,0,0,86,1,0,0,65,0,5,0,5,2,0,0, +6,2,0,0,3,2,0,0,56,0,0,0,62,0,3,0,6,2,0,0,4,2,0,0, +61,0,4,0,7,0,0,0,8,2,0,0,88,1,0,0,62,0,3,0,7,2,0,0, +8,2,0,0,61,0,4,0,9,2,0,0,14,2,0,0,13,2,0,0,62,0,3,0, +11,2,0,0,14,2,0,0,253,0,1,0,56,0,1,0,54,0,5,0,7,0,0,0, +15,0,0,0,0,0,0,0,9,0,0,0,55,0,3,0,8,0,0,0,10,0,0,0, +55,0,3,0,8,0,0,0,11,0,0,0,55,0,3,0,8,0,0,0,12,0,0,0, +55,0,3,0,8,0,0,0,13,0,0,0,55,0,3,0,8,0,0,0,14,0,0,0, +248,0,2,0,16,0,0,0,65,0,5,0,19,0,0,0,20,0,0,0,10,0,0,0, +18,0,0,0,61,0,4,0,6,0,0,0,21,0,0,0,20,0,0,0,61,0,4,0, +7,0,0,0,22,0,0,0,11,0,0,0,142,0,5,0,7,0,0,0,23,0,0,0, +22,0,0,0,21,0,0,0,65,0,5,0,19,0,0,0,25,0,0,0,10,0,0,0, +24,0,0,0,61,0,4,0,6,0,0,0,26,0,0,0,25,0,0,0,61,0,4,0, +7,0,0,0,27,0,0,0,12,0,0,0,142,0,5,0,7,0,0,0,28,0,0,0, +27,0,0,0,26,0,0,0,129,0,5,0,7,0,0,0,29,0,0,0,23,0,0,0, +28,0,0,0,65,0,5,0,19,0,0,0,31,0,0,0,10,0,0,0,30,0,0,0, +61,0,4,0,6,0,0,0,32,0,0,0,31,0,0,0,61,0,4,0,7,0,0,0, +33,0,0,0,13,0,0,0,142,0,5,0,7,0,0,0,34,0,0,0,33,0,0,0, +32,0,0,0,129,0,5,0,7,0,0,0,35,0,0,0,29,0,0,0,34,0,0,0, +65,0,5,0,19,0,0,0,37,0,0,0,10,0,0,0,36,0,0,0,61,0,4,0, +6,0,0,0,38,0,0,0,37,0,0,0,61,0,4,0,7,0,0,0,39,0,0,0, +14,0,0,0,142,0,5,0,7,0,0,0,40,0,0,0,39,0,0,0,38,0,0,0, +129,0,5,0,7,0,0,0,41,0,0,0,35,0,0,0,40,0,0,0,254,0,2,0, +41,0,0,0,56,0,1,0, +}; +alignas(4) inline constexpr unsigned char scene_frag_spv[] = { +3,2,35,7,0,0,1,0,11,0,13,0,62,0,0,0,0,0,0,0,17,0,2,0, +1,0,0,0,11,0,6,0,1,0,0,0,71,76,83,76,46,115,116,100,46,52,53,48, +0,0,0,0,14,0,3,0,0,0,0,0,1,0,0,0,15,0,8,0,4,0,0,0, +4,0,0,0,109,97,105,110,0,0,0,0,17,0,0,0,21,0,0,0,60,0,0,0, +16,0,3,0,4,0,0,0,7,0,0,0,3,0,3,0,2,0,0,0,194,1,0,0, +4,0,10,0,71,76,95,71,79,79,71,76,69,95,99,112,112,95,115,116,121,108,101,95, +108,105,110,101,95,100,105,114,101,99,116,105,118,101,0,0,4,0,8,0,71,76,95,71, +79,79,71,76,69,95,105,110,99,108,117,100,101,95,100,105,114,101,99,116,105,118,101,0, +5,0,4,0,4,0,0,0,109,97,105,110,0,0,0,0,5,0,3,0,9,0,0,0, +99,0,0,0,5,0,4,0,13,0,0,0,105,109,97,103,101,0,0,0,5,0,3,0, +17,0,0,0,118,117,118,0,5,0,4,0,21,0,0,0,118,99,111,108,111,114,0,0, +5,0,5,0,25,0,0,0,77,97,116,101,114,105,97,108,0,0,0,0,6,0,5,0, +25,0,0,0,0,0,0,0,112,97,114,97,109,115,0,0,5,0,3,0,27,0,0,0, +0,0,0,0,5,0,4,0,60,0,0,0,114,101,115,117,108,116,0,0,71,0,4,0, +13,0,0,0,33,0,0,0,0,0,0,0,71,0,4,0,13,0,0,0,34,0,0,0, +2,0,0,0,71,0,4,0,17,0,0,0,30,0,0,0,1,0,0,0,71,0,4,0, +21,0,0,0,30,0,0,0,0,0,0,0,71,0,3,0,25,0,0,0,2,0,0,0, +72,0,5,0,25,0,0,0,0,0,0,0,35,0,0,0,0,0,0,0,71,0,4,0, +27,0,0,0,33,0,0,0,0,0,0,0,71,0,4,0,27,0,0,0,34,0,0,0, +3,0,0,0,71,0,4,0,60,0,0,0,30,0,0,0,0,0,0,0,19,0,2,0, +2,0,0,0,33,0,3,0,3,0,0,0,2,0,0,0,22,0,3,0,6,0,0,0, +32,0,0,0,23,0,4,0,7,0,0,0,6,0,0,0,4,0,0,0,32,0,4,0, +8,0,0,0,7,0,0,0,7,0,0,0,25,0,9,0,10,0,0,0,6,0,0,0, +1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0, +27,0,3,0,11,0,0,0,10,0,0,0,32,0,4,0,12,0,0,0,0,0,0,0, +11,0,0,0,59,0,4,0,12,0,0,0,13,0,0,0,0,0,0,0,23,0,4,0, +15,0,0,0,6,0,0,0,2,0,0,0,32,0,4,0,16,0,0,0,1,0,0,0, +15,0,0,0,59,0,4,0,16,0,0,0,17,0,0,0,1,0,0,0,32,0,4,0, +20,0,0,0,1,0,0,0,7,0,0,0,59,0,4,0,20,0,0,0,21,0,0,0, +1,0,0,0,20,0,2,0,24,0,0,0,30,0,3,0,25,0,0,0,7,0,0,0, +32,0,4,0,26,0,0,0,2,0,0,0,25,0,0,0,59,0,4,0,26,0,0,0, +27,0,0,0,2,0,0,0,21,0,4,0,28,0,0,0,32,0,0,0,1,0,0,0, +43,0,4,0,28,0,0,0,29,0,0,0,0,0,0,0,21,0,4,0,30,0,0,0, +32,0,0,0,0,0,0,0,43,0,4,0,30,0,0,0,31,0,0,0,0,0,0,0, +32,0,4,0,32,0,0,0,2,0,0,0,6,0,0,0,43,0,4,0,6,0,0,0, +35,0,0,0,0,0,0,0,43,0,4,0,30,0,0,0,39,0,0,0,3,0,0,0, +32,0,4,0,40,0,0,0,7,0,0,0,6,0,0,0,43,0,4,0,30,0,0,0, +50,0,0,0,1,0,0,0,43,0,4,0,6,0,0,0,53,0,0,0,0,0,0,63, +43,0,4,0,6,0,0,0,57,0,0,0,0,0,128,63,32,0,4,0,59,0,0,0, +3,0,0,0,7,0,0,0,59,0,4,0,59,0,0,0,60,0,0,0,3,0,0,0, +54,0,5,0,2,0,0,0,4,0,0,0,0,0,0,0,3,0,0,0,248,0,2,0, +5,0,0,0,59,0,4,0,8,0,0,0,9,0,0,0,7,0,0,0,61,0,4,0, +11,0,0,0,14,0,0,0,13,0,0,0,61,0,4,0,15,0,0,0,18,0,0,0, +17,0,0,0,87,0,5,0,7,0,0,0,19,0,0,0,14,0,0,0,18,0,0,0, +61,0,4,0,7,0,0,0,22,0,0,0,21,0,0,0,133,0,5,0,7,0,0,0, +23,0,0,0,19,0,0,0,22,0,0,0,62,0,3,0,9,0,0,0,23,0,0,0, +65,0,6,0,32,0,0,0,33,0,0,0,27,0,0,0,29,0,0,0,31,0,0,0, +61,0,4,0,6,0,0,0,34,0,0,0,33,0,0,0,190,0,5,0,24,0,0,0, +36,0,0,0,34,0,0,0,35,0,0,0,247,0,3,0,38,0,0,0,0,0,0,0, +250,0,4,0,36,0,0,0,37,0,0,0,38,0,0,0,248,0,2,0,37,0,0,0, +65,0,5,0,40,0,0,0,41,0,0,0,9,0,0,0,39,0,0,0,61,0,4,0, +6,0,0,0,42,0,0,0,41,0,0,0,65,0,6,0,32,0,0,0,43,0,0,0, +27,0,0,0,29,0,0,0,31,0,0,0,61,0,4,0,6,0,0,0,44,0,0,0, +43,0,0,0,188,0,5,0,24,0,0,0,45,0,0,0,42,0,0,0,44,0,0,0, +249,0,2,0,38,0,0,0,248,0,2,0,38,0,0,0,245,0,7,0,24,0,0,0, +46,0,0,0,36,0,0,0,5,0,0,0,45,0,0,0,37,0,0,0,247,0,3,0, +48,0,0,0,0,0,0,0,250,0,4,0,46,0,0,0,47,0,0,0,48,0,0,0, +248,0,2,0,47,0,0,0,252,0,1,0,248,0,2,0,48,0,0,0,65,0,6,0, +32,0,0,0,51,0,0,0,27,0,0,0,29,0,0,0,50,0,0,0,61,0,4,0, +6,0,0,0,52,0,0,0,51,0,0,0,186,0,5,0,24,0,0,0,54,0,0,0, +52,0,0,0,53,0,0,0,247,0,3,0,56,0,0,0,0,0,0,0,250,0,4,0, +54,0,0,0,55,0,0,0,56,0,0,0,248,0,2,0,55,0,0,0,65,0,5,0, +40,0,0,0,58,0,0,0,9,0,0,0,39,0,0,0,62,0,3,0,58,0,0,0, +57,0,0,0,249,0,2,0,56,0,0,0,248,0,2,0,56,0,0,0,61,0,4,0, +7,0,0,0,61,0,0,0,9,0,0,0,62,0,3,0,60,0,0,0,61,0,0,0, +253,0,1,0,56,0,1,0, +}; diff --git a/src/eter_render/shaders/scene.frag b/src/eter_render/shaders/scene.frag new file mode 100644 index 00000000..3d9e24dc --- /dev/null +++ b/src/eter_render/shaders/scene.frag @@ -0,0 +1,7 @@ +#version 450 +layout(set=2,binding=0) uniform sampler2D image; +layout(set=3,binding=0) uniform Material { vec4 params; }; +layout(location=0) in vec4 vcolor; +layout(location=1) in vec2 vuv; +layout(location=0) out vec4 result; +void main(){ vec4 c=texture(image,vuv)*vcolor; if(params.x>=0.0 && c.a<=params.x) discard; if(params.y>0.5) c.a=1.0; result=c; } diff --git a/src/eter_render/shaders/scene.vert b/src/eter_render/shaders/scene.vert new file mode 100644 index 00000000..474af97e --- /dev/null +++ b/src/eter_render/shaders/scene.vert @@ -0,0 +1,50 @@ +#version 450 +layout(location=0) in vec4 position; +layout(location=1) in vec4 color; +layout(location=2) in vec2 uv; +layout(location=3) in vec4 normal; +layout(location=4) in uvec4 bones; +layout(location=5) in vec4 weights; +struct Transform { + vec4 world[4]; vec4 mvp[4]; + vec4 diffuse; vec4 ambient; vec4 emissive; + vec4 lightDirection; vec4 lightAmbient; vec4 lightDiffuse; + vec4 fogColor; vec4 fogParams; vec4 modes; vec4 skin; +}; +layout(set=1,binding=0,std140) uniform Header { Transform header; }; +layout(set=1,binding=1,std140) uniform Palette { vec4 palette[512]; }; +layout(set=0,binding=0,std140) readonly buffer Instances { Transform instances[]; }; +layout(location=0) out vec4 vcolor; +layout(location=1) out vec2 vuv; +vec4 transformRows(vec4 p, vec4 a,vec4 b,vec4 c,vec4 d){return p.x*a+p.y*b+p.z*c+p.w*d;} +void main(){ + Transform t=header.modes.x>1.5 ? instances[gl_InstanceIndex] : header; + vec4 p=position; vec3 n=normal.xyz; + if(t.skin.x>0.5){ + vec4 skinned=vec4(0); vec3 sn=vec3(0); float total=0; + for(int i=0;i<4;++i) if(weights[i]>0 && bones[i]0.0001){p=vec4(skinned.xyz,1);n=sn;} + } + vec4 clip=p; vec4 c=color; + if(t.modes.x>0.5){ + clip=transformRows(p,t.mvp[0],t.mvp[1],t.mvp[2],t.mvp[3]); + c*=t.diffuse; + if(t.modes.y>0.5 && normal.w>0.5){ + vec3 wn=transformRows(vec4(n,0),t.world[0],t.world[1],t.world[2],t.world[3]).xyz; + float len=length(wn);if(len>0.00001)wn/=len; + float ndotl=max(0,dot(wn,t.lightDirection.xyz)); + c.rgb=clamp(t.emissive.rgb+t.ambient.rgb*t.lightAmbient.rgb+c.rgb*t.lightDiffuse.rgb*ndotl,0,1); + } + if(t.modes.z>0.5 && clip.w>0){ + float f=t.modes.z>1.5 ? exp(-clamp(clip.w*t.fogParams.x,0,10)) : clamp((t.fogParams.z-clip.w)/(t.fogParams.z-t.fogParams.y),0,1); + c.rgb=mix(t.fogColor.rgb,c.rgb,f); + } + if(t.modes.w>0.5)clip.z=0; + } + gl_Position=clip;vcolor=c;vuv=uv; +} diff --git a/src/eter_resource/ResourceManager.h b/src/eter_resource/ResourceManager.h index f819479c..c235d483 100644 --- a/src/eter_resource/ResourceManager.h +++ b/src/eter_resource/ResourceManager.h @@ -120,9 +120,13 @@ public: if(!s_resourceRoot.empty()) { auto relative=candidates; candidates.clear(); - for(const auto& candidate:relative) { + std::vector roots{s_resourceRoot}; + if (s_resourceRoot.filename() == "root") roots.push_back(s_resourceRoot.parent_path()); + if (s_resourceRoot.filename() == "python-root") roots.push_back(s_resourceRoot.parent_path().parent_path()); + for (const auto& root : roots) for (const auto& candidate : relative) { std::filesystem::path rel(candidate); - if(!rel.is_absolute()&&candidate.find(':')==std::string::npos) candidates.push_back((s_resourceRoot/rel).string()); + if (!rel.is_absolute() && candidate.find(':') == std::string::npos) + candidates.push_back((root / rel).string()); } candidates.insert(candidates.end(),relative.begin(),relative.end()); } diff --git a/src/eter_sound/SoundManager.cpp b/src/eter_sound/SoundManager.cpp index d35d6e86..818771b3 100644 --- a/src/eter_sound/SoundManager.cpp +++ b/src/eter_sound/SoundManager.cpp @@ -136,11 +136,11 @@ std::string SoundManager::ResolveAudioPath(const std::string& filename) const { "sound/" + clean, "bgm/" + clean, "BGM/" + clean, - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/Sound/" + clean, - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/BGM/" + clean, - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/ETC/" + clean, - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/Sound/sound/" + clean, - "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/BGM/bgm/" + clean, + "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/Sound/" + clean, + "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/BGM/" + clean, + "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/ETC/" + clean, + "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/Sound/sound/" + clean, + "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/BGM/bgm/" + clean, "build/dev/" + clean }; diff --git a/src/eter_ui/Font.cpp b/src/eter_ui/Font.cpp new file mode 100644 index 00000000..b88b1a87 --- /dev/null +++ b/src/eter_ui/Font.cpp @@ -0,0 +1,192 @@ +#include "Font.h" +#include +#include +#include +#include +#include +#include +#include +#ifdef AVA2_HAS_FREETYPE +#include +#include FT_FREETYPE_H +#endif + +namespace UI { +namespace { +std::vector Codepoints(const std::string& text) { + std::vector out; + for (size_t i = 0; i < text.size();) { + unsigned c = static_cast(text[i++]); + int n = c >= 0xf0 && c <= 0xf4 ? 3 : c >= 0xe0 && c < 0xf0 ? 2 : c >= 0xc2 && c < 0xe0 ? 1 : 0; + unsigned value = n ? c & ((1u << (6 - n)) - 1) : c; + size_t end = i; + for (int j = 0; j < n && end < text.size() && (static_cast(text[end]) & 0xc0) == 0x80; ++j) + value = (value << 6) | (static_cast(text[end++]) & 0x3f); + if (end - i == static_cast(n)) { i = end; c = value; } + // Some legacy labels include a trailing NUL; SDL's debug font hid it. + if (c >= 32 && c != 127) out.push_back(c); + } + return out; +} +#ifdef AVA2_HAS_FREETYPE +struct Glyph { + int width = 0, height = 0, left = 0, top = 0; + float advance = 0; + std::vector alpha; +}; +struct FontCache { + FT_Library library = nullptr; + FT_Face face = nullptr; + std::map, Glyph> glyphs; + FontCache() { + if (FT_Init_FreeType(&library)) return; + // User-supplied / packaged fonts take precedence over platform fonts. + std::vector paths; + if (const char* path = std::getenv("AVA2_UI_FONT")) paths.emplace_back(path); + paths.insert(paths.end(), {"fonts/Arial.ttf", "fonts/DejaVuSans.ttf", + "/System/Library/Fonts/Supplemental/Arial.ttf", "C:/Windows/Fonts/arial.ttf", + "/system/fonts/Roboto-Regular.ttf", "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf"}); + for (const auto& path : paths) + if (!FT_New_Face(library, path.c_str(), 0, &face)) break; + } + ~FontCache() { if (face) FT_Done_Face(face); if (library) FT_Done_FreeType(library); } + const Glyph& Get(int size, unsigned code) { + auto key = std::make_pair(size, code); + auto it = glyphs.find(key); + if (it != glyphs.end()) return it->second; + Glyph g; + // Rasterize at 2x; SDL downsamples to logical size and keeps Retina text sharp. + FT_Set_Pixel_Sizes(face, 0, size * 2); + if (!FT_Load_Char(face, code, FT_LOAD_RENDER)) { + const auto& b = face->glyph->bitmap; + g.width = b.width; g.height = b.rows; + g.left = face->glyph->bitmap_left; g.top = face->glyph->bitmap_top; + g.advance = face->glyph->advance.x / 128.0f; + g.alpha.resize(g.width * g.height); + for (int y = 0; y < g.height; ++y) + std::copy_n(b.buffer + y * b.pitch, g.width, g.alpha.data() + y * g.width); + } + return glyphs.emplace(key, std::move(g)).first->second; + } +}; +FontCache& Cache() { static FontCache cache; return cache; } + +// Cache white text masks, then tint at draw time. Destroying a texture after every +// label forces SDL to flush its pending GPU batch, including the entire 3D scene. +struct TextTexture { + SDL_Texture* texture = nullptr; + int width = 0, height = 0; + size_t bytes = 0; + std::list::iterator recent; +}; +struct TextTextures { + std::unordered_map entries; + std::list recent; + size_t bytes = 0; +}; +constexpr const char* TEXT_CACHE_PROPERTY = "ava2.font.textures"; +TextTextures& TextureCache(SDL_Renderer* renderer) { + auto props = SDL_GetRendererProperties(renderer); + auto* cache = static_cast(SDL_GetPointerProperty(props, TEXT_CACHE_PROPERTY, nullptr)); + if (!cache) { + cache = new TextTextures; + // SDL owns renderer textures and destroys them with the renderer. This + // callback only releases metadata, so renderer teardown cannot double-free. + SDL_SetPointerPropertyWithCleanup(props, TEXT_CACHE_PROPERTY, cache, + [](void*, void* value) { delete static_cast(value); }, nullptr); + } + return *cache; +} +#endif +} + +int TextFontSize(const std::string& name) { + const auto colon = name.find(':'); + const int size = colon == std::string::npos ? 12 : std::atoi(name.c_str() + colon + 1); + return std::clamp(size, 8, 48); +} + +float MeasureText(const std::string& text, int size) { + float width = 0; + for (unsigned code : Codepoints(text)) { +#ifdef AVA2_HAS_FREETYPE + if (Cache().face) { width += Cache().Get(size, code).advance; continue; } +#endif + width += size * 0.5f; + } + return width; +} + +void DrawText(SDL_Renderer* renderer, const std::string& text, int size, float x, float y, Uint32 color) { + if (!renderer || text.empty()) return; +#ifdef AVA2_HAS_FREETYPE + if (Cache().face) { + auto& cache = TextureCache(renderer); + const std::string key = std::to_string(size) + ":" + text; + auto found = cache.entries.find(key); + if (found != cache.entries.end()) { + cache.recent.splice(cache.recent.begin(), cache.recent, found->second.recent); + auto& item = found->second; + SDL_SetTextureColorMod(item.texture, (color >> 16) & 255, (color >> 8) & 255, color & 255); + SDL_SetTextureAlphaMod(item.texture, color >> 24); + SDL_FRect dest{x, y, item.width / 2.0f, item.height / 2.0f}; + SDL_RenderTexture(renderer, item.texture, nullptr, &dest); + return; + } + const int width = std::max(1, int(std::ceil(MeasureText(text, size) * 2)) + size * 2); + const int height = size * 3; + SDL_Surface* surface = SDL_CreateSurface(width, height, SDL_PIXELFORMAT_ARGB8888); + if (!surface) return; + SDL_FillSurfaceRect(surface, nullptr, 0); + float pen = 0; + for (unsigned code : Codepoints(text)) { + const auto& glyph = Cache().Get(size, code); + const int gx = int(std::round(pen * 2)) + glyph.left; + const int gy = size * 2 - glyph.top; + for (int row = 0; row < glyph.height; ++row) { + const int sy = gy + row; + if (sy < 0 || sy >= height) continue; + auto* pixels = reinterpret_cast(static_cast(surface->pixels) + sy * surface->pitch); + for (int col = 0; col < glyph.width; ++col) { + const int sx = gx + col; + if (sx < 0 || sx >= width) continue; + const unsigned alpha = glyph.alpha[row * glyph.width + col]; + if (alpha) pixels[sx] = (std::max(alpha, pixels[sx] >> 24) << 24) | 0xffffff; + } + } + pen += glyph.advance; + } + SDL_Texture* texture = SDL_CreateTextureFromSurface(renderer, surface); + SDL_DestroySurface(surface); + if (texture) { + SDL_SetTextureBlendMode(texture, SDL_BLENDMODE_BLEND); + SDL_SetTextureScaleMode(texture, SDL_SCALEMODE_LINEAR); + const size_t bytes = size_t(width) * height * 4; + while (!cache.entries.empty() && (cache.entries.size() >= 512 || cache.bytes + bytes > 16 * 1024 * 1024)) { + auto old = cache.entries.find(cache.recent.back()); + cache.bytes -= old->second.bytes; + SDL_DestroyTexture(old->second.texture); + cache.entries.erase(old); + cache.recent.pop_back(); + } + cache.recent.push_front(key); + cache.entries.emplace(key, TextTexture{texture, width, height, bytes, cache.recent.begin()}); + cache.bytes += bytes; + SDL_SetTextureColorMod(texture, (color >> 16) & 255, (color >> 8) & 255, color & 255); + SDL_SetTextureAlphaMod(texture, color >> 24); + SDL_FRect dest{x, y, width / 2.0f, height / 2.0f}; + SDL_RenderTexture(renderer, texture, nullptr, &dest); + } + return; + } +#endif + // Keep fallback glyph advances consistent with MeasureText on SDKs without FreeType. + float sx = 1, sy = 1; + SDL_GetRenderScale(renderer, &sx, &sy); + const float scale = size / 16.0f; + SDL_SetRenderScale(renderer, sx * scale, sy * scale); + SDL_SetRenderDrawColor(renderer, (color >> 16) & 255, (color >> 8) & 255, color & 255, color >> 24); + SDL_RenderDebugText(renderer, x / scale, y / scale, text.c_str()); + SDL_SetRenderScale(renderer, sx, sy); +} +} diff --git a/src/eter_ui/Font.h b/src/eter_ui/Font.h new file mode 100644 index 00000000..d1d3bbcb --- /dev/null +++ b/src/eter_ui/Font.h @@ -0,0 +1,11 @@ +#pragma once +#include +#include + +namespace UI { +// Shared measurement and rendering metrics in logical pixels (independent of Retina scale). +int TextFontSize(const std::string& name); +float MeasureText(const std::string& text, int size); +void DrawText(SDL_Renderer* renderer, const std::string& text, int size, + float x, float y, Uint32 color); +} diff --git a/src/eter_ui/PythonWindow.cpp b/src/eter_ui/PythonWindow.cpp index 740e53b3..e2f024b0 100644 --- a/src/eter_ui/PythonWindow.cpp +++ b/src/eter_ui/PythonWindow.cpp @@ -337,10 +337,24 @@ namespace UI CWindow * CWindow::PickWindow(long x, long y) { + if (!IsShow()) return nullptr; + for (auto it = m_pChildList.rbegin(); it != m_pChildList.rend(); ++it) { - CWindow * pWin = (*it)->PickWindow(x, y); - if (pWin) return pWin; + CWindow * pWin = *it; + if (pWin->IsShow()) + { + if (!pWin->IsFlag(CWindow::FLAG_IGNORE_SIZE)) + { + if (!pWin->IsIn(x, y)) { + if (0L <= pWin->GetWidth()) { + continue; + } + } + } + CWindow * pResult = pWin->PickWindow(x, y); + if (pResult) return pResult; + } } if (IsFlag(FLAG_NOT_PICK)) return nullptr; if (IsIn(x, y)) return this; @@ -406,9 +420,38 @@ namespace UI if (m_poHandler) PyCallClassMemberFunc(m_poHandler, "OnMoveWindow", Py_BuildValue("(ii)", x, y)); } - BOOL CWindow::RunIMETabEvent() { return OnIMETabEvent(); } - BOOL CWindow::RunIMEReturnEvent() { return OnIMEReturnEvent(); } - BOOL CWindow::RunIMEKeyDownEvent(int ikey) { return OnIMEKeyDownEvent(ikey); } + BOOL CWindow::RunIMETabEvent() + { + if (!IsRendering()) return FALSE; + if (OnIMETabEvent()) return TRUE; + for (auto itor = m_pChildList.rbegin(); itor != m_pChildList.rend(); ++itor) + { + if ((*itor)->RunIMETabEvent()) return TRUE; + } + return FALSE; + } + + BOOL CWindow::RunIMEReturnEvent() + { + if (!IsRendering()) return FALSE; + if (OnIMEReturnEvent()) return TRUE; + for (auto itor = m_pChildList.rbegin(); itor != m_pChildList.rend(); ++itor) + { + if ((*itor)->RunIMEReturnEvent()) return TRUE; + } + return FALSE; + } + + BOOL CWindow::RunIMEKeyDownEvent(int ikey) + { + if (!IsRendering()) return FALSE; + if (OnIMEKeyDownEvent(ikey)) return TRUE; + for (auto itor = m_pChildList.rbegin(); itor != m_pChildList.rend(); ++itor) + { + if ((*itor)->RunIMEKeyDownEvent(ikey)) return TRUE; + } + return FALSE; + } CWindow * CWindow::RunKeyDownEvent(int ikey) { @@ -431,17 +474,99 @@ namespace UI return FALSE; } - BOOL CWindow::RunPressEscapeKeyEvent() { return OnPressEscapeKey(); } - BOOL CWindow::RunPressExitKeyEvent() { return OnPressExitKey(); } + BOOL CWindow::RunPressEscapeKeyEvent() + { + for (auto itor = m_pChildList.rbegin(); itor != m_pChildList.rend(); ++itor) + { + CWindow * pWindow = *itor; + if (pWindow->IsShow() && pWindow->RunPressEscapeKeyEvent()) + return TRUE; + } + return OnPressEscapeKey(); + } - BOOL CWindow::OnIMETabEvent() { return FALSE; } - BOOL CWindow::OnIMEReturnEvent() { return FALSE; } - BOOL CWindow::OnIMEKeyDownEvent(int ikey) { return FALSE; } - BOOL CWindow::OnIMEChangeCodePage() { return FALSE; } - BOOL CWindow::OnIMEOpenCandidateListEvent() { return FALSE; } - BOOL CWindow::OnIMECloseCandidateListEvent() { return FALSE; } - BOOL CWindow::OnIMEOpenReadingWndEvent() { return FALSE; } - BOOL CWindow::OnIMECloseReadingWndEvent() { return FALSE; } + BOOL CWindow::RunPressExitKeyEvent() + { + for (auto itor = m_pChildList.rbegin(); itor != m_pChildList.rend(); ++itor) + { + CWindow * pWindow = *itor; + if (pWindow->IsShow() && pWindow->RunPressExitKeyEvent()) + return TRUE; + } + return OnPressExitKey(); + } + + BOOL CWindow::OnIMETabEvent() + { + if (!m_poHandler) return FALSE; + long lValue = 0; + if (PyCallClassMemberFunc(m_poHandler, "OnIMETab", BuildEmptyTuple(), &lValue)) + if (0 != lValue) return TRUE; + return FALSE; + } + + BOOL CWindow::OnIMEReturnEvent() + { + if (!m_poHandler) return FALSE; + long lValue = 0; + if (PyCallClassMemberFunc(m_poHandler, "OnIMEReturn", BuildEmptyTuple(), &lValue)) + if (0 != lValue) return TRUE; + return FALSE; + } + + BOOL CWindow::OnIMEKeyDownEvent(int ikey) + { + if (!m_poHandler) return FALSE; + long lValue = 0; + if (PyCallClassMemberFunc(m_poHandler, "OnIMEKeyDown", Py_BuildValue("(i)", ikey), &lValue)) + if (0 != lValue) return TRUE; + return FALSE; + } + + BOOL CWindow::OnIMEChangeCodePage() + { + if (!m_poHandler) return FALSE; + long lValue = 0; + if (PyCallClassMemberFunc(m_poHandler, "OnIMEChangeCodePage", BuildEmptyTuple(), &lValue)) + if (0 != lValue) return TRUE; + return FALSE; + } + + BOOL CWindow::OnIMEOpenCandidateListEvent() + { + if (!m_poHandler) return FALSE; + long lValue = 0; + if (PyCallClassMemberFunc(m_poHandler, "OnIMEOpenCandidateList", BuildEmptyTuple(), &lValue)) + if (0 != lValue) return TRUE; + return FALSE; + } + + BOOL CWindow::OnIMECloseCandidateListEvent() + { + if (!m_poHandler) return FALSE; + long lValue = 0; + if (PyCallClassMemberFunc(m_poHandler, "OnIMECloseCandidateList", BuildEmptyTuple(), &lValue)) + if (0 != lValue) return TRUE; + return FALSE; + } + + BOOL CWindow::OnIMEOpenReadingWndEvent() + { + if (!m_poHandler) return FALSE; + long lValue = 0; + if (PyCallClassMemberFunc(m_poHandler, "OnIMEOpenReadingWnd", BuildEmptyTuple(), &lValue)) + if (0 != lValue) return TRUE; + return FALSE; + } + + BOOL CWindow::OnIMECloseReadingWndEvent() + { + if (!m_poHandler) return FALSE; + long lValue = 0; + if (PyCallClassMemberFunc(m_poHandler, "OnIMECloseReadingWnd", BuildEmptyTuple(), &lValue)) + if (0 != lValue) return TRUE; + return FALSE; + } BOOL CWindow::OnMouseLeftButtonDown() { @@ -664,9 +789,10 @@ namespace UI if (displayText.empty() && !m_showCursor) return; - const float charWidth = 8.0f; - const float charHeight = 8.0f; - float textWidth = static_cast(displayText.length()) * charWidth; + const int fontSize = TextFontSize(m_font); + const float charWidth = MeasureText("*", fontSize); + const float charHeight = float(fontSize); + float textWidth = MeasureText(displayText, fontSize); float textHeight = charHeight; float startX = m_v2Position.x; @@ -709,29 +835,25 @@ namespace UI } uint8_t a = (m_color >> 24) & 0xff; - uint8_t r = (m_color >> 16) & 0xff; - uint8_t g = (m_color >> 8) & 0xff; - uint8_t b = m_color & 0xff; - if (a == 0 && m_color != 0) a = 255; + if (a == 0) return; if (m_outline && !displayText.empty()) { - SDL_SetRenderDrawColor(renderer, 0, 0, 0, a); - SDL_RenderDebugText(renderer, startX - 1.0f, startY, displayText.c_str()); - SDL_RenderDebugText(renderer, startX + 1.0f, startY, displayText.c_str()); - SDL_RenderDebugText(renderer, startX, startY - 1.0f, displayText.c_str()); - SDL_RenderDebugText(renderer, startX, startY + 1.0f, displayText.c_str()); + const DWORD outline = (m_outlineColor & 0xffffff) | (DWORD(a) << 24); + DrawText(renderer, displayText, fontSize, startX - 1, startY, outline); + DrawText(renderer, displayText, fontSize, startX + 1, startY, outline); + DrawText(renderer, displayText, fontSize, startX, startY - 1, outline); + DrawText(renderer, displayText, fontSize, startX, startY + 1, outline); } if (!displayText.empty()) { - SDL_SetRenderDrawColor(renderer, r, g, b, a); - SDL_RenderDebugText(renderer, startX, startY, displayText.c_str()); + DrawText(renderer, displayText, fontSize, startX, startY, m_color); } if (m_showCursor) { - float cursorX = startX + static_cast(displayText.length()) * charWidth; + float cursorX = startX + textWidth; SDL_SetRenderDrawColor(renderer, 240, 240, 240, 255); SDL_FRect cursorRect{ cursorX + 1.0f, startY, 2.0f, charHeight + 2.0f }; SDL_RenderFillRect(renderer, &cursorRect); @@ -1559,7 +1681,7 @@ namespace UI { if (!m_bEnable) return FALSE; m_isPressed = FALSE; - SetUp(); + Up(); if (m_poHandler) PyCallClassMemberFunc(m_poHandler, "CallEvent", BuildEmptyTuple()); return TRUE; } diff --git a/src/eter_ui/PythonWindow.h b/src/eter_ui/PythonWindow.h index 6e028339..5b4643fe 100644 --- a/src/eter_ui/PythonWindow.h +++ b/src/eter_ui/PythonWindow.h @@ -13,6 +13,7 @@ #include "src/eter_image/GrpExpandedImageInstance.h" #include "src/eter_image/GrpMarkInstance.h" #include "src/eter_resource/ResourceManager.h" +#include "Font.h" namespace UI { @@ -63,8 +64,9 @@ namespace UI void HideCursor() { m_showCursor = false; } int GetCursorPosition() const { return (int)m_text.length(); } void GetTextSize(int* w, int* h) { - if (w) *w = (int)m_text.length() * 6; - if (h) *h = 12; + const int size = TextFontSize(m_font); + if (w) *w = int(std::ceil(MeasureText(m_secret ? std::string(m_text.length(), '*') : m_text, size))); + if (h) *h = size; } void SetOutLineColor(float r, float g, float b, float a) { auto c = [](float v) { return DWORD(std::clamp(v, 0.0f, 1.0f) * 255.0f + 0.5f); }; @@ -72,8 +74,9 @@ namespace UI } int PixelPositionToCharacterPosition(int pixelPos) const { if (pixelPos <= 0) return 0; - int charPos = pixelPos / 6; - return std::min(charPos, (int)m_text.length()); + for (size_t i = 0; i < m_text.size(); ++i) + if (MeasureText(m_text.substr(0, i + 1), TextFontSize(m_font)) > pixelPos) return int(i); + return int(m_text.size()); } void SetPosition(float fx, float fy) { m_v2Position.x = fx; m_v2Position.y = fy; } D3DXVECTOR2 GetPosition() const { return m_v2Position; } diff --git a/src/eter_ui/PythonWindowManager.cpp b/src/eter_ui/PythonWindowManager.cpp index 7e4dc952..bbe6619a 100644 --- a/src/eter_ui/PythonWindowManager.cpp +++ b/src/eter_ui/PythonWindowManager.cpp @@ -368,13 +368,17 @@ namespace UI void CWindowManager::RunMouseLeftButtonDown(long x, long y) { SetMousePosition(x, y); - CWindow * pWin = GetPointWindow(); + CWindow * pWin = __PickWindow(m_lMouseX, m_lMouseY); + + if (!pWin) pWin = GetPointWindow(); if (!pWin) return; + m_pPointWindow = pWin; + if (pWin->IsFlag(CWindow::FLAG_ATTACH)) pWin = pWin->GetRoot(); if (!pWin->IsFlag(CWindow::FLAG_NOT_CAPTURE)) m_pLeftCaptureWindow = pWin; - m_lDragX = m_lMouseX - pWin->GetPositionX(); - m_lDragY = m_lMouseY - pWin->GetPositionY(); + m_lDragX = m_lMouseX - pWin->GetRect().left; + m_lDragY = m_lMouseY - pWin->GetRect().top; pWin->OnMouseLeftButtonDown(); } @@ -383,15 +387,31 @@ namespace UI SetMousePosition(x, y); if (m_pLeftCaptureWindow) { - m_pLeftCaptureWindow->OnMouseLeftButtonUp(); + if (m_pLeftCaptureWindow->OnMouseLeftButtonUp()) + { + m_pLeftCaptureWindow = nullptr; + return; + } m_pLeftCaptureWindow = nullptr; } + + CWindow * pWin = __PickWindow(m_lMouseX, m_lMouseY); + printf("DEBUG RunMouseLeftButtonUp: pos=(%ld, %ld) m_lMouse=(%ld, %ld) picked=%s\n", x, y, m_lMouseX, m_lMouseY, pWin ? pWin->GetName() : "null"); + if (!pWin) pWin = GetPointWindow(); + if (pWin) + { + pWin->OnMouseLeftButtonUp(); + } + + m_pLeftCaptureWindow = nullptr; } void CWindowManager::RunMouseLeftButtonDoubleClick(long x, long y) { SetMousePosition(x, y); - if (m_pPointWindow) m_pPointWindow->OnMouseLeftButtonDoubleClick(); + CWindow * pWin = __PickWindow(m_lMouseX, m_lMouseY); + if (!pWin) pWin = GetPointWindow(); + if (pWin) pWin->OnMouseLeftButtonDoubleClick(); } void CWindowManager::RunMouseRightButtonDown(long x, long y) @@ -501,4 +521,118 @@ namespace UI { if (m_pRootWindow) m_pRootWindow->RunPressExitKeyEvent(); } + + void CWindowManager::RunIMEUpdate() + { + if (m_pLockWindow) + { + m_pLockWindow->OnIMEUpdate(); + return; + } + if (!m_pActiveWindow || !m_pActiveWindow->IsRendering()) + return; + m_pActiveWindow->OnIMEUpdate(); + } + + void CWindowManager::RunIMETabEvent() + { + if (m_pLockWindow) + { + m_pLockWindow->OnIMETabEvent(); + return; + } + if (m_pActiveWindow && m_pActiveWindow->IsRendering()) + { + if (m_pActiveWindow->OnIMETabEvent()) + return; + } + if (m_pRootWindow && !m_pRootWindow->RunIMETabEvent()) + { + if (!m_ActiveWindowList.empty()) + { + CWindow * pWindow = *(m_ActiveWindowList.begin()); + ActivateWindow(pWindow); + + CWindow * pParentWindow = pWindow; + CWindow * pCurrentWindow = pWindow->GetParent(); + + for (DWORD i = 0; i < 20; ++i) + { + if (!pParentWindow) break; + auto it = m_LayerWindowMap.find("GAME"); + if (it != m_LayerWindowMap.end() && pParentWindow == it->second) + { + SetTop(pCurrentWindow); + break; + } + pCurrentWindow = pParentWindow; + pParentWindow = pCurrentWindow->GetParent(); + } + } + } + } + + void CWindowManager::RunIMEReturnEvent() + { + if (m_pLockWindow) + { + m_pLockWindow->OnIMEReturnEvent(); + return; + } + if (m_pActiveWindow && m_pActiveWindow->IsRendering()) + { + if (m_pActiveWindow->OnIMEReturnEvent()) + return; + } + if (m_pRootWindow) + m_pRootWindow->RunIMEReturnEvent(); + } + + void CWindowManager::RunIMEKeyDown(int vkey) + { + if (m_pLockWindow) + { + m_pLockWindow->OnKeyDown(vkey); + return; + } + if (m_pActiveWindow && m_pActiveWindow->IsRendering()) + { + if (m_pActiveWindow->OnIMEKeyDownEvent(vkey)) + return; + } + } + + void CWindowManager::RunChangeCodePage() + { + if (m_pActiveWindow && m_pActiveWindow->IsRendering()) + m_pActiveWindow->OnIMEChangeCodePage(); + } + + void CWindowManager::RunOpenCandidate() + { + if (m_pLockWindow) { m_pLockWindow->OnIMEOpenCandidateListEvent(); return; } + if (m_pActiveWindow && m_pActiveWindow->IsRendering()) + m_pActiveWindow->OnIMEOpenCandidateListEvent(); + } + + void CWindowManager::RunCloseCandidate() + { + if (m_pLockWindow) { m_pLockWindow->OnIMECloseCandidateListEvent(); return; } + if (m_pActiveWindow && m_pActiveWindow->IsRendering()) + m_pActiveWindow->OnIMECloseCandidateListEvent(); + } + + void CWindowManager::RunOpenReading() + { + if (m_pLockWindow) { m_pLockWindow->OnIMEOpenReadingWndEvent(); return; } + if (m_pActiveWindow && m_pActiveWindow->IsRendering()) + m_pActiveWindow->OnIMEOpenReadingWndEvent(); + } + + void CWindowManager::RunCloseReading() + { + if (m_pLockWindow) { m_pLockWindow->OnIMECloseReadingWndEvent(); return; } + if (m_pActiveWindow && m_pActiveWindow->IsRendering()) + m_pActiveWindow->OnIMECloseReadingWndEvent(); + } } diff --git a/src/eter_ui/PythonWindowManager.h b/src/eter_ui/PythonWindowManager.h index 635d9011..3b7419c5 100644 --- a/src/eter_ui/PythonWindowManager.h +++ b/src/eter_ui/PythonWindowManager.h @@ -123,6 +123,15 @@ namespace UI void RunKeyUp(int vkey); void RunPressEscapeKey(); void RunPressExitKey(); + void RunIMEUpdate(); + void RunIMETabEvent(); + void RunIMEReturnEvent(); + void RunIMEKeyDown(int vkey); + void RunChangeCodePage(); + void RunOpenCandidate(); + void RunCloseCandidate(); + void RunOpenReading(); + void RunCloseReading(); private: void SetMousePosition(long x, long y); diff --git a/src/login_client.cpp b/src/login_client.cpp index 1c7e5efd..8cb53c92 100644 --- a/src/login_client.cpp +++ b/src/login_client.cpp @@ -126,10 +126,17 @@ void LoginClient::pump() { if(on_game_ && session_->handshake_phase_entered() && !handshake_notified_) { handshake_notified_=true;if(!direct_enter_) notify(EventType::Handshake); } if(on_game_ && session_->game_login_sent() && !login_notified_) { login_notified_=true;if(!direct_enter_) notify(EventType::LoginStart); } if(session_->state()==LoginSession::State::Selecting && !selection_notified_) { - selection_notified_=true;status_=Status::Selecting;notify(direct_enter_?EventType::DirectEnterReady:EventType::SelectReady); + selection_notified_=true;status_=Status::Selecting; + if(direct_enter_) { + select(direct_enter_slot_); + // Do not notify DirectEnterReady here before the server actually transitions to Loading! + } else { + notify(EventType::SelectReady); + } } if(session_->state()==LoginSession::State::Loading && !loading_notified_) { - loading_notified_=true;status_=Status::Loading;notify(EventType::Loading);return; + loading_notified_=true;status_=Status::Loading; + notify(EventType::Loading);return; } flush();if(status_==Status::Failed) return; } @@ -149,7 +156,7 @@ void LoginClient::direct_enter(std::uint8_t slot) { if(!character.address || !character.port || !inet_ntop(AF_INET,&address,host,sizeof(host))) throw std::invalid_argument("character server endpoint is missing"); session_->reconnect_game(); - direct_enter_=true;handshake_notified_=false;login_notified_=selection_notified_=loading_notified_=false; + direct_enter_=true;direct_enter_slot_=slot;handshake_notified_=false;login_notified_=selection_notified_=loading_notified_=false; deadline_=std::chrono::steady_clock::now()+std::chrono::seconds(15); start_endpoint({host,character.port}); } diff --git a/src/login_client.h b/src/login_client.h index 6be2cdcc..ee4480bb 100644 --- a/src/login_client.h +++ b/src/login_client.h @@ -44,6 +44,7 @@ private: std::shared_ptr resolution_; Endpoint game_; bool direct_enter_=false; + std::uint8_t direct_enter_slot_=0; bool handshake_notified_=false; bool on_game_=false, login_notified_=false, selection_notified_=false, loading_notified_=false; std::uint64_t generation_=0; diff --git a/src/login_session.cpp b/src/login_session.cpp index a8aed3dd..ae8933cd 100644 --- a/src/login_session.cpp +++ b/src/login_session.cpp @@ -24,11 +24,11 @@ void LoginSession::clear_password() { volatile char* p=password_.empty()?nullptr void LoginSession::fail(std::string reason) { failure_=std::move(reason); state_=State::Failed; clear_password(); output_.clear(); } void LoginSession::begin_game() { if(state_!=State::Authenticated) throw std::logic_error("game connection requires successful authentication"); - game_=true; handshake_phase_entered_=false; encrypted_=false; sequence_=0; raw_.clear(); plain_.clear(); output_.clear(); tx_=rx_=locale_key(); state_=State::Handshake; + game_=true; server_clock_ready_=false; handshake_phase_entered_=false; encrypted_=false; sequence_=0; raw_.clear(); plain_.clear(); output_.clear(); tx_=rx_=locale_key(); state_=State::Handshake; } void LoginSession::reconnect_game() { if(state_!=State::Selecting) throw std::logic_error("DirectEnter requires a selected account session"); - handshake_phase_entered_=false;encrypted_=false; sequence_=0; raw_.clear(); plain_.clear(); output_.clear(); + server_clock_ready_=false;handshake_phase_entered_=false;encrypted_=false; sequence_=0; raw_.clear(); plain_.clear(); output_.clear(); tx_=rx_=locale_key(); state_=State::Handshake; roster_received_=select_phase_received_=game_login_sent_=false; } @@ -52,7 +52,9 @@ void LoginSession::feed(std::span input) { } bool LoginSession::process_packet() { if(plain_.empty() || state_==State::Loading) return false; - auto header=plain_[0]; std::size_t size=0; + auto header=plain_[0]; + if(plain_.empty() || state_==State::Loading) return false; + std::size_t size=0; switch(header) { case 0:size=1;break; case 253:size=2;break; case 255:size=13;break; case 44:size=1;break; case 254:size=7;break; // legacy UDP binding, not used by this TCP bootstrap @@ -64,7 +66,13 @@ bool LoginSession::process_packet() { break; case 150:size=6;break; case 7:size=10;break; case 90:size=2;break; case 32:size=444;break; // 5 * (70-byte player + 4-byte guild id + 13-byte guild name) + 9 - default:fail("unsupported login packet header "+std::to_string(header));return false; + default: + if(state_==State::Entering) { + state_=State::Loading; + return false; + } + fail("unsupported login packet header "+std::to_string(header)); + return false; } if(plain_.size() +#include #include namespace ava2 { struct Character { @@ -35,6 +36,13 @@ public: const std::vector& characters() const { return characters_; } bool handshake_phase_entered() const { return handshake_phase_entered_; } bool game_login_sent() const { return game_login_sent_; } + // Game bootstrap owns the first handshake before native Game-phase processing. + bool server_milliseconds(std::uint32_t& value) const { + if(!game_ || !server_clock_ready_) return false; + value=server_clock_base_+std::uint32_t(std::chrono::duration_cast( + std::chrono::steady_clock::now()-server_clock_received_).count()); + return true; + } std::uint8_t empire() const { return empire_; } std::uint32_t login_key() const { return login_key_; } private: @@ -44,6 +52,9 @@ private: void clear_password(); State state_=State::Handshake; bool handshake_phase_entered_=false; + bool server_clock_ready_=false; + std::uint32_t server_clock_base_=0; + std::chrono::steady_clock::time_point server_clock_received_; bool game_=false, encrypted_=false, roster_received_=false, select_phase_received_=false, game_login_sent_=false; std::uint8_t empire_=0; std::string account_,password_,failure_; diff --git a/src/main.cpp b/src/main.cpp index 10b215e9..fe3c59dc 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -23,14 +23,19 @@ #ifdef AVA2_HAS_PYTHON #include "python_runtime.h" #include "python_net.h" +#include "python_app.h" #include "python_event_manager.h" #include "python_system.h" +#include "python_background.h" #include "eter_base/Random.h" #include #include #include "python_gameplay_modules.h" #include "eter_image/GrpDevice.h" #include "eter_ui/PythonWindowManager.h" +#include "python_ime.h" +#include "player_settings.h" +#include "eter_render/RaceData.h" #endif #include #include @@ -62,6 +67,59 @@ int port(const std::string& value) { if(used!=value.size() || number<1 || number>65535) throw std::invalid_argument("Port must be between 1 and 65535");return number; } +ava2::Render3DDraw BuildGroundShadowDraw(float x, float y, float z, float radius, const ava2::TerrainHeightmap* terrain) { + ava2::Render3DDraw draw; + draw.z_enable = true; + draw.z_write = false; + draw.cull_mode = 1; // 1: None + draw.alpha_blend = true; + draw.blend_mode = 0; // Alpha + draw.alpha_test = false; + draw.lighting = false; + draw.fog = false; + + const int SEGMENTS = 16; + float center_y = terrain ? (terrain->GetHeightAtWorld(x, z) + 2.0f) : (y + 2.0f); + + // Center vertex (index 0) + draw.positions.push_back(x); + draw.positions.push_back(center_y); + draw.positions.push_back(z); + draw.normals.push_back(0.0f); + draw.normals.push_back(1.0f); + draw.normals.push_back(0.0f); + draw.uv0.push_back(0.5f); + draw.uv0.push_back(0.5f); + draw.diffuse.push_back(0x90000000); // semi-transparent black center + + for (int i = 0; i < SEGMENTS; ++i) { + float angle = (2.0f * 3.14159265358979323846f * static_cast(i)) / static_cast(SEGMENTS); + float px = x + std::cos(angle) * radius; + float pz = z + std::sin(angle) * radius; + float py = terrain ? (terrain->GetHeightAtWorld(px, pz) + 2.0f) : (y + 2.0f); + + draw.positions.push_back(px); + draw.positions.push_back(py); + draw.positions.push_back(pz); + draw.normals.push_back(0.0f); + draw.normals.push_back(1.0f); + draw.normals.push_back(0.0f); + draw.uv0.push_back(0.5f + 0.5f * std::cos(angle)); + draw.uv0.push_back(0.5f + 0.5f * std::sin(angle)); + draw.diffuse.push_back(0x00000000); // fully transparent edge + } + + // Triangle fan from center + for (int i = 0; i < SEGMENTS; ++i) { + int next_idx = 1 + ((i + 1) % SEGMENTS); + draw.indices.push_back(0); + draw.indices.push_back(1 + i); + draw.indices.push_back(next_idx); + } + + return draw; +} + int SDLKeyToDIK(SDL_Keycode key) { if (key >= SDLK_A && key <= SDLK_Z) { static const int lut[26] = { @@ -104,8 +162,45 @@ int SDLKeyToDIK(SDL_Keycode key) { } // namespace int main(int argc, char** argv) { +#if defined(__APPLE__) + // Keep legacy Python's relative config/chat writes outside the signed application. try { - int frame_limit = 0, auto_slot = -1, fps_cap = -1; + std::filesystem::path base = std::filesystem::path(SDL_GetBasePath()).lexically_normal(); + if (base.filename().empty()) base = base.parent_path(); + // SDL on macOS returns the bundle's Resources directory by default. + if (base.filename() == "Resources" && base.parent_path().filename() == "Contents") + base = base.parent_path() / "MacOS"; + const auto resources = base / "../Resources"; + if (base.filename() == "MacOS" && std::filesystem::is_directory(resources)) { + std::filesystem::path data; + if (const char* overridePath = std::getenv("AVA2_USER_DATA_DIR")) data = overridePath; + else { + char* preferences = SDL_GetPrefPath("AVA2", "Client"); + if (!preferences) throw std::runtime_error(SDL_GetError()); + data = preferences; SDL_free(preferences); + } + std::filesystem::create_directories(data); + for (const auto& entry : std::filesystem::directory_iterator(resources)) { + const auto name = entry.path().filename(); + const auto extension = name.extension().string(); + if (name == "lib" || extension == ".cfg" || extension == ".inf" || extension == ".chat") continue; + const auto link = data / name; + const auto target = std::filesystem::canonical(entry.path()); + if (std::filesystem::is_symlink(link) && std::filesystem::read_symlink(link) != target) + std::filesystem::remove(link); + if (!std::filesystem::exists(link)) std::filesystem::create_symlink(target, link); + } + std::filesystem::current_path(data); + SDL_Log("Client user data: %s", data.string().c_str()); + } + } catch (const std::exception& error) { + SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Cannot initialize client data directory: %s", error.what()); + return 1; + } + +#endif + try { + int frame_limit = 0, auto_slot = -1, fps_cap = -1, game_frames = 1, rendered_game_frames = 0; #ifdef __ANDROID__ float render_scale = 0.75f; #else @@ -113,7 +208,8 @@ int main(int argc, char** argv) { #endif bool auto_connect = false, until_loading = false, until_select = false, until_game = false; bool use_gpu_raster = true, preview_data = false; - std::string stdlib, script_root, view_script, screenshot; + std::string stdlib, script_root, view_script, screenshot, game_script, frame_profile; + bool game_script_executed = false; std::string start_phase = "login"; std::array fields{{{"Auth host","127.0.0.1",255},{"Auth port","",5},{"Game host","127.0.0.1",255},{"Game port","",5},{"Account","",30},{"Password","",16,true}}}; @@ -130,6 +226,8 @@ int main(int argc, char** argv) { else if (arg == "--python-root") script_root = next(); else if (arg == "--login-ui") view_script = next(); else if (arg == "--screenshot") screenshot = next(); + else if (arg == "--game-script") game_script = next(); + else if (arg == "--frame-profile") frame_profile = next(); else if (arg == "--phase") start_phase = next(); else if (arg == "--auth-host") fields[0].value = next(); else if (arg == "--auth-port") fields[1].value = next(); @@ -141,9 +239,10 @@ int main(int argc, char** argv) { else if (arg == "--until-loading") until_loading = true; else if (arg == "--until-select") until_select = true; else if (arg == "--until-game") until_game = true; + else if (arg == "--game-frames") game_frames = std::max(1, std::stoi(next())); else if (arg == "--preview-data") preview_data = true; else if (arg == "--software-raster") use_gpu_raster = false; - else throw std::invalid_argument("Usage: ava2_client [--frames N] [--fps-cap N] [--render-scale 0.25..1] [--stdlib ZIP --python-root DIR] [--login-ui SCRIPT | --phase login|select|create|loading|game] [--auth-host HOST --auth-port PORT --game-host HOST --game-port PORT --account ACCOUNT] [--auto-connect] [--auto-select 0..4] [--until-select|--until-loading|--until-game] [--software-raster] [--screenshot FILE.bmp]"); + else throw std::invalid_argument("Usage: ava2_client [--frames N] [--fps-cap N] [--render-scale 0.25..1] [--stdlib ZIP --python-root DIR] [--login-ui SCRIPT | --phase login|select|create|loading|game] [--auth-host HOST --auth-port PORT --game-host HOST --game-port PORT --account ACCOUNT] [--auto-connect] [--auto-select 0..4] [--until-select|--until-loading|--until-game] [--game-script FILE.py] [--software-raster] [--screenshot FILE.bmp]"); } if (fps_cap < 0) { @@ -169,6 +268,7 @@ int main(int argc, char** argv) { } if (script_root.empty()) { if (std::filesystem::exists("upstream/python-root")) script_root = "upstream/python-root"; + else if (std::filesystem::exists("root")) script_root = "root"; else { auto res = std::filesystem::path(SDL_GetBasePath()) / "../Resources/root"; if (std::filesystem::exists(res)) script_root = res.string(); @@ -201,8 +301,9 @@ int main(int argc, char** argv) { throw std::runtime_error("Python runtime disabled at build time"); #endif - if ((auto_connect || auto_slot >= 0) && view_script.empty()) - throw std::invalid_argument("Login automation with credentials requires --login-ui"); + // Allow native auto-connect without --login-ui + // if ((auto_connect || auto_slot >= 0) && view_script.empty()) + // throw std::invalid_argument("Login automation with credentials requires --login-ui"); if (auto_connect) { const char* password = std::getenv("AVA2_PASSWORD"); @@ -221,12 +322,12 @@ int main(int argc, char** argv) { struct Quit { ~Quit(){ SDL_Quit(); } } quit; std::unique_ptr gpu( - SDL_CreateGPUDevice(SDL_GPU_SHADERFORMAT_SPIRV | SDL_GPU_SHADERFORMAT_MSL, true, nullptr), + SDL_CreateGPUDevice(SDL_GPU_SHADERFORMAT_SPIRV | SDL_GPU_SHADERFORMAT_MSL, std::getenv("AVA2_GPU_DEBUG") != nullptr, nullptr), SDL_DestroyGPUDevice ); if (!gpu) throw std::runtime_error(SDL_GetError()); - // CPythonApplication::Create sizes the device from metin2.cfg (CPythonSystem::GetWidth/GetHeight). + // CPythonApplication::Create sizes the device from metin2.cfg (ava2::CPythonSystem::GetWidth/GetHeight). int screen_width = 1280, screen_height = 720; #ifdef AVA2_HAS_PYTHON if (python) { @@ -247,7 +348,8 @@ int main(int argc, char** argv) { if (!renderer) throw std::runtime_error(SDL_GetError()); SDL_SetRenderLogicalPresentation(renderer.get(), screen_width, screen_height, SDL_LOGICAL_PRESENTATION_LETTERBOX); - SDL_SetRenderVSync(renderer.get(), 1); + // One pacing source: software caps must not also wait on the display refresh. + SDL_SetRenderVSync(renderer.get(), fps_cap > 0 ? 0 : 1); SDL_StartTextInput(window.get()); float dpi_scale = SDL_GetWindowPixelDensity(window.get()); SDL_Log("AVA2 host started: platform=%s GPU=%s Retina_DPI=%.2fx FPS_Cap=%d RenderScale=%.2f", @@ -256,7 +358,7 @@ int main(int argc, char** argv) { bool running = true, requested = false, entered = false; int frames = 0, focus = 4; std::string local_error, last_phase; - auto deadline = std::chrono::steady_clock::now() + std::chrono::seconds(20); + auto deadline = std::chrono::steady_clock::now() + std::chrono::seconds(60); #ifdef AVA2_HAS_PYTHON CGraphicDevice graphicDevice; @@ -324,6 +426,9 @@ int main(int argc, char** argv) { ava2::set_mock_character(3, c3); ava2::set_mock_empire(1); + if (python) { + PyRun_SimpleString("try:\n import constInfo\n constInfo.ACCOUNT_NAME = 'WarriorHero'\nexcept: pass\n"); + } } // Initialize 3D Character Renderer (modeled after 40250) @@ -364,14 +469,14 @@ int main(int argc, char** argv) { ava2::TerrainHeightmap outdoor_terrain; std::string raw_path = "map/metin2_map_a1/001003/height.raw"; if (!std::filesystem::exists(raw_path)) { - raw_path = "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/height.raw"; + raw_path = "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/height.raw"; } if (std::filesystem::exists(raw_path)) { outdoor_terrain.LoadRaw(raw_path, 0.5f, 200.0f); SDL_Log("Loaded outdoor height.raw: %d x %d", outdoor_terrain.GetWidth(), outdoor_terrain.GetHeight()); std::string tile_path = "map/metin2_map_a1/001003/tile.raw"; if (!std::filesystem::exists(tile_path)) { - tile_path = "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/tile.raw"; + tile_path = "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/tile.raw"; } if (std::filesystem::exists(tile_path)) { outdoor_terrain.LoadTileRaw(tile_path); @@ -380,7 +485,7 @@ int main(int argc, char** argv) { std::string attr_path = "map/metin2_map_a1/001003/attr.atr"; if (!std::filesystem::exists(attr_path)) { - attr_path = "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/attr.atr"; + attr_path = "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/attr.atr"; } if (std::filesystem::exists(attr_path)) { outdoor_terrain.LoadAttr(attr_path); @@ -389,7 +494,7 @@ int main(int argc, char** argv) { std::string tset_path = "textureset/metin2_map1.txt"; if (!std::filesystem::exists(tset_path)) { - tset_path = "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/Maps/textureset/metin2_map1.txt"; + tset_path = "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/Maps/textureset/metin2_map1.txt"; } if (std::filesystem::exists(tset_path)) { outdoor_terrain.LoadTextureSet(tset_path); @@ -399,6 +504,7 @@ int main(int argc, char** argv) { outdoor_terrain.GenerateProcedural(64, 64, 200.0f, 60.0f); SDL_Log("Generated procedural outdoor terrain"); } + float player_world_y = 0.0f; float player_world_x = 0.0f, player_world_z = 0.0f, player_world_yaw = 0.0f; // Initialize SkyBox and Environment Engine (modeled after 40250 CSkyBox & SEnvironmentData) @@ -463,7 +569,7 @@ int main(int argc, char** argv) { ava2::SpeedTreeForest outdoor_forest; std::string prop_dir = "property/property"; if (!std::filesystem::exists(prop_dir)) prop_dir = "property"; - if (!std::filesystem::exists(prop_dir)) prop_dir = "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/property/property"; + if (!std::filesystem::exists(prop_dir)) prop_dir = "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/property/property"; outdoor_forest.ScanPropertyDirectory(prop_dir); outdoor_forest.RegisterPropertyData(ava2::SpeedTreeProperty{101, "Oak", "ymir work/palnts_2/all/ot/treewillowoakfreesu.spt", 900.0f, 0.0f}); outdoor_forest.RegisterPropertyData(ava2::SpeedTreeProperty{102, "Pine", "ymir work/palnts_2/all/ot/treescotchpineforest.spt", 1000.0f, 0.0f}); @@ -501,7 +607,7 @@ int main(int argc, char** argv) { ava2::WaterManager outdoor_water; std::string water_path = "map/metin2_map_a1/001003/water.wtr"; if (!std::filesystem::exists(water_path)) { - water_path = "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/water.wtr"; + water_path = "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/water.wtr"; } if (std::filesystem::exists(water_path)) { outdoor_water.LoadWater(water_path, outdoor_terrain.GetCellScale(), 0.5f, 200.0f, @@ -515,10 +621,10 @@ int main(int argc, char** argv) { // Initialize Third-Person Orbit Camera (40250 CCamera) ava2::OrbitCamera orbit_camera; - orbit_camera.SetDistance(420.0f); - orbit_camera.SetPitch(20.0f); + orbit_camera.SetDistance(1200.0f); + orbit_camera.SetPitch(30.0f); orbit_camera.SetYaw(0.0f); - orbit_camera.SetTargetHeight(95.0f); + orbit_camera.SetTargetHeight(120.0f); // Initialize Minimap Radar System ava2::MinimapManager minimap_mgr; @@ -526,7 +632,7 @@ int main(int argc, char** argv) { outdoor_terrain.GetWorldMinZ(), outdoor_terrain.GetWorldMaxZ()); std::string minimap_path = "map/metin2_map_a1/001003/minimap.dds"; if (!std::filesystem::exists(minimap_path)) { - minimap_path = "/Users/shen/Work/Code/Metin2/AVA2/TEST/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/minimap.dds"; + minimap_path = "/Users/shen/Work/Code/Metin2/AVA2/1. Client DEV/pack_maker/Maps/metin2_map_a1/001003/minimap.dds"; } if (std::filesystem::exists(minimap_path)) { minimap_mgr.LoadMinimap(minimap_path); @@ -539,6 +645,7 @@ int main(int argc, char** argv) { if (model3d) { renderer3d = std::make_unique(view3d_w, view3d_h); renderer3d->SetLogicalSize(screen_width, screen_height); + if (use_gpu_raster) {renderer3d->SetGPUDevice(gpu.get());ava2::Gr2ModelInstance::SetHardwareSkinningEnabled(std::getenv("AVA2_CPU_SKINNING")==nullptr);} renderer3d->SetCameraLookAt(0.0f, 130.0f, -320.0f, 0.0f, 100.0f, 0.0f, 0.0f, 1.0f, 0.0f); renderer3d->SetPerspective(45.0f, static_cast(view3d_w) / static_cast(view3d_h), 1.0f, 4000.0f); surface3d.reset(SDL_CreateSurface(view3d_w, view3d_h, SDL_PIXELFORMAT_ARGB8888)); @@ -663,7 +770,7 @@ int main(int argc, char** argv) { python->execute("stream.SetLoadingPhase()\n"); } else if (phase == "game") { python->execute( - "stream.SetGamePhase()\n" + "import localeInfo\nlocaleInfo.LoadLocaleData()\nstream.SetGamePhase()\n" "if stream.curPhaseWindow and hasattr(stream.curPhaseWindow, 'Open'):\n" " stream.curPhaseWindow.Open()\n" "import chr\n" @@ -974,16 +1081,32 @@ int main(int argc, char** argv) { ava2::SetItemMovePacketCallback(handle_item_move); if (original_phase_mode && python) { + ava2::LoadPlayerSettings(); + python->execute("import introLoading\nintroLoading.__main__()\n"); + if (std::filesystem::exists("npclist.txt")) + ava2::RaceManager::Instance().LoadGameNPC("npclist.txt"); + else if (std::filesystem::exists("upstream/python-root/npclist.txt")) + ava2::RaceManager::Instance().LoadGameNPC("upstream/python-root/npclist.txt"); + else if (std::filesystem::exists("locale/en/npclist.txt")) + ava2::RaceManager::Instance().LoadGameNPC("locale/en/npclist.txt"); + else + ava2::RaceManager::Instance().LoadGameNPC("npclist.txt"); + ava2::RaceManager::Instance().LoadPlayerRaces(); + python->execute( - "import networkModule, game, net, constInfo\n" + "import networkModule, game, net, constInfo, app\n" + // Match prototype.RunApp before the first character is constructed. + "app.SetHairColorEnable(constInfo.HAIR_COLOR_ENABLE)\n" + "app.SetArmorSpecularEnable(constInfo.ARMOR_SPECULAR_ENABLE)\n" + "app.SetWeaponSpecularEnable(constInfo.WEAPON_SPECULAR_ENABLE)\n" "stream = networkModule.MainStream()\n" "stream.Create()\n" ); - if (until_game) { + if (until_game && !auto_connect) { start_phase = "game"; - } else if (until_loading) { + } else if (until_loading && !auto_connect) { start_phase = "loading"; - } else if (until_select) { + } else if (until_select && !auto_connect) { start_phase = "select"; } switch_phase(start_phase); @@ -1015,18 +1138,19 @@ int main(int argc, char** argv) { auto cap_period = fps_cap > 0 ? std::chrono::nanoseconds(1'000'000'000LL / fps_cap) : std::chrono::nanoseconds(0); - auto next_frame_at = std::chrono::steady_clock::now(); + auto next_frame_at = std::chrono::steady_clock::now() + cap_period; + std::ofstream profileOutput; + if (!frame_profile.empty()) { + profileOutput.open(frame_profile); + if (!profileOutput) throw std::runtime_error("Cannot write --frame-profile"); + profileOutput << "phase,frame,interval_ms,active_ms,build_ms,raster_ms,present_ms\n"; + } + auto profilePreviousEnd = std::chrono::steady_clock::now(); while (running && (!frame_limit || frames < frame_limit)) { - if (cap_period.count() > 0) { - const auto now = std::chrono::steady_clock::now(); - if (next_frame_at > now) { - std::this_thread::sleep_until(next_frame_at); - } else if (now - next_frame_at > cap_period) { - next_frame_at = now; - } - next_frame_at += cap_period; - } + const auto profileFrameStart = std::chrono::steady_clock::now(); + double profileBuildMs = 0.0, profileRasterMs = 0.0; +const auto profileActiveStart = std::chrono::steady_clock::now(); #ifdef AVA2_HAS_PYTHON ava2::LoginViewSnapshot snapshot; if (python && !view_script.empty()) { @@ -1035,11 +1159,27 @@ int main(int argc, char** argv) { if (ava2::PythonNetworkStream::Instance().IsQuitRequested()) running = false; snapshot = python->view_snapshot(); } +#endif + ava2::TerrainHeightmap* active_terrain = &outdoor_terrain; + ava2::MapObjectManager* active_map_objects = &map_objects; +#ifdef AVA2_HAS_PYTHON + if (ava2::CPythonBackground::Instance().IsMapReady()) { + if (ava2::CPythonBackground::Instance().GetTerrain()) { + active_terrain = ava2::CPythonBackground::Instance().GetTerrain(); + } + if (ava2::CPythonBackground::Instance().GetMapObjects()) { + active_map_objects = ava2::CPythonBackground::Instance().GetMapObjects(); + } + } #endif SDL_Event event; while (SDL_PollEvent(&event)) { if (event.type == SDL_EVENT_QUIT) running = false; #ifdef AVA2_HAS_PYTHON + if (event.type == SDL_EVENT_WINDOW_FOCUS_LOST) { + ava2::CancelPlayerMovement(); orbit_camera.EndDrag(); + key_move_fwd = key_move_back = key_turn_left = key_turn_right = false; + } if (wm) { if (event.type == SDL_EVENT_MOUSE_MOTION) { float mx, my; @@ -1121,7 +1261,7 @@ int main(int argc, char** argv) { } else { // Pick terrain float pickX = 0.0f, pickY = 0.0f, pickZ = 0.0f; - if (renderer3d->PickTerrain(bx, by, outdoor_terrain, pickX, pickY, pickZ)) { + if (renderer3d->PickTerrain(bx, by, *active_terrain, pickX, pickY, pickZ)) { player_actor.SetMoveTarget(pickX, pickZ); target_mgr.AddGroundPickEffect(pickX, pickY, pickZ); } @@ -1131,7 +1271,8 @@ int main(int argc, char** argv) { } } else if (event.button.button == SDL_BUTTON_RIGHT) { wm->RunMouseRightButtonDown(static_cast(bx), static_cast(by)); - orbit_camera.BeginDrag(static_cast(bx), static_cast(by)); + if (preview_data || ava2::IsPlayerCameraDragging()) + orbit_camera.BeginDrag(static_cast(bx), static_cast(by)); } } else if (event.type == SDL_EVENT_MOUSE_BUTTON_UP) { float bx, by; @@ -1145,7 +1286,7 @@ int main(int argc, char** argv) { } } } else if (event.type == SDL_EVENT_MOUSE_WHEEL) { - if (last_phase == "game") { + if (last_phase == "game" && !wm->RunMouseWheelEvent(long(event.wheel.y * 120))) { orbit_camera.Zoom(event.wheel.y); } } else if (event.type == SDL_EVENT_KEY_DOWN) { @@ -1207,7 +1348,53 @@ int main(int argc, char** argv) { " stream.curPhaseWindow.CancelCreate()\n" ); } - } else if (last_phase == "game") { + } else if (last_phase == "login") { + if (event.key.key == SDLK_TAB) { + wm->RunIMETabEvent(); + } else if (event.key.key == SDLK_BACKSPACE) { + if (ava2::IME_IsCaptureInput()) { + ava2::IME_OnBackspace(); + } + } else if (event.key.key == SDLK_DELETE) { + if (ava2::IME_IsCaptureInput()) { + wm->RunIMEKeyDown(0x2E); // VK_DELETE + } + } else if (event.key.key == SDLK_LEFT) { + if (ava2::IME_IsCaptureInput()) { + wm->RunIMEKeyDown(0x25); // VK_LEFT + } + } else if (event.key.key == SDLK_RIGHT) { + if (ava2::IME_IsCaptureInput()) { + wm->RunIMEKeyDown(0x27); // VK_RIGHT + } + } else if (event.key.key == SDLK_HOME) { + if (ava2::IME_IsCaptureInput()) { + wm->RunIMEKeyDown(0x24); // VK_HOME + } + } else if (event.key.key == SDLK_END) { + if (ava2::IME_IsCaptureInput()) { + wm->RunIMEKeyDown(0x23); // VK_END + } + } else if (event.key.key == SDLK_RETURN || event.key.key == SDLK_KP_ENTER) { + if (ava2::IME_IsCaptureInput()) { + wm->RunIMEReturnEvent(); + } else { + python->execute( + "if 'stream' in globals() and stream.curPhaseWindow:\n" + " w = stream.curPhaseWindow\n" + " if hasattr(w, 'serverBoard') and w.serverBoard.IsShow():\n" + " w._LoginWindow__OnClickSelectServerButton()\n" + " elif hasattr(w, 'loginBoard') and w.loginBoard.IsShow():\n" + " w._LoginWindow__OnClickLoginButton()\n" + ); + } + } else if (event.key.key == SDLK_ESCAPE) { + python->execute( + "if 'stream' in globals() and stream.curPhaseWindow and hasattr(stream.curPhaseWindow, 'OnPressExitKey'):\n" + " stream.curPhaseWindow.OnPressExitKey()\n" + ); + } + } else if (last_phase == "game" && preview_data) { if (event.key.key == SDLK_RETURN || event.key.key == SDLK_KP_ENTER) { if (chat_input_active) { if (!chat_input_buffer.empty()) { @@ -1331,8 +1518,9 @@ int main(int argc, char** argv) { wm->RunPressEscapeKey(); } } - if (event.key.key == SDLK_F9) { + if (preview_data && event.key.key == SDLK_F9) { use_gpu_raster = !use_gpu_raster; + ava2::Gr2ModelInstance::SetHardwareSkinningEnabled(use_gpu_raster && std::getenv("AVA2_CPU_SKINNING")==nullptr); SDL_Log("3D Rasterizer toggled: %s", use_gpu_raster ? "GPU Hardware Accelerated (Metal)" : "CPU Software Rasterizer"); } int dik = SDLKeyToDIK(event.key.key); @@ -1347,7 +1535,9 @@ int main(int argc, char** argv) { int dik = SDLKeyToDIK(event.key.key); if (dik) wm->RunKeyUp(dik); } else if (event.type == SDL_EVENT_TEXT_INPUT && original_phase_mode && python) { - if (last_phase == "create") { + if (ava2::IME_IsCaptureInput()) { + ava2::IME_InsertText(event.text.text); + } else if (last_phase == "create") { std::string text_in = event.text.text; python->execute( "if 'stream' in globals() and stream.curPhaseWindow and hasattr(stream.curPhaseWindow, 'editCharacterName'):\n" @@ -1401,6 +1591,30 @@ int main(int argc, char** argv) { } #endif + // Native auto-connect support +#ifdef AVA2_HAS_PYTHON + if (python && original_phase_mode && auto_connect && !requested && frames > 10) { + requested = true; + auto* globals = PyModule_GetDict(PyImport_AddModule("__main__")); + auto* account = PyString_FromString(fields[4].value.c_str()); + auto* password = PyString_FromString(fields[5].value.c_str()); + PyDict_SetItemString(globals, "__ava2_account", account); + PyDict_SetItemString(globals, "__ava2_password", password); + Py_DECREF(account); Py_DECREF(password); + python->execute( + "try:\n" + " w = stream.curPhaseWindow\n" + " if hasattr(w, 'serverBoard') and w.serverBoard.IsShow():\n" + " w._LoginWindow__OnClickSelectServerButton()\n" + " w.idEditLine.SetText(__ava2_account)\n" + " w.pwdEditLine.SetText(__ava2_password)\n" + " w.Connect(__ava2_account, __ava2_password)\n" + "finally:\n" + " del __ava2_account, __ava2_password\n"); + fields[5].value.clear(); + } +#endif + // Synchronize real phase from stream.curPhaseWindow #ifdef AVA2_HAS_PYTHON if (python && original_phase_mode) { @@ -1435,9 +1649,19 @@ int main(int argc, char** argv) { } } if (!current_py_phase.empty() && current_py_phase != last_phase) { + if (current_py_phase == "game") { + orbit_camera.SetDistance(1550.0f); + orbit_camera.SetPitch(27.0f); + } last_phase = current_py_phase; SDL_Log("Phase synchronized: %s", last_phase.c_str()); } + if (original_phase_mode && auto_slot >= 0 && last_phase == "select" && !entered) { + python->execute("if 'stream' in globals() and stream.curPhaseWindow and hasattr(stream.curPhaseWindow, 'SelectSlot'):\n" + " stream.curPhaseWindow.SelectSlot(" + std::to_string(auto_slot) + ")\n" + " stream.curPhaseWindow.StartGame()\n"); + entered = true; + } } #endif @@ -1445,9 +1669,16 @@ int main(int argc, char** argv) { float dt = std::chrono::duration(cur_time - prev_frame_time).count(); prev_frame_time = cur_time; if (frame_limit > 0) dt = 0.033f; - else if (dt <= 0.0f || dt > 0.1f) dt = 0.033f; + else dt = std::clamp(dt, 0.001f, 0.25f); - if (last_phase == "game") { +#ifdef AVA2_HAS_PYTHON + if (python) { + ava2::SetGameFrameDelta(dt); + ava2::pump_python_net(); + } +#endif + + if (last_phase == "game" && preview_data) { // Continuous rotation if (key_turn_left) { player_actor.SetYaw(player_actor.GetYaw() - 140.0f * dt); @@ -1459,9 +1690,9 @@ int main(int argc, char** argv) { // Continuous movement (Wait <-> Run state machine) if (!player_actor.IsAttacking()) { if (key_move_fwd) { - player_actor.MoveInDirection(player_actor.GetYaw(), dt, &outdoor_terrain, &map_objects); + player_actor.MoveInDirection(player_actor.GetYaw(), dt, active_terrain, active_map_objects); } else if (key_move_back) { - player_actor.MoveInDirection(player_actor.GetYaw() + 180.0f, dt, &outdoor_terrain, &map_objects); + player_actor.MoveInDirection(player_actor.GetYaw() + 180.0f, dt, active_terrain, active_map_objects); } else if (!player_actor.HasMoveTarget()) { player_actor.StopMoving(); } @@ -1562,10 +1793,10 @@ int main(int argc, char** argv) { } // Update actor instances, floating combat text, and target decals - player_actor.Update(dt, &outdoor_terrain, &map_objects); + player_actor.Update(dt, active_terrain, active_map_objects); if (preview_data) { - mob_dog.Update(dt, &outdoor_terrain); - mob_metin.Update(dt, &outdoor_terrain); + mob_dog.Update(dt, active_terrain); + mob_metin.Update(dt, active_terrain); } floating_text_mgr.Update(dt); target_mgr.Update(dt); @@ -1577,7 +1808,7 @@ int main(int argc, char** argv) { // Drive PythonNetworkStream and NetworkActorManager ava2::PythonNetworkStream::Instance().ProcessRecvData(); ava2::pump_python_net(); - ava2::NetworkActorManager::Instance().Update(dt, &outdoor_terrain); + ava2::NetworkActorManager::Instance().Update(dt, active_terrain); // Update TextTail overhead positions auto& ttm = ava2::TextTailManager::Instance(); @@ -1611,6 +1842,7 @@ int main(int argc, char** argv) { } } + player_world_y = player_actor.GetY(); player_world_x = player_actor.GetX(); player_world_z = player_actor.GetZ(); player_world_yaw = player_actor.GetYaw(); @@ -1619,6 +1851,83 @@ int main(int argc, char** argv) { #endif } +#ifdef AVA2_HAS_PYTHON + if (last_phase == "game" && !preview_data) { + int rotateInput=0,pitchInput=0,zoomInput=0; + ava2::GetCameraInput(rotateInput,pitchInput,zoomInput); + orbit_camera.SetYaw(orbit_camera.GetYaw()+rotateInput*60.0f*dt); + orbit_camera.SetPitch(orbit_camera.GetPitch()+pitchInput*45.0f*dt); + if (zoomInput) orbit_camera.SetDistance(orbit_camera.GetDistance()*std::exp(zoomInput*dt)); + // One-shot integration verification against the real GameWindow. + if (python && !game_script.empty() && !game_script_executed && rendered_game_frames >= 3) { + FILE* script = std::fopen(game_script.c_str(), "rb"); + if (!script) throw std::runtime_error("Cannot open --game-script"); + std::string code; + char chunk[4096]; + while (size_t size = std::fread(chunk, 1, sizeof(chunk), script)) code.append(chunk, size); + const bool failed = std::ferror(script); + std::fclose(script); + if (failed) throw std::runtime_error("Cannot read --game-script"); + python->execute(code); + game_script_executed = true; + } + // Network/loading callbacks can replace the map during this frame. + // Resolve owners again after pumping packets instead of retaining freed terrain. + active_terrain = ava2::CPythonBackground::Instance().GetTerrain(); + active_map_objects = ava2::CPythonBackground::Instance().GetMapObjects(); + if (const auto* environment = ava2::CPythonBackground::Instance().GetCurrentEnvironmentData()) + current_env = *environment; + ava2::GetMainCharacterPosition(player_world_x, player_world_z, player_world_y); + if (active_terrain) player_world_y = active_terrain->GetHeightAtWorld(player_world_x, player_world_z); + auto* main = ava2::NetworkActorManager::Instance().GetMainInstance(); + if (main && main->m_pActorInstance) { + auto& actor = *main->m_pActorInstance; + // An add packet can arrive between updates with Z=0. Place it on the map + // before camera collision checks, rather than shrinking the camera underground. + if (active_terrain) actor.SetPosition(actor.GetX(), active_terrain->GetHeightAtWorld(actor.GetX(), actor.GetZ()), actor.GetZ()); + // Original GameWindow routes input through player.SetSingleDIKKeyState + // and SetMouseState. Apply it to the server-owned actor, not the preview. + static bool wasKeyboardMoving = false; + static bool wasMoving = false; + static uint32_t lastMoveSent = 0; + float moveYaw = 0.0f; + const bool keyboardMoving = actor.CanAct() && ava2::GetPlayerMovementYaw(orbit_camera.GetYaw(), moveYaw); + actor.SetSpeed(340.0f * float(main->m_dwMovSpd) / 100.0f); + if (keyboardMoving) { + actor.ClearMoveTarget(); + actor.MoveInDirection(moveYaw, dt, active_terrain, active_map_objects); + } else { + if (wasKeyboardMoving) actor.StopMoving(); + if (actor.CanAct() && ava2::IsPlayerMouseMoving() && renderer3d && active_terrain) { + long mouseX=0, mouseY=0; + UI::CWindowManager::Instance().GetMousePosition(mouseX,mouseY); + float pickX=0,pickY=0,pickZ=0; + if (renderer3d->PickTerrain(float(mouseX),float(mouseY),*active_terrain,pickX,pickY,pickZ)) + actor.SetMoveTarget(pickX,pickZ); + } + } + if (!actor.CanAct()) { actor.ClearMoveTarget(); actor.StopMoving(); } + const bool moving = keyboardMoving || actor.HasMoveTarget(); + const uint32_t now = ava2::GetServerMSec(); + if ((moving && (!wasMoving || now-lastMoveSent>=100)) || (!moving && wasMoving)) { + ava2::PythonNetworkStream::Instance().SendCharacterMovePacket(moving?1:0,0, + uint8_t(std::fmod(actor.GetYaw()+360.0f,360.0f)/5.0f), + int32_t(actor.GetX()),int32_t(actor.GetZ()),now); + lastMoveSent = now; + } + wasKeyboardMoving = keyboardMoving; wasMoving = moving; + main->m_lCurX=int32_t(actor.GetX()); main->m_lCurY=int32_t(actor.GetZ()); main->m_lCurZ=int32_t(actor.GetY()); + ava2::TextTailManager::Instance().SetCharacterPosition(main->m_dwVID,actor.GetX(),actor.GetY(),actor.GetZ()); + player_world_x = actor.GetX(); + player_world_y = actor.GetY(); + player_world_z = actor.GetZ(); + player_world_yaw = actor.GetYaw(); + ava2::SetMainCharacterPosition(player_world_x, player_world_z, player_world_y); + ava2::SoundManager::Instance().SetPosition(player_world_x, player_world_y, player_world_z); + } + } +#endif + if (last_phase == "game") { uint32_t clear_col = current_env.fog.GetColorUint(); uint8_t cr = (clear_col >> 16) & 0xFF; @@ -1633,10 +1942,11 @@ int main(int argc, char** argv) { // 3D Model & Terrain Rendering (Python-driven characters + outdoor terrain + fallback) if (renderer3d && surface3d && texture3d) { #ifdef AVA2_HAS_PYTHON - auto draws = (last_phase == "game") ? std::vector{} : ava2::GetAllActiveChrDraws(); + auto draws = (last_phase == "game") ? std::vector{} : (original_phase_mode ? std::vector{} : ava2::GetAllActiveChrDraws()); #else std::vector draws; #endif + const auto profileBuildStart = std::chrono::steady_clock::now(); if (last_phase == "game") { // Update outdoor SkyBox, Clouds UV scrolling & dynamic environment outdoor_skybox.Update(0.033f); @@ -1646,39 +1956,100 @@ int main(int argc, char** argv) { uint32_t fog_color_u = current_env.fog.GetColorUint(); renderer3d->SetFog(current_env.fog.enable, fog_color_u, 0.00010f, current_env.fog.near_dist, current_env.fog.far_dist, false); + #ifdef AVA2_HAS_PYTHON + float requestedDistance,requestedPitch,requestedYaw,requestedHeight; + if (!preview_data && ava2::ConsumeCameraSetting(requestedDistance,requestedPitch,requestedYaw,requestedHeight)) { + orbit_camera.SetDistance(requestedDistance);orbit_camera.SetPitch(requestedPitch); + orbit_camera.SetYaw(requestedYaw);orbit_camera.SetTargetHeight(requestedHeight); + } +#endif // Third-person orbit camera following player (40250 CCamera) - orbit_camera.SetTarget(player_world_x, player_actor.GetY(), player_world_z); - orbit_camera.UpdateWithTerrain(&outdoor_terrain); + orbit_camera.SetTarget(player_world_x, player_world_y, player_world_z); + orbit_camera.UpdateWithTerrain(active_terrain); + orbit_camera.ApplyToRenderer(*renderer3d); - renderer3d->SetPerspective(50.0f, static_cast(view3d_w) / static_cast(view3d_h), 1.0f, 6000.0f); +#ifdef AVA2_HAS_PYTHON + if (!preview_data) ava2::UpdateCameraFromHost(orbit_camera.GetDistance(),orbit_camera.GetPitch(),orbit_camera.GetYaw(),orbit_camera.GetTargetHeight()); +#endif + + float fov = 50.0f; +#ifdef AVA2_HAS_PYTHON + float sys_fov = ava2::CPythonSystem::Instance().GetFOVLevel(); + if (sys_fov > 10.0f) { + fov = sys_fov; + } + float far_clip = std::max(12000.0f, ava2::CPythonBackground::Instance().GetFarClip()); +#else + float far_clip = 6000.0f; +#endif + renderer3d->SetPerspective(fov, static_cast(view3d_w) / static_cast(view3d_h), 1.0f, far_clip); auto& ttm = ava2::TextTailManager::Instance(); - ttm.UpdateAllTextTail(player_world_x, player_actor.GetY(), player_world_z, renderer3d.get()); + ttm.UpdateAllTextTail(player_world_x, player_world_y, player_world_z, renderer3d.get()); ttm.UpdateShowingTextTail(renderer3d.get()); ttm.ArrangeTextTail(); float eyeX = 0.0f, eyeY = 0.0f, eyeZ = 0.0f; renderer3d->GetEyePosition(eyeX, eyeY, eyeZ); - - // 1. SkyDome, Scrolling Clouds, and Sun Flare (drawn first with depth-write disabled) - auto sky_draws = outdoor_skybox.BuildDrawCommands(renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix(), eyeX, eyeY, eyeZ); - for (auto& sd : sky_draws) { - draws.push_back(std::move(sd)); + if (until_game && (rendered_game_frames == 0 || rendered_game_frames + 1 == game_frames)) { + SDL_Log("World camera target=(%.0f,%.0f,%.0f) eye=(%.0f,%.0f,%.0f) distance=%.0f terrain=(%.0f,%.0f)", + player_world_x, player_world_y, player_world_z, eyeX, eyeY, eyeZ, + orbit_camera.GetDistance(), active_terrain->GetWorldMinX(), active_terrain->GetWorldMinZ()); } - // 2. Game phase: render outdoor terrain with quadtree culling & multi-texture patches - auto terrain_draws = outdoor_terrain.BuildCulledDraws(renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix(), 8000.0f); - if (terrain_draws.empty()) { - auto td = outdoor_terrain.BuildDrawCommand(nullptr, 2); - td.light_direction[0] = current_env.dir_light.direction[0]; - td.light_direction[1] = current_env.dir_light.direction[1]; - td.light_direction[2] = current_env.dir_light.direction[2]; - td.light_ambient[0] = std::max(0.35f, current_env.dir_light.bg_ambient[0]); - td.light_ambient[1] = std::max(0.35f, current_env.dir_light.bg_ambient[1]); - td.light_ambient[2] = std::max(0.38f, current_env.dir_light.bg_ambient[2]); - draws.push_back(std::move(td)); - } else { - for (auto& td : terrain_draws) { +#ifdef AVA2_HAS_PYTHON + bool bg_rendered = false; + if (ava2::CPythonBackground::Instance().IsMapReady()) { + ava2::CPythonBackground::Instance().Update(eyeX, eyeY, eyeZ); + float camPos[3] = {eyeX, eyeY, eyeZ}; + ava2::CPythonBackground::Instance().BuildDrawCommands(renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix(), camPos, draws); + bg_rendered = true; + } + if (!bg_rendered) +#endif + { + // 1. SkyDome, Scrolling Clouds, and Sun Flare (drawn first with depth-write disabled) + auto sky_draws = outdoor_skybox.BuildDrawCommands(renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix(), eyeX, eyeY, eyeZ); + for (auto& sd : sky_draws) { + draws.push_back(std::move(sd)); + } + + // 2. Game phase: render outdoor terrain with quadtree culling & multi-texture patches + auto terrain_draws = outdoor_terrain.BuildCulledDraws(renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix(), 8000.0f); + if (terrain_draws.empty()) { + auto td = outdoor_terrain.BuildDrawCommand(nullptr, 2); + td.light_direction[0] = current_env.dir_light.direction[0]; + td.light_direction[1] = current_env.dir_light.direction[1]; + td.light_direction[2] = current_env.dir_light.direction[2]; + td.light_ambient[0] = std::max(0.35f, current_env.dir_light.bg_ambient[0]); + td.light_ambient[1] = std::max(0.35f, current_env.dir_light.bg_ambient[1]); + td.light_ambient[2] = std::max(0.38f, current_env.dir_light.bg_ambient[2]); + draws.push_back(std::move(td)); + } else { + for (auto& td : terrain_draws) { + td.light_direction[0] = current_env.dir_light.direction[0]; + td.light_direction[1] = current_env.dir_light.direction[1]; + td.light_direction[2] = current_env.dir_light.direction[2]; + td.light_ambient[0] = std::max(0.35f, current_env.dir_light.bg_ambient[0]); + td.light_ambient[1] = std::max(0.35f, current_env.dir_light.bg_ambient[1]); + td.light_ambient[2] = std::max(0.38f, current_env.dir_light.bg_ambient[2]); + draws.push_back(std::move(td)); + } + } + + // Add water surface (translucent, animated) + if (outdoor_water.HasWater()) { + float anim_time = static_cast(frames) * 0.033f; + auto water_draw = outdoor_water.BuildDrawCommand(anim_time); + draws.push_back(std::move(water_draw)); + } + + auto bldg_draws = map_objects.BuildDrawCommands(renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix()); + for (auto& bd : bldg_draws) draws.push_back(std::move(bd)); + + // Add outdoor forest trees, pines, and vegetation (SpeedTree Engine) + auto tree_draws = outdoor_forest.BuildDrawCommands(renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix(), eyeX, eyeY, eyeZ, 6000.0f); + for (auto& td : tree_draws) { td.light_direction[0] = current_env.dir_light.direction[0]; td.light_direction[1] = current_env.dir_light.direction[1]; td.light_direction[2] = current_env.dir_light.direction[2]; @@ -1689,44 +2060,82 @@ int main(int argc, char** argv) { } } - // Add water surface (translucent, animated) - if (outdoor_water.HasWater()) { - float anim_time = static_cast(frames) * 0.033f; - auto water_draw = outdoor_water.BuildDrawCommand(anim_time); - draws.push_back(std::move(water_draw)); - } - - auto bldg_draws = map_objects.BuildDrawCommands(); - for (auto& bd : bldg_draws) draws.push_back(std::move(bd)); - - // Add outdoor forest trees, pines, and vegetation (SpeedTree Engine) - auto tree_draws = outdoor_forest.BuildDrawCommands(renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix(), eyeX, eyeY, eyeZ, 6000.0f); - for (auto& td : tree_draws) { - td.light_direction[0] = current_env.dir_light.direction[0]; - td.light_direction[1] = current_env.dir_light.direction[1]; - td.light_direction[2] = current_env.dir_light.direction[2]; - td.light_ambient[0] = std::max(0.35f, current_env.dir_light.bg_ambient[0]); - td.light_ambient[1] = std::max(0.35f, current_env.dir_light.bg_ambient[1]); - td.light_ambient[2] = std::max(0.38f, current_env.dir_light.bg_ambient[2]); - draws.push_back(std::move(td)); + // Soft circular ground shadows + bool enable_shadows = true; +#ifdef AVA2_HAS_PYTHON + enable_shadows = ava2::CPythonSystem::Instance().IsShadow(); +#endif + if (enable_shadows) { + const ava2::TerrainHeightmap* shadow_terrain = (last_phase == "select" || last_phase == "create") ? nullptr : active_terrain; + if (preview_data) draws.push_back(BuildGroundShadowDraw(player_actor.GetX(), player_actor.GetY(), player_actor.GetZ(), 45.0f, shadow_terrain)); + if (preview_data) { + if (!mob_dog.IsDead()) { + draws.push_back(BuildGroundShadowDraw(mob_dog.GetX(), mob_dog.GetY(), mob_dog.GetZ(), 35.0f, shadow_terrain)); + } + if (!mob_metin.IsDead()) { + draws.push_back(BuildGroundShadowDraw(mob_metin.GetX(), mob_metin.GetY(), mob_metin.GetZ(), 65.0f, shadow_terrain)); + } + } + for (const auto& [vid, actorData] : ava2::NetworkActorManager::Instance().GetActorDict()) { + if (actorData.m_pActorInstance && !actorData.m_isHidden) { + draws.push_back(BuildGroundShadowDraw( + actorData.m_pActorInstance->GetX(), + actorData.m_pActorInstance->GetY(), + actorData.m_pActorInstance->GetZ(), + 45.0f, + shadow_terrain + )); + } + } } // Add animated player actor - auto char_draws = player_actor.BuildDrawCommands(); + auto char_draws = preview_data ? player_actor.BuildDrawCommands() : std::vector{}; + auto dog_draws = preview_data ? mob_dog.BuildDrawCommands() : std::vector{}; + auto metin_draws = preview_data ? mob_metin.BuildDrawCommands() : std::vector{}; + auto net_draws = ava2::NetworkActorManager::Instance().BuildDrawCommands(static_cast(frames) * 0.033f, renderer3d->GetViewMatrix(), renderer3d->GetProjMatrix()); + if (until_game && rendered_game_frames == 20) { + for (const auto& entry : ava2::NetworkActorManager::Instance().GetActorDict()) { + const auto& npc=entry.second; + if (npc.m_dwVirtualNumber >= 61000 && npc.m_dwVirtualNumber <= 61007 && npc.m_pActorInstance) + SDL_Log("NPC appearance source=%u race=%u armor=%u model=%s", npc.m_dwVirtualNumber, npc.m_dwRace, npc.m_dwArmor, npc.m_pActorInstance->GetShapeModelFile().c_str()); + } + } + + auto apply_char_lighting = [&](std::vector& dlist) { + for (auto& cd : dlist) { + cd.light_direction[0] = current_env.dir_light.direction[0]; + cd.light_direction[1] = current_env.dir_light.direction[1]; + cd.light_direction[2] = current_env.dir_light.direction[2]; + cd.light_ambient[0] = std::max(0.55f, current_env.dir_light.chr_ambient[0]); + cd.light_ambient[1] = std::max(0.55f, current_env.dir_light.chr_ambient[1]); + cd.light_ambient[2] = std::max(0.58f, current_env.dir_light.chr_ambient[2]); + cd.light_diffuse[0] = current_env.dir_light.chr_diffuse[0]; + cd.light_diffuse[1] = current_env.dir_light.chr_diffuse[1]; + cd.light_diffuse[2] = current_env.dir_light.chr_diffuse[2]; + cd.material_ambient[0] = 0.85f; + cd.material_ambient[1] = 0.85f; + cd.material_ambient[2] = 0.85f; + cd.material_emissive[0] = 0.05f; + cd.material_emissive[1] = 0.05f; + cd.material_emissive[2] = 0.05f; + } + }; + apply_char_lighting(char_draws); for (auto& cd : char_draws) draws.push_back(std::move(cd)); if (preview_data) { - // Add animated Wild Dog - auto dog_draws = mob_dog.BuildDrawCommands(); - for (auto& dd : dog_draws) draws.push_back(std::move(dd)); - - // Add animated Metin Stone - auto metin_draws = mob_metin.BuildDrawCommands(); - for (auto& md : metin_draws) draws.push_back(std::move(md)); + if (!mob_dog.IsDead()) { + apply_char_lighting(dog_draws); + for (auto& dd : dog_draws) draws.push_back(std::move(dd)); + } + if (!mob_metin.IsDead()) { + apply_char_lighting(metin_draws); + for (auto& md : metin_draws) draws.push_back(std::move(md)); + } } - // Add Network Actors (e.g. ally SuraMage) - auto net_draws = ava2::NetworkActorManager::Instance().BuildDrawCommands(static_cast(frames) * 0.033f); + apply_char_lighting(net_draws); for (auto& nd : net_draws) draws.push_back(std::move(nd)); // Add Particle effects, projectiles, and weapon ribbon trails @@ -1738,19 +2147,23 @@ int main(int argc, char** argv) { } } else { renderer3d->SetFog(false); - // Select / Create showcase camera - renderer3d->SetCameraLookAt(0.0f, 130.0f, -320.0f, 0.0f, 100.0f, 0.0f, 0.0f, 1.0f, 0.0f); - renderer3d->SetPerspective(45.0f, static_cast(view3d_w) / static_cast(view3d_h), 1.0f, 2000.0f); + if (!original_phase_mode) { + // Select / Create showcase camera + renderer3d->SetCameraLookAt(0.0f, 130.0f, -320.0f, 0.0f, 100.0f, 0.0f, 0.0f, 1.0f, 0.0f); + renderer3d->SetPerspective(45.0f, static_cast(view3d_w) / static_cast(view3d_h), 1.0f, 2000.0f); - if (draws.empty() && model3d) { - float angle = static_cast(frames) * 1.5f; - float world[16]; - ava2::MakeTransformMatrix(angle, 0.0f, 0.0f, 0.0f, 1.0f, world); - draws = model3d->BuildDrawCommands(-1.0f, world); + if (draws.empty() && model3d) { + float angle = static_cast(frames) * 1.5f; + float world[16]; + ava2::MakeTransformMatrix(angle, 0.0f, 0.0f, 0.0f, 1.0f, world); + draws = model3d->BuildDrawCommands(-1.0f, world); + } } } + profileBuildMs = std::chrono::duration(std::chrono::steady_clock::now()-profileBuildStart).count(); if (!draws.empty()) { + const auto profileRasterStart = std::chrono::steady_clock::now(); uint32_t clear_col = (last_phase == "game") ? current_env.fog.GetColorUint() : 0x00000000; if (use_gpu_raster) { // High Performance Hardware-Accelerated GPU Pipeline (Metal / Vulkan via SDL_RenderGeometry) @@ -1778,8 +2191,9 @@ int main(int argc, char** argv) { SDL_RenderTexture(renderer.get(), texture3d.get(), nullptr, &dst); } + profileRasterMs = std::chrono::duration(std::chrono::steady_clock::now()-profileRasterStart).count(); // Render Minimap Radar HUD in game phase (modeled after 40250 CPythonMiniMap) - if (last_phase == "game") { + if (last_phase == "game" && preview_data) { minimap_mgr.ClearBlips(); if (preview_data) { if (!mob_dog.IsDead()) { @@ -1826,8 +2240,8 @@ int main(int argc, char** argv) { } graphicDevice.EndScene(false); - if (last_phase == "game" && renderer3d) { - target_mgr.Render(renderer.get(), *renderer3d, &outdoor_terrain); + if (last_phase == "game" && renderer3d && preview_data) { + target_mgr.Render(renderer.get(), *renderer3d, active_terrain); ava2::TextTailManager::Instance().ShowAllTextTail(); ava2::TextTailManager::Instance().Render(renderer.get(), renderer3d.get()); floating_text_mgr.Render(renderer.get(), *renderer3d); @@ -1840,7 +2254,7 @@ int main(int argc, char** argv) { } } - if (original_phase_mode) { + if (original_phase_mode && preview_data) { // Informative header for interactive mode SDL_SetRenderDrawColor(renderer.get(), 200, 220, 240, 200); std::string hud; @@ -1891,7 +2305,10 @@ int main(int argc, char** argv) { if (view_script.empty()) { if (until_loading && last_phase == "loading") finished = true; if (until_select && last_phase == "select") finished = true; - if (until_game && last_phase == "game") finished = true; + if (last_phase == "game") { + ++rendered_game_frames; + if (until_game && rendered_game_frames >= game_frames) finished = true; + } } else { if (until_loading && snapshot.phase == "loading") finished = true; if (until_select && snapshot.phase == "select") finished = true; @@ -1909,18 +2326,52 @@ int main(int argc, char** argv) { throw std::runtime_error(SDL_GetError()); } + // Pace presentation, not the start of drawing: a varying scene cost + // must not turn a steady 60 Hz update loop into uneven visible frames. + const auto profilePacingStart = std::chrono::steady_clock::now(); + if (cap_period.count() > 0) { + const auto now = std::chrono::steady_clock::now(); + if (next_frame_at > now) { + SDL_DelayPrecise(std::chrono::duration_cast(next_frame_at-now).count()); + } else if (now-next_frame_at > cap_period) { + next_frame_at = now; + } + next_frame_at += cap_period; + } + const auto profilePresentStart = std::chrono::steady_clock::now(); if (!SDL_RenderPresent(renderer.get())) throw std::runtime_error(SDL_GetError()); + if (until_game && last_phase == "game" && rendered_game_frames % 20 == 0) + SDL_Log("Frame profile total=%.2f build=%.2f raster=%.2f active=%.2f present=%.2f ms", + std::chrono::duration(std::chrono::steady_clock::now()-profileFrameStart).count(), profileBuildMs, profileRasterMs, + std::chrono::duration(profilePacingStart-profileActiveStart+std::chrono::steady_clock::now()-profilePresentStart).count(), + std::chrono::duration(std::chrono::steady_clock::now()-profilePresentStart).count()); + if(!frame_profile.empty() && last_phase=="game" && rendered_game_frames%120==0 && renderer3d) { + SDL_Log("Resource profile decoded=%zu gpuTextures=%zu decodes=%zu uploads=%zu",renderer3d->GetDecodedTextureBytes(),renderer3d->GetHardwareTextureBytes(),renderer3d->GetTextureDecodeCount(),renderer3d->GetHardwareTextureUploadCount()); + if(active_map_objects)SDL_Log("Collision profile candidates=%zu objects=%zu",active_map_objects->GetLastCollisionCandidateCount(),active_map_objects->GetObjectCount()); +#ifdef AVA2_HAS_PYTHON + if(python)SDL_Log("Python code profile entries=%zu bytes=%zu compilations=%zu",python->compiled_code_count(),python->compiled_code_bytes(),python->compilation_count()); +#endif + } + const auto profileEnd = std::chrono::steady_clock::now(); + if (profileOutput) profileOutput << last_phase << ',' << rendered_game_frames << ',' + << std::chrono::duration(profileEnd-profilePreviousEnd).count() << ',' + << std::chrono::duration(profilePacingStart-profileActiveStart+profileEnd-profilePresentStart).count() << ',' + << profileBuildMs << ',' << profileRasterMs << ',' + << std::chrono::duration(profileEnd-profilePresentStart).count() << '\n'; + profilePreviousEnd = profileEnd; ++frames; if (finished) running = false; } #ifdef AVA2_HAS_PYTHON - graphicDevice.Init(nullptr); // CPythonApplication::Destroy: SaveConfig, then SaveInterfaceStatus while Python is alive. if (python) { ava2::CPythonSystem::Instance().SaveConfig(); ava2::CPythonSystem::Instance().SaveInterfaceStatus(); + // Release UI/minimap image resources while their SDL renderer is still alive. + python.reset(); } + graphicDevice.Init(nullptr); #endif ava2::SoundManager::Instance().Destroy(); SDL_StopTextInput(window.get()); diff --git a/src/player_settings.cpp b/src/player_settings.cpp index a6b39d2e..b70c10b2 100644 --- a/src/player_settings.cpp +++ b/src/player_settings.cpp @@ -9,11 +9,37 @@ // read as EFFECT_* offsets) are kept: RegisterEffect rejects them exactly like Windows does. // Emoticon chat strings are the original CP949 bytes. #include "player_settings.h" +#include "python_gameplay_modules.h" #include "item_sound.h" #include "eter_net/NetworkActorManager.h" #include "eter_net/PythonNetworkStream.h" namespace ava2 { +void RegisterPlayerSkills(uint8_t race, uint8_t group, uint8_t empire) { + // AVA2 PythonPlayerSettingsModule.h::m_vecSkillIndex, not the 40250 + // defaults: slot 9 is the ninth skill, horse slots start at 10 and the + // support list has AVA2's inspiration/charisma/auto-attack entries. + const unsigned job = race < 8 ? race % 4 : 4; + if (job < 4 && (group == 1 || group == 2)) { + const int first = int(job) * 30 + (group == 2 ? 16 : 1); + for (int slot = 1; slot <= 6; ++slot) SetPlayerSkill(slot, first + slot - 1); + // Slots 7 and 8 are assigned by RecvSkillLevelNew (ward / boost). + const int ninth[4][2] = {{176,176}, {177,178}, {179,180}, {181,182}}; + SetPlayerSkill(9, ninth[job][group - 1]); + const int horse[] = {137,0,138,0,139,0}; + for (int i = 0; i < 6; ++i) SetPlayerSkill(10 + i, horse[i]); + if (job == 1) SetPlayerSkill(16, 140); + const int support[] = {0,0,121,134,133,129,130,131,123,124,122,132,246}; + for (int i = 0; i < 13; ++i) SetPlayerSkill(101 + i, support[i]); + } + if (empire >= 1 && empire <= 3) { + int slot = 101; + for (int language = 1; language <= 3; ++language) + if (language != empire) SetPlayerSkill(slot++, 125 + language); + } + SetPlayerSkill(200, 151); + for (int i = 0; i < 6; ++i) SetPlayerSkill(210 + i, 152 + i); +} namespace { struct TCacheEffect { unsigned type; const char* bone; const char* file; bool cache; }; struct TEmoticon { unsigned type; const char* bone; const char* file; const char* chat; }; diff --git a/src/player_settings.h b/src/player_settings.h index 98fce397..c7036b33 100644 --- a/src/player_settings.h +++ b/src/player_settings.h @@ -1,5 +1,7 @@ #pragma once +#include namespace ava2 { // CPythonPlayerSettingsModule effect / emoticon / item-sound registration (AVA2 app.Create). void LoadPlayerSettings(); +void RegisterPlayerSkills(uint8_t race, uint8_t group, uint8_t empire); } diff --git a/src/python_app.cpp b/src/python_app.cpp index bedb2d7e..bfcf0c26 100644 --- a/src/python_app.cpp +++ b/src/python_app.cpp @@ -21,6 +21,9 @@ #include "eter_ui/PythonWindowManager.h" #include "eter_effect/EffectManager.h" #include "eter_effect/FlyingManager.h" +#include "eter_render/TextTailManager.h" +#include "eter_render/Gr2ModelRenderer.h" +#include #include #include #include @@ -32,6 +35,8 @@ #include #include #include +#include +#include "eter_net/PythonNetworkStream.h" #include "eter_resource/ResourceManager.h" namespace ava2 { @@ -43,12 +48,14 @@ ServerClock server_clock(local_milliseconds()); // EterBase Timer.cpp gs_dwServerTime / gs_dwClientTime (ELTimer_*ServerMSec), separate from app.GetGlobalTime. std::uint32_t elt_server_time=0,elt_client_time=0; auto app_start=std::chrono::steady_clock::now(); +bool s_cameraSettingPending = false; float s_camera_distance = 1500.0f; float s_camera_pitch = 30.0f; float s_camera_rotation = 0.0f; float s_camera_height = 180.0f; float s_camera_max_distance = 2500.0f; int s_camera_speed = 100; +int cameraRotateInput=0, cameraPitchInput=0, cameraZoomInput=0; float s_camera_rotate_speed = 1.0f; float s_camera_pitch_speed = 1.0f; float s_camera_zoom_speed = 0.05f; @@ -79,6 +86,26 @@ PyObject* app_get_global_timestamp(PyObject*, PyObject*) { return PyInt_FromLong(server_clock.timestamp(unix_seconds())); } +static float s_centerX = 0.0f, s_centerY = 0.0f, s_centerZ = 0.0f; +static void SyncCameraToRenderer() { + auto* renderer3d = TextTailManager::Instance().GetCurrentSceneRenderer(); + if (!renderer3d) return; + constexpr float DEG_TO_RAD = 3.14159265358979323846f / 180.0f; + float pitchRad = s_camera_pitch * DEG_TO_RAD; + float rotRad = s_camera_rotation * DEG_TO_RAD; + float horiz = s_camera_distance * std::cos(pitchRad); + float vert = s_camera_distance * std::sin(pitchRad); + float targetX = s_centerX; + float targetY = s_centerY + s_camera_height; + float targetZ = s_centerZ; + float eyeX = targetX - horiz * std::sin(rotRad); + float eyeY = targetY + vert; + // Windows starts at (0, -distance, 0) and rotates about native Z. + // Native Y maps to -engine Z; CCamera also uses a RH view matrix. + float eyeZ = targetZ + horiz * std::cos(rotRad); + renderer3d->SetCameraLookAtRH(eyeX, eyeY, eyeZ, targetX, targetY, targetZ, 0.0f, 1.0f, 0.0f); +} + PyObject* app_set_camera(PyObject*, PyObject* args) { float Distance = 0.0f, Pitch = 0.0f, Rotation = 0.0f, DestinationHeight = 0.0f; if (!PyTuple_GetFloat(args, 0, &Distance) || @@ -91,6 +118,8 @@ PyObject* app_set_camera(PyObject*, PyObject* args) { s_camera_pitch = Pitch; s_camera_rotation = Rotation; s_camera_height = DestinationHeight; + s_cameraSettingPending = true; + SyncCameraToRenderer(); return Py_BuildNone(); } @@ -110,7 +139,7 @@ PyObject* app_rotate_camera(PyObject*, PyObject* args) { int iDirection = 0; if (!PyTuple_GetInteger(args, 0, &iDirection)) return Py_BuildException(); - s_camera_rotation += s_camera_rotate_speed * static_cast(iDirection); + cameraRotateInput = iDirection; return Py_BuildNone(); } @@ -118,7 +147,7 @@ PyObject* app_pitch_camera(PyObject*, PyObject* args) { int iDirection = 0; if (!PyTuple_GetInteger(args, 0, &iDirection)) return Py_BuildException(); - s_camera_pitch += s_camera_pitch_speed * static_cast(iDirection); + cameraPitchInput = iDirection; return Py_BuildNone(); } @@ -126,9 +155,7 @@ PyObject* app_zoom_camera(PyObject*, PyObject* args) { int iDirection = 0; if (!PyTuple_GetInteger(args, 0, &iDirection)) return Py_BuildException(); - s_camera_distance *= (1.0f + s_camera_zoom_speed * static_cast(iDirection)); - if (s_camera_distance > s_camera_max_distance) s_camera_distance = s_camera_max_distance; - if (s_camera_distance < 100.0f) s_camera_distance = 100.0f; + cameraZoomInput = iDirection; return Py_BuildNone(); } @@ -136,7 +163,7 @@ PyObject* app_movie_rotate_camera(PyObject*, PyObject* args) { int iDirection = 0; if (!PyTuple_GetInteger(args, 0, &iDirection)) return Py_BuildException(); - s_camera_rotation += s_camera_rotate_speed * static_cast(iDirection); + cameraRotateInput = iDirection; return Py_BuildNone(); } @@ -144,7 +171,7 @@ PyObject* app_movie_pitch_camera(PyObject*, PyObject* args) { int iDirection = 0; if (!PyTuple_GetInteger(args, 0, &iDirection)) return Py_BuildException(); - s_camera_pitch += s_camera_pitch_speed * static_cast(iDirection); + cameraPitchInput = iDirection; return Py_BuildNone(); } @@ -228,6 +255,7 @@ PyObject* app_set_default_camera(PyObject*, PyObject*) { s_camera_pitch = 30.0f; s_camera_rotation = 0.0f; s_camera_height = 180.0f; + s_cameraSettingPending = true; return Py_BuildNone(); } @@ -288,6 +316,7 @@ PyObject* app_get_cursor_position(PyObject*, PyObject*) { return Py_BuildValue("ii", lx, ly); } +static float gameFrameDelta = 0.033f; PyObject* app_update_game(PyObject*, PyObject*) { long lx = 0, ly = 0; UI::CWindowManager::Instance().GetMousePosition(lx, ly); @@ -299,7 +328,7 @@ PyObject* app_update_game(PyObject*, PyObject*) { camZ = static_cast(mainActor->m_lCurZ); } CPythonBackground::Instance().Update(camX, camY, camZ); - float dt = 0.033f; + float dt = gameFrameDelta; NetworkActorManager::Instance().Update(dt, CPythonBackground::Instance().GetTerrain()); EffectManager::Instance().Update(dt); static float s_flyingTime = 0.0f; @@ -350,8 +379,20 @@ PyObject* app_create(PyObject*, PyObject* args) { Py_RETURN_NONE; } PyObject* app_loop(PyObject*, PyObject*) { Py_RETURN_NONE; } -PyObject* app_exit(PyObject*, PyObject*) { Py_RETURN_NONE; } -PyObject* app_abort(PyObject*, PyObject*) { Py_RETURN_NONE; } +PyObject* app_exit(PyObject*, PyObject*) { + PythonNetworkStream::Instance().RequestQuit(); + SDL_Event ev{}; + ev.type = SDL_EVENT_QUIT; + SDL_PushEvent(&ev); + Py_RETURN_NONE; +} +PyObject* app_abort(PyObject*, PyObject*) { + PythonNetworkStream::Instance().RequestQuit(); + SDL_Event ev{}; + ev.type = SDL_EVENT_QUIT; + SDL_PushEvent(&ev); + Py_RETURN_NONE; +} PyObject* app_is_pressed(PyObject*, PyObject* args) { return PyInt_FromLong(0); } PyObject* app_get_locale_service_name(PyObject*, PyObject*) { @@ -441,13 +482,16 @@ PyObject* app_set_guild_mark_path(PyObject*, PyObject* args) { } // namespace +void GetCameraInput(int& rotate,int& pitch,int& zoom) { rotate=cameraRotateInput; pitch=cameraPitchInput; zoom=cameraZoomInput; } +void StopCameraInput() { cameraRotateInput=cameraPitchInput=cameraZoomInput=0; } +void SetGameFrameDelta(float dt) { gameFrameDelta = std::clamp(dt, 0.001f, 0.25f); } std::int32_t GetServerTimeStamp() { return server_clock.timestamp(unix_seconds()); } void SetServerTime(std::int32_t time) { server_clock.set(time,local_milliseconds(),unix_seconds()); } std::uint32_t GetLocalMSec() { return local_milliseconds(); } std::int32_t GetApplicationSeconds() { return static_cast(std::chrono::duration_cast(std::chrono::steady_clock::now()-app_start).count()); } void SetServerMSec(std::uint32_t time) { if(time==0) return;elt_server_time=time;elt_client_time=local_milliseconds(); ELTimer_SetServerMSec(time); } std::uint32_t GetServerMSec() { return local_milliseconds()-elt_client_time+elt_server_time; } -void ResetPythonAppState() { elt_server_time=elt_client_time=0;ELTimer_Init();server_clock=ServerClock(local_milliseconds());app_start=std::chrono::steady_clock::now();s_test_server_flag=false;twoHandedAttackSpeedDecrease=0; } +void ResetPythonAppState() { s_cameraSettingPending=false; elt_server_time=elt_client_time=0;ELTimer_Init();server_clock=ServerClock(local_milliseconds());app_start=std::chrono::steady_clock::now();s_test_server_flag=false;twoHandedAttackSpeedDecrease=0; } std::uint8_t GetEnterGameLanguage() { const char* locales[]={"ymir","en","de","tr","pt","es","fr","ro","pl","it","cz","hu"}; for(std::uint8_t i=1;i<12;++i) if(s_locale_name==locales[i]) return i; @@ -468,7 +512,6 @@ static float s_minFog = 0.0f; static bool s_frameSkip = false; static int s_fps = 60; static int s_globalCenterX = 0, s_globalCenterY = 0; -static float s_centerX = 0.0f, s_centerY = 0.0f, s_centerZ = 0.0f; static int s_cursorNum = 0; static bool s_cursorVisible = true; static bool s_softwareCursor = false; @@ -627,7 +670,8 @@ static PyObject* app_set_global_center_position(PyObject*, PyObject* args) { static PyObject* app_set_center_position(PyObject*, PyObject* args) { float x = 0.0f, y = 0.0f, z = 0.0f; if (!PyTuple_GetFloat(args, 0, &x) || !PyTuple_GetFloat(args, 1, &y) || !PyTuple_GetFloat(args, 2, &z)) return Py_BuildException(); - s_centerX = x; s_centerY = y; s_centerZ = z; + s_centerX = x; s_centerY = z; s_centerZ = -y; + SyncCameraToRenderer(); return Py_BuildNone(); } static PyObject* app_run_python_file(PyObject*, PyObject* args) { @@ -973,6 +1017,11 @@ void initapp() { {nullptr, nullptr, 0, nullptr} }; auto* module = Py_InitModule("app", methods); +#ifdef __ANDROID__ + PyModule_AddIntConstant(module, "ENABLE_MOBILE_HUD", 1); +#else + PyModule_AddIntConstant(module, "ENABLE_MOBILE_HUD", 0); +#endif register_app_constants(module); #ifdef ENABLE_MANAGER_BANK_SYSTEM @@ -1032,6 +1081,15 @@ void initapp() { PyModule_AddIntConstant(module, "DIK_LEFT", 0xCB); PyModule_AddIntConstant(module, "DIK_RIGHT", 0xCD); + // Virtual Keys + PyModule_AddIntConstant(module, "VK_LEFT", 0x25); + PyModule_AddIntConstant(module, "VK_UP", 0x26); + PyModule_AddIntConstant(module, "VK_RIGHT", 0x27); + PyModule_AddIntConstant(module, "VK_DOWN", 0x28); + PyModule_AddIntConstant(module, "VK_HOME", 0x24); + PyModule_AddIntConstant(module, "VK_END", 0x23); + PyModule_AddIntConstant(module, "VK_DELETE", 0x2E); + PyModule_AddIntConstant(module, "INFO_ITEM", 0); PyModule_AddIntConstant(module, "INFO_ACTOR", 1); PyModule_AddIntConstant(module, "INFO_EFFECT", 2); @@ -1110,6 +1168,15 @@ bool LoadLocaleData(const std::string& localePath) { return true; } +bool ConsumeCameraSetting(float& distance,float& pitch,float& yaw,float& height) { + if (!s_cameraSettingPending) return false; + s_cameraSettingPending=false; + distance=s_camera_distance;pitch=s_camera_pitch;yaw=s_camera_rotation;height=s_camera_height; + return true; +} +void UpdateCameraFromHost(float distance,float pitch,float yaw,float height) { + s_camera_distance=distance;s_camera_pitch=pitch;s_camera_rotation=yaw;s_camera_height=height; +} float GetCameraZoomSpeed() { return s_camera_zoom_speed; } } // namespace ava2 diff --git a/src/python_app.h b/src/python_app.h index 5178ab1c..72c123b2 100644 --- a/src/python_app.h +++ b/src/python_app.h @@ -19,4 +19,9 @@ unsigned GetDefaultCodePage(); // ::LoadLocaleData (AVA2 UserInterface/PythonApplication.cpp), backing app.LoadLocaleData. bool LoadLocaleData(const std::string& localePath); float GetCameraZoomSpeed(); +void SetGameFrameDelta(float dt); +void GetCameraInput(int& rotate,int& pitch,int& zoom); +void StopCameraInput(); +bool ConsumeCameraSetting(float& distance,float& pitch,float& yaw,float& height); +void UpdateCameraFromHost(float distance,float pitch,float yaw,float height); } diff --git a/src/python_background.cpp b/src/python_background.cpp index 40602c37..e9ec048e 100644 --- a/src/python_background.cpp +++ b/src/python_background.cpp @@ -206,12 +206,22 @@ bool CPythonBackground::LoadMap(const std::string& mapName, float x, float y, fl (void)z; Create(); - std::vector base_candidates = { - "map/" + mapName, - mapName, - "Maps/" + mapName, - "build/dev/test-rundir/map/" + mapName - }; + if (m_mapObjects) m_mapObjects->ClearObjects(); + if (m_forest) m_forest->Clear(); + m_water = std::make_unique(); + + for (const auto& property : CResourceManager::GetCandidatePaths("property")) { + if (!std::filesystem::is_directory(property)) continue; + if (m_mapObjects && m_mapObjects->GetPropertyCount() == 0) + m_mapObjects->ScanPropertyDirectory(property); + if (m_forest && m_forest->GetMainTreeCount() == 0) + m_forest->ScanPropertyDirectory(property); + } + std::vector base_candidates; + for (const auto& path : {"map/" + mapName, mapName, "maps/" + mapName}) { + auto candidates = CResourceManager::GetCandidatePaths(path); + base_candidates.insert(base_candidates.end(), candidates.begin(), candidates.end()); + } std::string found_base = ""; for (const auto& base : base_candidates) { @@ -251,6 +261,23 @@ bool CPythonBackground::LoadMap(const std::string& mapName, float x, float y, fl m_outdoorMap.baseX = static_cast(std::atol(base->second[0].c_str())); m_outdoorMap.baseY = static_cast(std::atol(base->second[1].c_str())); } + auto env_it = tokens.find("environment"); + if (env_it != tokens.end() && !env_it->second.empty()) { + std::string env_name = env_it->second[0]; + RegisterEnvironmentData(0, env_name.c_str()); + SetEnvironmentData(0); + } + auto tex_it = tokens.find("textureset"); + if (tex_it != tokens.end() && !tex_it->second.empty()) { + std::string tex_path = tex_it->second[0]; + std::replace(tex_path.begin(), tex_path.end(), '\\', '/'); + for (const auto& candidate : CResourceManager::GetCandidatePaths(CResourceManager::NormalizePath(tex_path.c_str()))) { + if (std::filesystem::is_regular_file(candidate)) { + m_terrain->LoadTextureSet(candidate); + break; + } + } + } } int bx = static_cast(std::floor(x / 25600.0f)); @@ -264,6 +291,9 @@ bool CPythonBackground::LoadMap(const std::string& mapName, float x, float y, fl std::string height_path = block_dir + "/height.raw"; if (std::filesystem::exists(height_path)) { ok = m_terrain->LoadRaw(height_path); + // height.raw includes a one-sample border around each 25600-unit block. + m_terrain->SetWorldOrigin(bx * 25600.0f - m_terrain->GetCellScale(), + by * 25600.0f - m_terrain->GetCellScale()); } std::string tile_path = block_dir + "/tile.raw"; if (std::filesystem::exists(tile_path)) { @@ -273,6 +303,16 @@ bool CPythonBackground::LoadMap(const std::string& mapName, float x, float y, fl if (std::filesystem::exists(attr_path)) { m_terrain->LoadAttr(attr_path); } + std::string areadata_path = block_dir + "/areadata.txt"; + if (std::filesystem::exists(areadata_path) && m_mapObjects) { + m_mapObjects->LoadAreaData(areadata_path, 1.0f, m_forest.get(), true); + } + std::string water_path = block_dir + "/water.wtr"; + if (std::filesystem::exists(water_path) && m_water) { + m_water->LoadWater(water_path, m_terrain ? m_terrain->GetCellScale() : 200.0f, 0.5f, 200.0f, + m_terrain ? m_terrain->GetWorldMinX() : -2560.0f, + m_terrain ? m_terrain->GetWorldMinZ() : -2560.0f); + } } else { // Fallback: look for 000000 or any block in the directory for (const auto& entry : std::filesystem::directory_iterator(found_base)) { @@ -284,15 +324,27 @@ bool CPythonBackground::LoadMap(const std::string& mapName, float x, float y, fl if (std::filesystem::exists(tpath)) m_terrain->LoadTileRaw(tpath); std::string apath = entry.path().string() + "/attr.atr"; if (std::filesystem::exists(apath)) m_terrain->LoadAttr(apath); + std::string adpath = entry.path().string() + "/areadata.txt"; + if (std::filesystem::exists(adpath) && m_mapObjects) { + m_mapObjects->LoadAreaData(adpath, 1.0f, m_forest.get(), true); + } + std::string wpath = entry.path().string() + "/water.wtr"; + if (std::filesystem::exists(wpath) && m_water) { + m_water->LoadWater(wpath, m_terrain ? m_terrain->GetCellScale() : 200.0f, 0.5f, 200.0f, + m_terrain ? m_terrain->GetWorldMinX() : -2560.0f, + m_terrain ? m_terrain->GetWorldMinZ() : -2560.0f); + } break; } } } } - std::string textureset_path = "textureset/metin2_map1.txt"; - if (std::filesystem::exists(textureset_path)) { - m_terrain->LoadTextureSet(textureset_path); + if (m_terrain && m_terrain->GetTextureSet().empty()) { + std::string textureset_path = "textureset/metin2_map1.txt"; + if (std::filesystem::exists(textureset_path)) { + m_terrain->LoadTextureSet(textureset_path); + } } m_strMapName = mapName; @@ -444,16 +496,34 @@ void CPythonBackground::ClearGuildArea() { bool CPythonBackground::RegisterEnvironmentData(int iIndex, const char* pszEnvironmentFileName) { if (!pszEnvironmentFileName) return false; + std::string fname = pszEnvironmentFileName; + std::replace(fname.begin(), fname.end(), '\\', '/'); + + std::string lower_fname = fname; + std::transform(lower_fname.begin(), lower_fname.end(), lower_fname.begin(), ::tolower); + + std::vector candidates = { + fname, + "ymir work/environment/" + fname, + "environment/" + fname, + lower_fname, + "ymir work/environment/" + lower_fname, + "environment/" + lower_fname, + "build/dev/ymir work/environment/" + lower_fname + }; + EnvironmentData env; - if (env.LoadFromFile(pszEnvironmentFileName)) { - m_mapEnvironmentData[iIndex] = env; - return true; - } - std::string text; - try { text = ReadPackedText(pszEnvironmentFileName); } catch (...) {} - if (!text.empty() && env.LoadFromString(text)) { - m_mapEnvironmentData[iIndex] = env; - return true; + for (const auto& path : candidates) { + if (std::filesystem::exists(path) && env.LoadFromFile(path)) { + m_mapEnvironmentData[iIndex] = env; + return true; + } + std::string text; + try { text = ReadPackedText(path); } catch (...) {} + if (!text.empty() && env.LoadFromString(text)) { + m_mapEnvironmentData[iIndex] = env; + return true; + } } return false; } @@ -462,6 +532,9 @@ bool CPythonBackground::SetEnvironmentData(int iIndex) { auto it = m_mapEnvironmentData.find(iIndex); if (it != m_mapEnvironmentData.end()) { m_pCurrentEnvironment = &it->second; + if (m_skybox) { + m_skybox->SetEnvironment(it->second); + } return true; } return false; @@ -518,6 +591,12 @@ void CPythonBackground::DeleteSpecialEffect(uint32_t dwID) { void CPythonBackground::Update(float fCameraX, float fCameraY, float fCameraZ) { (void)fCameraX; (void)fCameraY; (void)fCameraZ; + if (m_skybox) { + m_skybox->Update(0.033f); + } + if (m_forest) { + m_forest->UpdateSystem(0.033f); + } } void CPythonBackground::Render() { @@ -556,6 +635,11 @@ void CPythonBackground::RenderSnow() { void CPythonBackground::BuildDrawCommands(const float* viewMatrix, const float* projMatrix, const float* camPos, std::vector& outDraws) { if (!IsMapReady()) return; + if (m_bVisiblePart[PART_SKY] && m_skybox && viewMatrix && projMatrix && camPos) { + auto sdraws = m_skybox->BuildDrawCommands(viewMatrix, projMatrix, camPos[0], camPos[1], camPos[2]); + for (auto& sd : sdraws) outDraws.push_back(std::move(sd)); + } + if (m_bVisiblePart[PART_TERRAIN] && m_terrain) { std::vector tdraws; if (viewMatrix && projMatrix) { @@ -570,26 +654,55 @@ void CPythonBackground::BuildDrawCommands(const float* viewMatrix, const float* td.light_direction[0] = m_pCurrentEnvironment->dir_light.direction[0]; td.light_direction[1] = m_pCurrentEnvironment->dir_light.direction[1]; td.light_direction[2] = m_pCurrentEnvironment->dir_light.direction[2]; - td.light_ambient[0] = m_pCurrentEnvironment->dir_light.bg_ambient[0]; - td.light_ambient[1] = m_pCurrentEnvironment->dir_light.bg_ambient[1]; - td.light_ambient[2] = m_pCurrentEnvironment->dir_light.bg_ambient[2]; + td.light_ambient[0] = std::max(0.35f, m_pCurrentEnvironment->dir_light.bg_ambient[0]); + td.light_ambient[1] = std::max(0.35f, m_pCurrentEnvironment->dir_light.bg_ambient[1]); + td.light_ambient[2] = std::max(0.38f, m_pCurrentEnvironment->dir_light.bg_ambient[2]); } outDraws.push_back(std::move(td)); } } if (m_bVisiblePart[PART_WATER] && m_water && m_water->HasWater()) { - outDraws.push_back(m_water->BuildDrawCommand(0.0f)); + auto wd = m_water->BuildDrawCommand(0.0f); + if (m_pCurrentEnvironment) { + wd.light_direction[0] = m_pCurrentEnvironment->dir_light.direction[0]; + wd.light_direction[1] = m_pCurrentEnvironment->dir_light.direction[1]; + wd.light_direction[2] = m_pCurrentEnvironment->dir_light.direction[2]; + wd.light_ambient[0] = std::max(0.35f, m_pCurrentEnvironment->dir_light.bg_ambient[0]); + wd.light_ambient[1] = std::max(0.35f, m_pCurrentEnvironment->dir_light.bg_ambient[1]); + wd.light_ambient[2] = std::max(0.38f, m_pCurrentEnvironment->dir_light.bg_ambient[2]); + } + outDraws.push_back(std::move(wd)); } if (m_bVisiblePart[PART_OBJECT] && m_mapObjects) { - auto bdraws = m_mapObjects->BuildDrawCommands(); - for (auto& bd : bdraws) outDraws.push_back(std::move(bd)); + auto bdraws = m_mapObjects->BuildDrawCommands(viewMatrix, projMatrix); + for (auto& bd : bdraws) { + if (m_pCurrentEnvironment) { + bd.light_direction[0] = m_pCurrentEnvironment->dir_light.direction[0]; + bd.light_direction[1] = m_pCurrentEnvironment->dir_light.direction[1]; + bd.light_direction[2] = m_pCurrentEnvironment->dir_light.direction[2]; + bd.light_ambient[0] = std::max(0.35f, m_pCurrentEnvironment->dir_light.bg_ambient[0]); + bd.light_ambient[1] = std::max(0.35f, m_pCurrentEnvironment->dir_light.bg_ambient[1]); + bd.light_ambient[2] = std::max(0.38f, m_pCurrentEnvironment->dir_light.bg_ambient[2]); + } + outDraws.push_back(std::move(bd)); + } } if (m_bVisiblePart[PART_TREE] && m_forest && viewMatrix && projMatrix && camPos) { auto fdraws = m_forest->BuildDrawCommands(viewMatrix, projMatrix, camPos[0], camPos[1], camPos[2], GetFarClip()); - for (auto& fd : fdraws) outDraws.push_back(std::move(fd)); + for (auto& fd : fdraws) { + if (m_pCurrentEnvironment) { + fd.light_direction[0] = m_pCurrentEnvironment->dir_light.direction[0]; + fd.light_direction[1] = m_pCurrentEnvironment->dir_light.direction[1]; + fd.light_direction[2] = m_pCurrentEnvironment->dir_light.direction[2]; + fd.light_ambient[0] = std::max(0.35f, m_pCurrentEnvironment->dir_light.bg_ambient[0]); + fd.light_ambient[1] = std::max(0.35f, m_pCurrentEnvironment->dir_light.bg_ambient[1]); + fd.light_ambient[2] = std::max(0.38f, m_pCurrentEnvironment->dir_light.bg_ambient[2]); + } + outDraws.push_back(std::move(fd)); + } } } diff --git a/src/python_chr.cpp b/src/python_chr.cpp index 41ae8309..572c51c7 100644 --- a/src/python_chr.cpp +++ b/src/python_chr.cpp @@ -9,10 +9,12 @@ #include #include "python_gameplay_modules.h" #include "eter_net/NetworkActorManager.h" +#include "eter_net/PythonNetworkStream.h" #include "eter_render/RaceData.h" #include "eter_render/TextTailManager.h" #include "eter_render/Gr2ModelRenderer.h" #include "eter_render/TerrainHeightmap.h" +#include "eter_image/GrpDevice.h" #include "shared/common/PythonUtils.h" #include #include @@ -36,7 +38,7 @@ SNetworkActorData* GetInstancePtr(int vid) { return Mgr().GetActorData(uint32_t( // CInstanceBase::NEW_GetPixelPosition: the port's actor stores (x, height, y). void GetPixelPosition(const SNetworkActorData& inst, float* x, float* y, float* z) { if (inst.m_pActorInstance) { - *x = inst.m_pActorInstance->GetX(); *y = inst.m_pActorInstance->GetZ(); *z = inst.m_pActorInstance->GetY(); + *x = inst.m_pActorInstance->GetX(); *y = inst.m_pActorInstance->GetZ() * (inst.m_isScriptInstance ? -1.0f : 1.0f); *z = inst.m_pActorInstance->GetY(); } else { *x = float(inst.m_lCurX); *y = float(inst.m_lCurY); *z = float(inst.m_lCurZ); } @@ -46,8 +48,11 @@ void SetPixelPosition(SNetworkActorData& inst, float x, float y, float z) { inst.m_lCurX = inst.m_lDstX = int32_t(x); inst.m_lCurY = inst.m_lDstY = int32_t(y); inst.m_lCurZ = int32_t(z); - if (inst.m_pActorInstance) inst.m_pActorInstance->SetPosition(x, z, y); - TextTailManager::Instance().SetCharacterPosition(inst.m_dwVID, x, z, y); + // In Windows Metin2: v3PosCur.x = +x, v3PosCur.y = -y, v3PosCur.z = +z. + // In our Y-up coordinate system: X is right, Y is up, Z is depth/forward. + const float engineZ=inst.m_isScriptInstance ? -y : y; + if (inst.m_pActorInstance) inst.m_pActorInstance->SetPosition(x, z, engineZ); + TextTailManager::Instance().SetCharacterPosition(inst.m_dwVID, x, z, engineZ); } // CInstanceBase::__GetBackgroundHeight (0 without a map). float GetBackgroundHeight(float x, float y) { @@ -70,6 +75,7 @@ void CreateInstance(SNetworkActorData& createData) { return; } createData.m_lCurZ = int32_t(GetBackgroundHeight(float(createData.m_lCurX), float(createData.m_lCurY))); + createData.m_isScriptInstance = true; Mgr().AppendActor(createData); } @@ -434,6 +440,8 @@ PyObject* chrRaceToSex(PyObject*, PyObject* poArgs) { PyObject* chrDestroy(PyObject*, PyObject*) { Mgr().Destroy(); + // Destroying the phase's character instances must not discard the server's identity. + Mgr().SetMainActorVID(PythonNetworkStream::Instance().GetMainActorVID()); return Py_BuildNone(); } @@ -446,14 +454,69 @@ PyObject* chrUpdate(PyObject*, PyObject*) { const float dt = s_hasLast ? std::chrono::duration(now - s_last).count() : 0.0f; s_last = now; s_hasLast = true; - Mgr().Update(dt, GetActiveBackgroundTerrain()); + // Intro instances keep the explicit height set by introselect / introcreate, + // even when a previously visited game map remains loaded. + Mgr().Update(dt, PythonNetworkStream::Instance().IsGamePhase() ? GetActiveBackgroundTerrain() : nullptr); return Py_BuildNone(); } -// Deform / Render / RenderCollision: the port deforms in ActorInstance::Update and draws the actor -// list through GetAllActiveChrDraws (main loop), so the script calls have nothing left to do. -PyObject* chrDeform(PyObject*, PyObject*) { return Py_BuildNone(); } -PyObject* chrRender(PyObject*, PyObject*) { return Py_BuildNone(); } +PyObject* chrDeform(PyObject*, PyObject*) { + // BuildDrawCommands skins the current pose during Render. Windows Deform + // does not tick movement or animations a second time after chr.Update. + return Py_BuildNone(); +} + +PyObject* chrRender(PyObject*, PyObject*) { + Gr2SceneRenderer* sceneRenderer = TextTailManager::Instance().GetCurrentSceneRenderer(); + SDL_Renderer* renderer = CGraphicDevice::Instance().GetRenderer(); + if (!renderer) renderer = TextTailManager::Instance().GetCurrentRenderer(); + if (sceneRenderer && renderer) { + auto draws = GetAllActiveChrDraws(); + if (!draws.empty()) { + for (auto& d : draws) { + d.material_ambient[0] = 0.85f; + d.material_ambient[1] = 0.85f; + d.material_ambient[2] = 0.85f; + d.light_ambient[0] = std::max(0.55f, d.light_ambient[0]); + d.light_ambient[1] = std::max(0.55f, d.light_ambient[1]); + d.light_ambient[2] = std::max(0.58f, d.light_ambient[2]); + d.material_emissive[0] = std::max(0.05f, d.material_emissive[0]); + d.material_emissive[1] = std::max(0.05f, d.material_emissive[1]); + d.material_emissive[2] = std::max(0.05f, d.material_emissive[2]); + } + + int sw = sceneRenderer->GetLogicalWidth(); + int sh = sceneRenderer->GetLogicalHeight(); + if (sw <= 0) sw = 1024; + if (sh <= 0) sh = 768; + + static std::unique_ptr s_chrSurface(nullptr, SDL_DestroySurface); + static std::unique_ptr s_chrTexture(nullptr, SDL_DestroyTexture); + static int s_chrW = 0, s_chrH = 0; + + if (!s_chrSurface || s_chrW != sw || s_chrH != sh) { + s_chrW = sw; + s_chrH = sh; + s_chrSurface.reset(SDL_CreateSurface(s_chrW, s_chrH, SDL_PIXELFORMAT_ARGB8888)); + s_chrTexture.reset(SDL_CreateTexture(renderer, SDL_PIXELFORMAT_ARGB8888, SDL_TEXTUREACCESS_STREAMING, s_chrW, s_chrH)); + if (s_chrTexture) { + SDL_SetTextureBlendMode(s_chrTexture.get(), SDL_BLENDMODE_BLEND); + SDL_SetTextureScaleMode(s_chrTexture.get(), SDL_SCALEMODE_LINEAR); + } + } + + if (s_chrSurface && s_chrTexture) { + SDL_FillSurfaceRect(s_chrSurface.get(), nullptr, 0x00000000); + sceneRenderer->Clear(0, 1.0f); + sceneRenderer->RenderScene(s_chrSurface.get(), draws); + SDL_UpdateTexture(s_chrTexture.get(), nullptr, s_chrSurface->pixels, s_chrSurface->pitch); + SDL_FRect dst = { 0.0f, 0.0f, static_cast(sw), static_cast(sh) }; + SDL_RenderTexture(renderer, s_chrTexture.get(), nullptr, &dst); + } + } + } + return Py_BuildNone(); +} PyObject* chrRenderCollision(PyObject*, PyObject*) { return Py_BuildNone(); } PyObject* chrCreateInstance(PyObject*, PyObject* poArgs) { @@ -480,7 +543,8 @@ PyObject* chrCreateInstance(PyObject*, PyObject* poArgs) { CreateInstance(kCreateData); } else { - Mgr().RegisterInstance(uint32_t(iVirtualID)); + if (auto instance = Mgr().RegisterInstance(uint32_t(iVirtualID))) + instance->m_isScriptInstance = true; } return Py_BuildNone(); } @@ -827,6 +891,7 @@ PyObject* chrSetRotation(PyObject*, PyObject* poArgs) { if (!PyTuple_GetFloat(poArgs, 0, &fRotation)) return Py_BuildException(); SNetworkActorData* pCharacterInstance = GetSelectedInstancePtr(); if (!pCharacterInstance) return Py_BuildNone(); + // Windows chr.SetRotation adds 180 degrees at the scripting boundary. SetRotation(*pCharacterInstance, std::fmod(fRotation + 180.0f, 360.0f)); return Py_BuildNone(); } diff --git a/src/python_gameplay_modules.cpp b/src/python_gameplay_modules.cpp index 06b34680..0e7d20d1 100644 --- a/src/python_gameplay_modules.cpp +++ b/src/python_gameplay_modules.cpp @@ -63,7 +63,15 @@ static int s_quickPage=0; static PyObject* s_playerGameWindow=nullptr; static PyObject* player_SetGameWindow(PyObject*,PyObject* args) { PyObject* window;if(!PyArg_ParseTuple(args,"O",&window)) return nullptr; - if(window==Py_None) window=nullptr;Py_XINCREF(window);auto* old=s_playerGameWindow;s_playerGameWindow=window;Py_XDECREF(old);Py_RETURN_NONE; + if(window==Py_None || (PyInt_Check(window) && PyInt_AsLong(window)==0)) window=nullptr; + if(window==s_playerGameWindow) Py_RETURN_NONE; + Py_XINCREF(window); + auto* old=s_playerGameWindow; s_playerGameWindow=nullptr; + // The previous GameWindow destructor calls SetGameWindow(0). Dispose it + // before assigning its successor so it cannot clear the new callback owner. + Py_XDECREF(old); + s_playerGameWindow=window; + Py_RETURN_NONE; } static bool player_window_call(const char* name, PyObject* args = nullptr) { if (!s_playerGameWindow) { @@ -153,7 +161,7 @@ static PyObject* player_AffectIndexToSkillIndex(PyObject*,PyObject* args) { static PyObject* player_GetSkillSlotIndex(PyObject*,PyObject* args) { int index;if(!PyArg_ParseTuple(args,"i",&index)) return nullptr; auto it=s_skillSlots.find(index); - if(it==s_skillSlots.end()) {PyErr_SetString(PyExc_RuntimeError,"unknown skill index");return nullptr;} + if(it==s_skillSlots.end()) return Py_BuildException(); return PyInt_FromLong(it->second); } template static PyObject* player_GetSkillPower(PyObject*,PyObject* args) { @@ -227,14 +235,14 @@ static PyObject* player_SetStatus(PyObject*, PyObject* args) { long long value = 0; if (PyArg_ParseTuple(args, "iL", &type, &value)) { if(uint32_t(type)<255) { - s_playerPoints[type] = value; + SetPlayerStatusPoint(type, value); } } else { PyErr_Clear(); long lVal = 0; if (PyArg_ParseTuple(args, "il", &type, &lVal)) { if(uint32_t(type)<255) { - s_playerPoints[type] = lVal; + SetPlayerStatusPoint(type, lVal); } } } @@ -963,6 +971,15 @@ void UseGuildSkill(int skillSlot) { } static bool s_isAtkKey = false; +static std::array s_movementKeys{}; +bool GetPlayerMovementYaw(float cameraYaw, float& movementYaw) { + const int x = int(s_movementKeys[32] || s_movementKeys[205]) - int(s_movementKeys[30] || s_movementKeys[203]); + const int z = int(s_movementKeys[31] || s_movementKeys[208]) - int(s_movementKeys[17] || s_movementKeys[200]); + if (!x && !z) return false; + movementYaw = std::atan2(float(x), float(z)) * 180.0f / 3.14159265f - cameraYaw; + movementYaw = std::fmod(movementYaw + 720.0f, 360.0f); + return true; +} static float s_fCmrRotSpd = 0.0f; static uint32_t s_inGuildAreaID = 0xffffffff; @@ -1177,16 +1194,33 @@ void SetMainCharacterPosition(float x, float y, float z) { s_mainActorPos.z = z; } +void GetMainCharacterPosition(float& x, float& y, float& z) { + x = s_mainActorPos.x; + y = s_mainActorPos.y; + z = s_mainActorPos.z; +} + const std::string& GetMainCharacterName() { return s_playerName; } void SetMainCharacterName(const std::string& name) { s_playerName = name; } +static void UpdateBattleStatus(); long long GetPlayerStatusPoint(int type) {if(uint32_t(type)>=255)return 0;auto it=s_playerPoints.find(type);return it==s_playerPoints.end()?0:it->second;} void SetPlayerStatusPoint(int type, long long value) { if(uint32_t(type)>=255)return; s_playerPoints[type] = value; + // CPythonPlayer::SetStatus: derived combat points are client-calculated, + // both on the initial points packet and subsequent stat changes. + switch (type) { + case 1: case 12: case 14: case 15: // level, ST, DX, IQ + case 18: case 29: case 30: // evade, min/max attack + case 200: case 201: case 204: // min/max weapon, hit rate + case 205: case 207: case 208: case 209: case 210: + UpdateBattleStatus(); + break; + } } PlayerItemSlot GetPlayerItem(int slot) { @@ -1261,10 +1295,13 @@ bool GetPartyMemberState(uint32_t pid,uint8_t* state) { bool PartyMemberPIDToVID(uint32_t pid,uint32_t* vid) { auto* member=find_party_member(pid);if(!member) return false;*vid=member->vid;return true; } -static bool party_member_vid_to_pid(uint32_t vid,uint32_t* pid) { +bool PartyMemberVIDToPID(uint32_t vid,uint32_t* pid) { for(const auto& [memberPid,member]:s_partyMembers) if(member.vid==vid) {*pid=memberPid;return true;} return false; } +static inline bool party_member_vid_to_pid(uint32_t vid,uint32_t* pid) { + return PartyMemberVIDToPID(vid, pid); +} // CPythonBackground::m_strMapName: only Warp() sets it (LoadMap does not), Destroy() clears it. static std::string s_warpMapName; bool IsPartyMemberByVID(uint32_t vid) { uint32_t pid;return party_member_vid_to_pid(vid,&pid); } @@ -1630,6 +1667,7 @@ bool HasEnoughArrow() { } void ResetPlayerState() { + CancelPlayerMovement(); s_coolTimeEnabled=true; s_playerName.clear();s_mainActorPos={};s_playerPoints.clear();s_playerSkills.clear();s_skillSlots.clear(); s_quickPage=0;s_playTime=0;s_playerQuickSlots.fill({});s_playerItems.fill({});s_windowItems.clear(); @@ -1787,6 +1825,13 @@ struct SDropItemEntry { }; static std::unordered_map> s_chestDropInfoMap; +void ClearChestDropInfo(uint32_t chestVnum) { + s_chestDropInfoMap.erase(chestVnum); +} +void AddChestDropItem(uint32_t chestVnum, uint32_t itemVnum, uint32_t count) { + s_chestDropInfoMap[chestVnum].push_back({itemVnum, int(count)}); +} + static PyObject* item_CreateItem(PyObject*, PyObject* poArgs) { int iVirtualID = 0, iVirtualNumber = 0; float x = 0.0f, y = 0.0f, z = 0.0f; @@ -2465,6 +2510,9 @@ static std::map s_autoPotionInfo; static std::map s_emotionIcons; static int s_mouseFunc[8] = {0}; static int s_mouseState[8] = {0}; +bool IsPlayerMouseMoving() { return s_mouseState[0] == 1 && (s_mouseFunc[0] == 0 || s_mouseFunc[0] == 1); } +bool IsPlayerCameraDragging() { return s_mouseState[1] == 1 && s_mouseFunc[1] == 2; } +void CancelPlayerMovement() { s_movementKeys.fill(false); std::fill(std::begin(s_mouseState),std::end(s_mouseState),0); } static int s_mouseMiddleButtonState = 0; static bool s_playerVisible = true; static bool s_levelLimit = false; @@ -2543,6 +2591,7 @@ static PyObject* player_ComboAttack(PyObject*, PyObject*) { } static PyObject* player_EndKeyWalkingImmediately(PyObject*, PyObject*) { + s_movementKeys.fill(false); NEW_CancelFishing(); return Py_BuildNone(); } @@ -3037,6 +3086,9 @@ static PyObject* player_MoveItem(PyObject*, PyObject* args) { static PyObject* player_OpenCharacterMenu(PyObject*, PyObject* args) { int vid = 0; if (!PyTuple_GetInteger(args, 0, &vid)) return Py_BuildException(); + if (auto* actor = NetworkActorManager::Instance().GetActorData(uint32_t(vid))) { + player_window_call("SetPCTargetBoard", Py_BuildValue("(is)", vid, actor->m_stName.c_str())); + } return Py_BuildNone(); } @@ -3236,6 +3288,7 @@ static PyObject* player_SetSingleDIKKeyState(PyObject*, PyObject* args) { return Py_BuildException(); if (NEW_CancelFishing()) return Py_BuildNone(); + if (dik >= 0 && dik < int(s_movementKeys.size())) s_movementKeys[dik] = pressed != 0; return Py_BuildNone(); } @@ -3510,7 +3563,7 @@ void initPlayer() { }; NetworkActorManager::SetPartyMemberQuery(IsPartyMemberByVID); NetworkActorManager::SetNPCWearQuery([](uint32_t race, uint8_t wearIndex) { - return NonPlayerData::Instance().getNPCWear(int(race), wearIndex, s_warpMapName); + return NonPlayerData::Instance().getNPCWear(int(race), wearIndex, CPythonBackground::Instance().GetWarpMapName()); }); NetworkActorManager::SetItemScaleQuery([](uint32_t vnum, uint32_t pos, float scale[3], float position[3]) { ItemScaleInfo info; diff --git a/src/python_gameplay_modules.h b/src/python_gameplay_modules.h index ae721724..91bd9fef 100644 --- a/src/python_gameplay_modules.h +++ b/src/python_gameplay_modules.h @@ -42,7 +42,10 @@ void UpdatePartyMemberInfo(uint32_t pid,uint8_t state,uint8_t hp); void UpdatePartyMemberAffect(uint32_t pid,uint8_t slot,int16_t affect); bool GetPartyMemberState(uint32_t pid,uint8_t* state); bool PartyMemberPIDToVID(uint32_t pid,uint32_t* vid); +bool PartyMemberVIDToPID(uint32_t vid,uint32_t* pid); bool IsPartyMemberByVID(uint32_t vid); +void ClearChestDropInfo(uint32_t chestVnum); +void AddChestDropItem(uint32_t chestVnum, uint32_t itemVnum, uint32_t count); void RememberChallengeInstance(uint32_t vid); void RememberRevengeInstance(uint32_t vid); void RememberCantFightInstance(uint32_t vid); @@ -77,10 +80,15 @@ std::string GetWeaponModelPathByVnum(uint32_t vnum); std::vector GetAllActiveChrDraws(); void SetMainCharacterPosition(float x, float y, float z); +void GetMainCharacterPosition(float& x, float& y, float& z); const std::string& GetMainCharacterName(); void SetMainCharacterName(const std::string& name); long long GetPlayerStatusPoint(int type); void SetPlayerStatusPoint(int type, long long value); +bool GetPlayerMovementYaw(float cameraYaw, float& movementYaw); +bool IsPlayerMouseMoving(); +bool IsPlayerCameraDragging(); +void CancelPlayerMovement(); void SetWeaponPower(uint32_t dwMinPower, uint32_t dwMaxPower, uint32_t dwMinMagicPower, uint32_t dwMaxMagicPower, uint32_t dwAddPower); void UpdateEquippedWeaponPower(); bool HasEnoughArrow(); diff --git a/src/python_grp.cpp b/src/python_grp.cpp index 297e2ca5..8301c90b 100644 --- a/src/python_grp.cpp +++ b/src/python_grp.cpp @@ -4,6 +4,9 @@ #include "eter_image/GrpExpandedImageInstance.h" #include "eter_resource/ResourceManager.h" #include "eter_ui/PythonWindow.h" +#include "eter_ui/PythonWindowManager.h" +#include "eter_render/TextTailManager.h" +#include "eter_render/Gr2ModelRenderer.h" #include #include #include @@ -383,8 +386,11 @@ static PyObject* grpSetEyeCamera(PyObject*, PyObject* poArgs) { static PyObject* grpSetPerspective(PyObject*, PyObject* poArgs) { float fov = 0, aspect = 0, zNear = 0, zFar = 0; - if (!PyTuple_GetFloat(poArgs, 0, &fov) || !PyTuple_GetFloat(poArgs, 1, &aspect) || !PyTuple_GetFloat(poArgs, 2, &zNear) || !PyTuple_GetFloat(poArgs, 3, &zFar)) + if (!PyTuple_GetFloat(poArgs, 0, &fov) || !PyTuple_GetFloat(poArgs, 1, &aspect) || + !PyTuple_GetFloat(poArgs, 2, &zNear) || !PyTuple_GetFloat(poArgs, 3, &zFar)) return Py_BuildException(); + auto* renderer3d = TextTailManager::Instance().GetCurrentSceneRenderer(); + if (renderer3d) renderer3d->SetPerspective(fov, aspect, zNear, zFar); return Py_BuildNone(); } @@ -572,12 +578,31 @@ static PyObject* grpSetGameRenderState(PyObject*, PyObject*) { return Py_BuildNo static PyObject* grpSetViewport(PyObject*, PyObject* poArgs) { float fx = 0, fy = 0, fWidth = 0, fHeight = 0; - if (!PyTuple_GetFloat(poArgs, 0, &fx) || !PyTuple_GetFloat(poArgs, 1, &fy) || !PyTuple_GetFloat(poArgs, 2, &fWidth) || !PyTuple_GetFloat(poArgs, 3, &fHeight)) + if (!PyTuple_GetFloat(poArgs, 0, &fx) || !PyTuple_GetFloat(poArgs, 1, &fy) || + !PyTuple_GetFloat(poArgs, 2, &fWidth) || !PyTuple_GetFloat(poArgs, 3, &fHeight)) return Py_BuildException(); + long sw = UI::CWindowManager::Instance().GetScreenWidth(); + long sh = UI::CWindowManager::Instance().GetScreenHeight(); + if (sw <= 0) sw = 1024; + if (sh <= 0) sh = 768; + int vx = static_cast(fx * sw); + int vy = static_cast(fy * sh); + int vw = static_cast(fWidth * sw); + int vh = static_cast(fHeight * sh); + auto* renderer3d = TextTailManager::Instance().GetCurrentSceneRenderer(); + if (renderer3d) renderer3d->SetViewport(vx, vy, vw, vh); return Py_BuildNone(); } -static PyObject* grpRestoreViewport(PyObject*, PyObject*) { return Py_BuildNone(); } +static PyObject* grpRestoreViewport(PyObject*, PyObject*) { + long sw = UI::CWindowManager::Instance().GetScreenWidth(); + long sh = UI::CWindowManager::Instance().GetScreenHeight(); + if (sw <= 0) sw = 1024; + if (sh <= 0) sh = 768; + auto* renderer3d = TextTailManager::Instance().GetCurrentSceneRenderer(); + if (renderer3d) renderer3d->SetViewport(0, 0, static_cast(sw), static_cast(sh)); + return Py_BuildNone(); +} static PyObject* grpSetOmniLight(PyObject*, PyObject*) { return Py_BuildNone(); } static PyObject* grpGetCameraPosition(PyObject*, PyObject*) { diff --git a/src/python_ime.cpp b/src/python_ime.cpp index 04e68cde..e48cee9c 100644 --- a/src/python_ime.cpp +++ b/src/python_ime.cpp @@ -1,6 +1,9 @@ #include "python_ime.h" #include #include +#include +#include +#include "eter_ui/PythonWindowManager.h" namespace ava2 { namespace { @@ -11,11 +14,32 @@ int s_user_max = 64; int s_cursor_pos = 0; int s_input_mode = 0; bool s_paste_enabled = true; +bool s_capture_input = false; +bool s_ime_enabled = false; -PyObject* ime_enable(PyObject*, PyObject*) { Py_RETURN_NONE; } -PyObject* ime_disable(PyObject*, PyObject*) { Py_RETURN_NONE; } -PyObject* ime_enable_capture_input(PyObject*, PyObject*) { Py_RETURN_NONE; } -PyObject* ime_disable_capture_input(PyObject*, PyObject*) { Py_RETURN_NONE; } +void TriggerIMEUpdate() { + UI::CWindowManager::Instance().RunIMEUpdate(); +} + +PyObject* ime_enable(PyObject*, PyObject*) { + s_ime_enabled = true; + Py_RETURN_NONE; +} + +PyObject* ime_disable(PyObject*, PyObject*) { + s_ime_enabled = false; + Py_RETURN_NONE; +} + +PyObject* ime_enable_capture_input(PyObject*, PyObject*) { + s_capture_input = true; + Py_RETURN_NONE; +} + +PyObject* ime_disable_capture_input(PyObject*, PyObject*) { + s_capture_input = false; + Py_RETURN_NONE; +} PyObject* ime_set_max(PyObject*, PyObject* args) { if (!PyArg_ParseTuple(args, "i", &s_max)) return nullptr; @@ -63,8 +87,15 @@ PyObject* ime_get_reading_error(PyObject*, PyObject*) { return PyInt_FromLong(0); } -PyObject* ime_enable_ime(PyObject*, PyObject*) { Py_RETURN_NONE; } -PyObject* ime_disable_ime(PyObject*, PyObject*) { Py_RETURN_NONE; } +PyObject* ime_enable_ime(PyObject*, PyObject*) { + s_ime_enabled = true; + Py_RETURN_NONE; +} + +PyObject* ime_disable_ime(PyObject*, PyObject*) { + s_ime_enabled = false; + Py_RETURN_NONE; +} PyObject* ime_get_input_mode(PyObject*, PyObject*) { return PyInt_FromLong(s_input_mode); @@ -75,8 +106,16 @@ PyObject* ime_set_input_mode(PyObject*, PyObject* args) { Py_RETURN_NONE; } -PyObject* ime_set_number_mode(PyObject*, PyObject*) { Py_RETURN_NONE; } -PyObject* ime_set_string_mode(PyObject*, PyObject*) { Py_RETURN_NONE; } +PyObject* ime_set_number_mode(PyObject*, PyObject*) { + s_input_mode = 1; + Py_RETURN_NONE; +} + +PyObject* ime_set_string_mode(PyObject*, PyObject*) { + s_input_mode = 0; + Py_RETURN_NONE; +} + PyObject* ime_add_except_key(PyObject*, PyObject*) { Py_RETURN_NONE; } PyObject* ime_clear_except_key(PyObject*, PyObject*) { Py_RETURN_NONE; } @@ -102,12 +141,16 @@ PyObject* ime_move_end(PyObject*, PyObject*) { PyObject* ime_set_cursor_position(PyObject*, PyObject* args) { if (!PyArg_ParseTuple(args, "i", &s_cursor_pos)) return nullptr; + if (s_cursor_pos < 0 || s_cursor_pos > static_cast(s_text.length())) { + s_cursor_pos = static_cast(s_text.length()); + } Py_RETURN_NONE; } PyObject* ime_delete(PyObject*, PyObject*) { if (s_cursor_pos < static_cast(s_text.length())) { s_text.erase(s_cursor_pos, 1); + TriggerIMEUpdate(); } Py_RETURN_NONE; } @@ -115,9 +158,19 @@ PyObject* ime_delete(PyObject*, PyObject*) { PyObject* ime_paste_string(PyObject*, PyObject* args) { const char* str = nullptr; if (!PyArg_ParseTuple(args, "s", &str)) return nullptr; - if (str) { - s_text.insert(s_cursor_pos, str); - s_cursor_pos += static_cast(strlen(str)); + if (str && s_paste_enabled) { + int limit = std::min(s_max, s_user_max); + if (limit <= 0) limit = 64; + std::string insert_str = str; + int remaining = limit - static_cast(s_text.length()); + if (remaining > 0) { + if (static_cast(insert_str.length()) > remaining) { + insert_str = insert_str.substr(0, remaining); + } + s_text.insert(s_cursor_pos, insert_str); + s_cursor_pos += static_cast(insert_str.length()); + TriggerIMEUpdate(); + } } Py_RETURN_NONE; } @@ -126,6 +179,7 @@ PyObject* ime_paste_backspace(PyObject*, PyObject*) { if (s_cursor_pos > 0 && !s_text.empty()) { s_text.erase(s_cursor_pos - 1, 1); --s_cursor_pos; + TriggerIMEUpdate(); } Py_RETURN_NONE; } @@ -142,6 +196,73 @@ PyObject* ime_enable_paste(PyObject*, PyObject* args) { } // namespace +void IME_OnChar(char c) { + if (!s_capture_input) return; + int limit = std::min(s_max, s_user_max); + if (limit <= 0) limit = 64; + if (static_cast(s_text.length()) >= limit) return; + if (s_input_mode == 1) { // number mode + if (c < '0' || c > '9') return; + } + if (s_cursor_pos > static_cast(s_text.length())) s_cursor_pos = static_cast(s_text.length()); + s_text.insert(s_cursor_pos, 1, c); + ++s_cursor_pos; + TriggerIMEUpdate(); +} + +void IME_InsertText(const char* text) { + if (!text || !s_capture_input) return; + int limit = std::min(s_max, s_user_max); + if (limit <= 0) limit = 64; + while (*text) { + if (static_cast(s_text.length()) >= limit) break; + char c = *text++; + if (s_input_mode == 1 && (c < '0' || c > '9')) continue; + if (s_cursor_pos > static_cast(s_text.length())) s_cursor_pos = static_cast(s_text.length()); + s_text.insert(s_cursor_pos, 1, c); + ++s_cursor_pos; + } + TriggerIMEUpdate(); +} + +void IME_OnBackspace() { + if (!s_capture_input) return; + if (s_cursor_pos > 0 && !s_text.empty()) { + if (s_cursor_pos > static_cast(s_text.length())) s_cursor_pos = static_cast(s_text.length()); + s_text.erase(s_cursor_pos - 1, 1); + --s_cursor_pos; + TriggerIMEUpdate(); + } +} + +void IME_OnDelete() { + if (!s_capture_input) return; + if (s_cursor_pos < static_cast(s_text.length())) { + s_text.erase(s_cursor_pos, 1); + TriggerIMEUpdate(); + } +} + +void IME_MoveLeft() { + if (s_cursor_pos > 0) --s_cursor_pos; +} + +void IME_MoveRight() { + if (s_cursor_pos < static_cast(s_text.length())) ++s_cursor_pos; +} + +void IME_MoveHome() { + s_cursor_pos = 0; +} + +void IME_MoveEnd() { + s_cursor_pos = static_cast(s_text.length()); +} + +bool IME_IsCaptureInput() { + return s_capture_input; +} + void initime() { static PyMethodDef methods[] = { {"Enable", ime_enable, METH_VARARGS, nullptr}, diff --git a/src/python_ime.h b/src/python_ime.h index 1fe0b0a2..77c6fe03 100644 --- a/src/python_ime.h +++ b/src/python_ime.h @@ -4,4 +4,14 @@ namespace ava2 { void initime(); +void IME_OnChar(char c); +void IME_InsertText(const char* text); +void IME_OnBackspace(); +void IME_OnDelete(); +void IME_MoveLeft(); +void IME_MoveRight(); +void IME_MoveHome(); +void IME_MoveEnd(); +bool IME_IsCaptureInput(); + } // namespace ava2 diff --git a/src/python_minimap.cpp b/src/python_minimap.cpp index 1fa68633..08185c37 100644 --- a/src/python_minimap.cpp +++ b/src/python_minimap.cpp @@ -10,6 +10,8 @@ #include "guild_state.h" #include "eter_net/NetworkActorManager.h" #include "eter_resource/ResourceManager.h" +#include "eter_image/GrpDevice.h" +#include #include "eter_image/GrpImage.h" #include "shared/common/PythonUtils.h" #include @@ -305,6 +307,53 @@ void CPythonMiniMap::Render(float fScreenX, float fScreenY) __SetPosition(); } + // Draw the native terrain minimap tiles under the existing player/NPC marks. + auto* device = CGraphicDevice::InstancePtr(); + if (auto* renderer = device ? device->GetRenderer() : nullptr) { + const auto* map = GetOutdoorMap(); + const int width = int(m_fWidth), height = int(m_fHeight); + if (width > 0 && height > 0) { + if (!m_terrainTexture || width != m_terrainWidth || height != m_terrainHeight) { + SDL_DestroyTexture(m_terrainTexture); + m_terrainTexture = SDL_CreateTexture(renderer, SDL_PIXELFORMAT_RGBA32, SDL_TEXTUREACCESS_STREAMING, width, height); + m_terrainWidth = width; m_terrainHeight = height; + if (m_terrainTexture) SDL_SetTextureBlendMode(m_terrainTexture, SDL_BLENDMODE_BLEND); + } + std::vector pixels(size_t(width) * height * 4); + std::map, CGraphicImage*> tiles; + const float units = CELLSCALE / m_fScale; + for (int y = 0; y < height; ++y) for (int x = 0; x < width; ++x) { + const float dx = x + 0.5f - width * 0.5f, dy = y + 0.5f - height * 0.5f; + if (dx * dx + dy * dy > m_fMiniMapRadius * m_fMiniMapRadius) continue; + const float wx = m_fCenterX + dx * units, wy = m_fCenterY + dy * units; + const int bx = int(std::floor(wx / TERRAIN_SIZE)), by = int(std::floor(wy / TERRAIN_SIZE)); + if (bx < 0 || by < 0 || bx >= map->terrainCountX || by >= map->terrainCountY) continue; + const auto key = std::make_pair(bx, by); + if (!tiles.count(key)) { + char block[32]; snprintf(block, sizeof(block), "/%03d%03d/minimap.dds", bx, by); + auto* image = LoadImagePointer((map->name + block).c_str()); + if (!image) image = LoadImagePointer(("map/" + map->name + block).c_str()); + tiles[key] = image; + } + auto* image = tiles[key]; + if (!image || image->IsEmpty()) continue; + const auto& texture = image->GetTextureReference(); + const int tx = std::clamp(int((wx - bx * TERRAIN_SIZE) / TERRAIN_SIZE * texture.GetWidth()), 0, texture.GetWidth() - 1); + const int ty = std::clamp(int((wy - by * TERRAIN_SIZE) / TERRAIN_SIZE * texture.GetHeight()), 0, texture.GetHeight() - 1); + const size_t source = (size_t(ty) * texture.GetWidth() + tx) * 4, target = (size_t(y) * width + x) * 4; + const auto& rgba = texture.GetPixels(); + if (source + 3 < rgba.size()) { + std::copy_n(rgba.data() + source, 3, pixels.data() + target); + pixels[target + 3] = 255; + } + } + if (m_terrainTexture) { + SDL_UpdateTexture(m_terrainTexture, nullptr, pixels.data(), width * 4); + SDL_FRect destination{fScreenX, fScreenY, float(width), float(height)}; + SDL_RenderTexture(renderer, m_terrainTexture, nullptr, &destination); + } + } + } for (const auto& rPosition : m_OtherPCPositionVector) { m_WhiteMark.SetPosition(rPosition.m_fX, rPosition.m_fY); @@ -1030,6 +1079,9 @@ void CPythonMiniMap::__Initialize() void CPythonMiniMap::Destroy() { + SDL_DestroyTexture(m_terrainTexture); + m_terrainTexture = nullptr; + m_terrainWidth = m_terrainHeight = 0; ClearAllSignalPoint(); m_poHandler = 0; diff --git a/src/python_minimap.h b/src/python_minimap.h index 35d51709..b4896dda 100644 --- a/src/python_minimap.h +++ b/src/python_minimap.h @@ -3,8 +3,8 @@ // Provenance: AVA2 UserInterface/PythonMiniMap.{h,cpp} and PythonMiniMapModule.cpp, compiled with the // Locale_inc.h set ENABLE_MINIMAP_WHITEMARK_NEW, NAMECOLOR_BOSS_CLIENT, ENABLE_STONEMINIMAP, // ENABLE_OFFLINESHOP_SYSTEM and ENABLE_GRAPHIC_ON_OFF; WJ_COMBAT_ZONE is off. -// The D3D minimap texture/vertex pipeline (Create's buffers, Render, RenderAtlas) is not ported: the -// state, mark lists, picking and atlas bookkeeping are, so GetInfo/GetAtlasInfo answer like Windows. +// Native minimap terrain tiles are sampled through SDL; mark lists, picking and atlas +// bookkeeping preserve the Windows behavior. The D3D atlas vertex pipeline is not ported. #include #include "eter_image/GrpImageInstance.h" #include @@ -262,6 +262,8 @@ protected: PyObject* m_poHandler; uint32_t (*m_now)() = nullptr; + SDL_Texture* m_terrainTexture = nullptr; + int m_terrainWidth = 0, m_terrainHeight = 0; }; void initMiniMap(); diff --git a/src/python_native_modules.cpp b/src/python_native_modules.cpp index 4628d29c..4c5b89ae 100644 --- a/src/python_native_modules.cpp +++ b/src/python_native_modules.cpp @@ -3,6 +3,8 @@ #include #include "Poly.h" #include "python_gameplay_modules.h" +#include "player_settings.h" +#include "eter_ui/PythonWindow.h" #include #include #include "skill_description.h" @@ -611,6 +613,20 @@ static PyObject* texttail_register_item(PyObject*, PyObject* args) { } void initTextTail() { + // Use the same FreeType font path as UI text, preserving the Retina render + // scale. SDL_RenderDebugText's fixed bitmap font is only a host fallback. + TextTailManager::Instance().SetTextPainter( + [](float x,float y,const std::string& value,uint32_t color,float scale,bool outline) { + UI::CGraphicTextInstance text; + text.SetFontName(("Tahoma:" + std::to_string(int(12 * scale))).c_str()); + text.SetValue(value.c_str()); text.SetFontColor(color); + text.SetPosition(x,y); text.SetOutline(outline); text.Render(); + }, + [](const std::string& value,float scale) { + UI::CGraphicTextInstance text; + text.SetFontName(("Tahoma:" + std::to_string(int(12 * scale))).c_str()); + text.SetValue(value.c_str()); int width=0; text.GetTextSize(&width,nullptr); return float(width); + }); static PyMethodDef methods[] = { {"Clear", texttail_clear, METH_VARARGS, nullptr}, {"UpdateAllTextTail", texttail_update_all, METH_VARARGS, nullptr}, @@ -1469,6 +1485,7 @@ static PyObject* playerLoad_RegisterSkill(PyObject*, PyObject* args) { uint8_t bRaceIndex = 0, bSkillGroupIndex = 0, bEmpireIndex = 0; if (!PyTuple_GetByte(args, 0, &bRaceIndex) || !PyTuple_GetByte(args, 1, &bSkillGroupIndex) || !PyTuple_GetByte(args, 2, &bEmpireIndex)) return Py_BuildException(); + RegisterPlayerSkills(bRaceIndex, bSkillGroupIndex, bEmpireIndex); return Py_BuildNone(); } diff --git a/src/python_net.cpp b/src/python_net.cpp index a27cd777..e626d813 100644 --- a/src/python_net.cpp +++ b/src/python_net.cpp @@ -1,4 +1,5 @@ #include "python_net.h" +#include "python_app.h" #include "guild_state.h" #include "python_gameplay_modules.h" #include "login_client.h" @@ -45,7 +46,18 @@ void callback(PyObject* target,const char* name,const char* text=nullptr) { PyObject* set_handler(PyObject*,PyObject* args) { PyObject* value;if(!PyArg_ParseTuple(args,"O",&value)) return nullptr;replace(handler,value);PythonNetworkStream::Instance().SetHandler(value);Py_RETURN_NONE; } PyObject* set_account_handler(PyObject*,PyObject* args) { PyObject* value;if(!PyArg_ParseTuple(args,"O",&value)) return nullptr;replace(account_handler,value);Py_RETURN_NONE; } -PyObject* set_phase(PyObject*,PyObject* args) { int phase;PyObject* value;if(!PyArg_ParseTuple(args,"iO",&phase,&value)) return nullptr;if(phase<0 || phase>=7) { PyErr_SetString(PyExc_ValueError,"invalid phase window");return nullptr; }replace(phases[phase],value);PythonNetworkStream::Instance().SetPhaseWindow(phase, value);Py_RETURN_NONE; } +PyObject* set_phase(PyObject*,PyObject* args) { int phase;PyObject* value;if(!PyArg_ParseTuple(args,"iO",&phase,&value)) return nullptr;if(phase<0 || phase>=7) { PyErr_SetString(PyExc_ValueError,"invalid phase window");return nullptr; }// Release both native owners before installing a successor: old LoadingWindow + // __del__ calls SetPhaseWindow(LOAD, 0), which otherwise unregisters the new one. + if(value==Py_None || (value && PyInt_Check(value) && PyInt_AsLong(value)==0)) value=nullptr; + if(phases[phase]==value) Py_RETURN_NONE; + Py_XINCREF(value); + auto* previous=phases[phase]; phases[phase]=nullptr; + PythonNetworkStream::Instance().SetPhaseWindow(phase,nullptr); + Py_XDECREF(previous); + replace(phases[phase],value); + PythonNetworkStream::Instance().SetPhaseWindow(phase,value); + Py_XDECREF(value); + Py_RETURN_NONE; } PyObject* clear_phase(PyObject*,PyObject* args) { int phase;PyObject* value;if(!PyArg_ParseTuple(args,"iO",&phase,&value)) return nullptr;if(phase<0 || phase>=7) { PyErr_SetString(PyExc_ValueError,"invalid phase window");return nullptr; }if(phases[phase]==value) { replace(phases[phase],nullptr);PythonNetworkStream::Instance().ClearPhaseWindow(phase, value); }Py_RETURN_NONE; } PyObject* set_login(PyObject*,PyObject* args) { const char* id;const char* pass;if(!PyArg_ParseTuple(args,"ss",&id,&pass)) return nullptr;account=id;password=pass;Py_RETURN_NONE; } PyObject* connect(PyObject*,PyObject* args) { @@ -62,6 +74,10 @@ PyObject* select(PyObject*,PyObject* args) { if(!PyArg_ParseTuple(args,"i",&slot)) return nullptr; if(slot<0 || slot>=5) { PyErr_SetString(PyExc_ValueError,"invalid character slot");return nullptr; } if(has_mock_characters) Py_RETURN_NONE; + if(client.is_direct_enter()) { + // DirectEnter already executed the character selection on the map core + Py_RETURN_NONE; + } try { client.select(slot);Py_RETURN_NONE; } catch(const std::exception& e) { PyErr_SetString(PyExc_ValueError,e.what());return nullptr; } } @@ -180,9 +196,9 @@ PyObject* netSendMessengerRemovePacket(PyObject*, PyObject* poArgs) { return Py_BuildNone(); } -// IAbstractPlayer::PartyMemberVIDToPID. The port does not track party members yet -// (player.IsPartyMember is still a placeholder), so the lookup fails like an empty party. -bool party_member_vid_to_pid(uint32_t, uint32_t*) { return false; } +static inline bool party_member_vid_to_pid(uint32_t vid, uint32_t* pid) { + return PartyMemberVIDToPID(vid, pid); +} PyObject* netSendPartyInvitePacket(PyObject*, PyObject* poArgs) { int vid; @@ -896,14 +912,17 @@ static PyObject* net_SetUDPRecvBufferSize(PyObject*, PyObject* poArgs) { } static PyObject* net_LogOutGame(PyObject*, PyObject*) { + PythonNetworkStream::Instance().SendChatPacket("/logout"); return Py_BuildNone(); } static PyObject* net_ExitGame(PyObject*, PyObject*) { + PythonNetworkStream::Instance().SendChatPacket("/phase_select"); return Py_BuildNone(); } static PyObject* net_ExitApplication(PyObject*, PyObject*) { + PythonNetworkStream::Instance().SendChatPacket("/quit"); return Py_BuildNone(); } @@ -1022,10 +1041,12 @@ static PyObject* net_SendAddOfflineShopItem(PyObject*, PyObject* poArgs) { !PyTuple_GetLongLong(poArgs, 2, &iPrice) || !PyTuple_GetInteger(poArgs, 3, &bWindowType)) return Py_BuildException(); + PythonNetworkStream::Instance().SendAddOfflineShopItem(TItemPos{uint8_t(bWindowType), uint16_t(bDisplayPos)}, uint8_t(bPos), iPrice); return Py_BuildNone(); } static PyObject* net_SendTakeOfflineMoney(PyObject*, PyObject*) { + PythonNetworkStream::Instance().SendTakeOfflineMoney(); return Py_BuildNone(); } @@ -1033,14 +1054,17 @@ static PyObject* net_SendOfflineShopChangeTitle(PyObject*, PyObject* poArgs) { char* title = nullptr; if (!PyTuple_GetString(poArgs, 0, &title)) return Py_BuildException(); + PythonNetworkStream::Instance().SendOfflineShopChangeTitle(title ? title : ""); return Py_BuildNone(); } static PyObject* net_SendOfflineShopCheck(PyObject*, PyObject*) { + PythonNetworkStream::Instance().SendOfflineShopCheck(); return Py_BuildNone(); } static PyObject* net_SendOfflineShopButton(PyObject*, PyObject*) { + PythonNetworkStream::Instance().SendOfflineShopButton(); return Py_BuildNone(); } @@ -1368,6 +1392,14 @@ void set_mock_empire(std::uint8_t empire) { void pump_python_net() { client.pump(); + static uint64_t bootstrapClockGeneration=0; + uint32_t serverMS=0; + if(client.status()==LoginClient::Status::Loading && client.generation()!=bootstrapClockGeneration && + client.session() && client.session()->server_milliseconds(serverMS)) { + SetServerMSec(serverMS); + bootstrapClockGeneration=client.generation(); + SDL_Log("Game clock synchronized from login handshake: %u",serverMS); + } auto events = client.take_events(); for(const auto& event : events) { if(event.generation != client.generation()) continue; @@ -1380,7 +1412,7 @@ void pump_python_net() { } else if(event.type == LoginClient::EventType::DirectEnterReady) callback(handler, "SetLoadingPhase"); else if(event.type == LoginClient::EventType::Loading) { PythonNetworkStream::Instance().SetPhase(PHASE_LOADING); - if(!client.is_direct_enter()) callback(handler,"SetLoadingPhase"); + callback(handler,"SetLoadingPhase"); } else { auto* target = account_handler ? account_handler : phases[1]; diff --git a/src/python_runtime.cpp b/src/python_runtime.cpp index 7daa2bfe..af4529d9 100644 --- a/src/python_runtime.cpp +++ b/src/python_runtime.cpp @@ -4,6 +4,7 @@ #include "src/eter_image/GrpExpandedImageInstance.h" #include "src/eter_image/GrpMarkInstance.h" #include "python_runtime.h" +#include "python_minimap.h" #include "quest_state.h" #include "guild_state.h" #include "battlepass_state.h" @@ -39,22 +40,31 @@ std::filesystem::path resolve(const char* name) { std::filesystem::path rel(normalized); if(rel.is_absolute()) throw std::invalid_argument("pack path must be relative"); for(const auto& part:rel) if(part=="..") throw std::invalid_argument("pack traversal rejected"); - auto current=pack_root; - for(const auto& part:rel) { - if(part=="." || part.empty()) continue; - auto wanted=part.string();std::transform(wanted.begin(),wanted.end(),wanted.begin(),[](unsigned char c){return std::tolower(c);}); - bool found=false; std::filesystem::path match; - if(!std::filesystem::is_directory(current)) throw std::runtime_error("pack path not found"); - for(const auto& entry:std::filesystem::directory_iterator(current)) { - auto candidate=entry.path().filename().string();std::transform(candidate.begin(),candidate.end(),candidate.begin(),[](unsigned char c){return std::tolower(c);}); - if(candidate==wanted) { if(found) throw std::runtime_error("ambiguous case-insensitive pack path");match=entry.path();found=true; } + std::vector mounts{pack_root}; + // The bundle keeps scripts in root/ and the other virtual packs beside it. + if (pack_root.filename()=="root" && std::filesystem::is_regular_file(pack_root.parent_path()/"asset_manifest.json")) + mounts.push_back(pack_root.parent_path()); + for (const auto& mount:mounts) { + auto current=mount; + bool missing=false; + for(const auto& part:rel) { + if(part=="." || part.empty()) continue; + if(!std::filesystem::is_directory(current)) {missing=true;break;} + auto wanted=part.string();std::transform(wanted.begin(),wanted.end(),wanted.begin(),[](unsigned char c){return std::tolower(c);}); + bool found=false;std::filesystem::path match; + for(const auto& entry:std::filesystem::directory_iterator(current)) { + auto candidate=entry.path().filename().string();std::transform(candidate.begin(),candidate.end(),candidate.begin(),[](unsigned char c){return std::tolower(c);}); + if(candidate==wanted) {if(found) throw std::runtime_error("ambiguous case-insensitive pack path");match=entry.path();found=true;} + } + if(!found) {missing=true;break;} + current=match; } - if(!found) throw std::runtime_error("pack path not found"); - current=match; + if(missing) continue; + auto canonical=std::filesystem::canonical(current);auto relative=canonical.lexically_relative(mount); + if(relative.empty() || *relative.begin()=="..") throw std::runtime_error("pack path escapes mount"); + return canonical; } - auto canonical=std::filesystem::canonical(current);auto relative=canonical.lexically_relative(pack_root); - if(relative.empty() || *relative.begin()=="..") throw std::runtime_error("pack path escapes mount"); - return canonical; + throw std::runtime_error("pack path not found"); } PyObject* pack_exist(PyObject*,PyObject* args) { const char* name=nullptr;if(!PyArg_ParseTuple(args,"s",&name)) return nullptr; @@ -247,12 +257,14 @@ sys.meta_path.insert(0, _AVA2PackImporter()) // The event sets hold weak references to Python objects. CPythonEventManager::Instance().Destroy();CPythonChat::Instance().Destroy();CPythonSystem::Instance().Clear(); CPythonEventManager::Instance().SetInterfaceWindow(nullptr); + clear_compiled_code(); Py_Finalize(); if (m_windowManager) { m_windowManager->Destroy(); m_windowManager.reset(); } + CPythonMiniMap::Instance().Destroy(); CGraphicExpandedImageInstance::DestroySystem(); CGraphicImageInstance::DestroySystem(); CGraphicMarkInstance::DestroySystem(); @@ -278,12 +290,14 @@ PythonRuntime::~PythonRuntime() { // The event sets hold weak references to Python objects. CPythonEventManager::Instance().Destroy();CPythonChat::Instance().Destroy();CPythonSystem::Instance().Clear(); CPythonEventManager::Instance().SetInterfaceWindow(nullptr); + clear_compiled_code(); Py_Finalize(); if (m_windowManager) { m_windowManager->Destroy(); m_windowManager.reset(); } + CPythonMiniMap::Instance().Destroy(); CGraphicExpandedImageInstance::DestroySystem(); CGraphicImageInstance::DestroySystem(); CGraphicMarkInstance::DestroySystem(); @@ -294,7 +308,33 @@ PythonRuntime::~PythonRuntime() { } pack_root.clear(); } -void PythonRuntime::execute(const std::string& code) { if(PyRun_SimpleString(code.c_str())!=0) throw std::runtime_error("embedded Python execution failed (see traceback)"); } +void PythonRuntime::clear_compiled_code() { + for(auto& entry:m_compiledCode)Py_DECREF(entry.object); + m_compiledCode.clear();m_compiledBytes=0; +} +void PythonRuntime::execute(const std::string& source) { + PyObject* code=nullptr; + for(auto it=m_compiledCode.begin();it!=m_compiledCode.end();++it) { + if(it->source!=source)continue; + code=it->object;Py_INCREF(code);m_compiledCode.splice(m_compiledCode.begin(),m_compiledCode,it);break; + } + if(!code) { + code=Py_CompileString(source.c_str(),"",Py_file_input);++m_compileCount; + if(!code){PyErr_Print();throw std::runtime_error("embedded Python execution failed (see traceback)");} + if(source.size()<=16u*1024u) { + Py_INCREF(code);m_compiledCode.push_front({source,code});m_compiledBytes+=source.size(); + while(m_compiledCode.size()>64 || m_compiledBytes>128u*1024u) { + auto& entry=m_compiledCode.back();m_compiledBytes-=entry.source.size();Py_DECREF(entry.object);m_compiledCode.pop_back(); + } + } + } + auto* module=PyImport_AddModule("__main__"); + auto* globals=module ? PyModule_GetDict(module) : nullptr; + auto* result=globals ? PyEval_EvalCode(reinterpret_cast(code),globals,globals) : nullptr; + Py_DECREF(code); + if(!result){PyErr_Print();throw std::runtime_error("embedded Python execution failed (see traceback)");} + Py_DECREF(result); +} } namespace ava2 { diff --git a/src/python_runtime.h b/src/python_runtime.h index 453adfa1..bd0ffe74 100644 --- a/src/python_runtime.h +++ b/src/python_runtime.h @@ -3,6 +3,8 @@ #include #include #include +#include +struct _object; namespace UI { class CWindowManager; } class CResourceManager; @@ -13,6 +15,10 @@ struct LoginViewSnapshot { std::string phase,message;int selected=-1;std::vector slots; }; class PythonRuntime { + struct CompiledCode {std::string source; _object* object;}; + std::list m_compiledCode; + size_t m_compiledBytes=0, m_compileCount=0; + void clear_compiled_code(); std::unique_ptr m_resourceManager; std::unique_ptr m_windowManager; public: @@ -21,6 +27,9 @@ public: PythonRuntime(const PythonRuntime&)=delete; PythonRuntime& operator=(const PythonRuntime&)=delete; void execute(const std::string& code); + size_t compiled_code_count() const { return m_compiledCode.size(); } + size_t compiled_code_bytes() const { return m_compiledBytes; } + size_t compilation_count() const { return m_compileCount; } void load_login_view(const std::filesystem::path& file); void connect_view(const std::string& game_host,int game_port,const std::string& auth_host,int auth_port,const std::string& account,const std::string& password); void view_action(const char* method,int value=-1); diff --git a/src/python_system.cpp b/src/python_system.cpp index 3d0570b6..eb070e61 100644 --- a/src/python_system.cpp +++ b/src/python_system.cpp @@ -347,6 +347,7 @@ void CPythonSystem::SetDefaultConfig() m_Config.bDecompressDDS = 0; m_Config.bSoftwareTiling = 0; m_Config.iShadowLevel = 3; + m_Config.bShowShadow = true; m_Config.bViewChat = true; m_Config.bAlwaysShowName = DEFAULT_VALUE_ALWAYS_SHOW_NAME; m_Config.bShowDamage = true; diff --git a/support/mac/AppIcon.icns b/support/mac/AppIcon.icns new file mode 100644 index 0000000000000000000000000000000000000000..9a0141417e56003aa470f05992af1263a09c533d GIT binary patch literal 3055434 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