port: CMapOutdoor + PythonBackground + minimap (1:1 40250)

GameLib map/area/terrain units, PRTerrainLib Terrain/TextureSet,
PythonBackground(+Module) and ColorTransitionHelper ported verbatim;
pending stand-ins and background module stubs removed. Hand edits:
BeginEnvironment's pointer tag via uintptr_t, LoadWaterMap reads the
file's 32-bit longs. Terrain draw passes stay platform no-ops (Godot
draws the terrain). RecordingDevice gains textures, buffers and render
targets; orthographic draws become UI commands so CPythonMiniMap's
masked tiles show through minimap_image_filter in python_ui_surface.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/PORT-PLAN.md

@@ -446,6 +446,7 @@ extension/third_party/cpython-2.7.18/                  # 静态库（2P 批次
 
    批次 3-a CPythonSkill（2026-09-24）：`UserInterface/PythonSkill.cpp`（含 skill 模块）与 `EterBase/Poly/`（技能公式解析器）原样移植，删除 pending 替身与 skill 模块桩，`initskill()` 按 40250 顺序在 `initfly()` 之后，实例按 `m_pySkill` 位置进 PythonBoot 的 `GameSingletons`；平台 `PythonApplication.cpp` 里重复的 `SKILL_EFFECT_UPGRADE_ENABLE` 删掉（40250 定义在 PythonSkill.cpp），`LoadLocaleData` 的 skilldesc/skilltable 现在真正载入。改动：技能图标/图标实例句柄用 `Py_BuildPointer`/`PyTuple_GetPointer`（item 模块的 `GetIconInstance/DeleteIconInstance` 同改），`skillGetGradeData` 把非平凡结构传进 varargs（clang 拒绝），改为显式读同样的前 4 字节（脚本不调用）。`port.login_flow`：选角阶段 skill 1 = Three-Way Cut、ACTIVE、冷却 12；进游戏后主动技能只有分等级图标（`GetIconImage` 为 0，与 40250 相同），`GetIconImageNew/GetIconInstanceNew` 可用；真服同样通过。
    批次 3-b EffectLib（2026-09-24）：`EffectLib/` 18 个 .cpp 原样移植（EffectManager、EffectData/Instance、EffectMesh、粒子系统、SimpleLight 等），删除 `platform/EffectLib` 生成的桩骨架；唯一改动是 `Type.h` 里 `BILLBOARD_TYPE_2FACE` 行尾注释的 `\` 被 clang 当作续行吞掉下一行，去掉反斜杠。`platform/EterBase/Utils.cpp` 剩下的 21 个桩按 §3 照抄 40250 函数体（`GetOnlyPathName`/`IsGlobalFileName` 缺失会让 .msf 以相对名挂的 .mse 丢目录，106 个 RegisterEffect 报错），Win32 调用换成 POSIX 的记 ADAPTED；平台 `CPythonResource` 补上 40250 的 `mde`（CEffectMesh）和 `mdatr`（CAttributeData）资源类型。`port.utils` 覆盖路径/分词/命令行辅助函数；`port.login_flow`：在主角脚下 `CreateEffect(level_up.mse)`，RenderGame 的 `CEffectManager::Render` 录出 levelup_1 贴图的 alpha 混合粒子绘制（dust、dropitem 同样出现）。40250 声明但未定义 `GetRenderingEffectCount`，测试不用。
+   批次 3-c CMapOutdoor（2026-09-24）：`GameLib/` 的 Area、AreaTerrain、DungeonBlock、MapBase、MapManager、MapOutdoor（含 IndexBuffer/Load/Quadtree/Render/Update）、MapType、MonsterAreaInfo、Property/PropertyLoader/PropertyManager、SnowEnvironment/SnowParticle、TerrainDecal/Patch/Quadtree，`PRTerrainLib/` Terrain、TextureSet，`UserInterface/PythonBackground(+Module)`，`EterLib/ColorTransitionHelper` 原样移植，删除 pending 替身与 background 模块桩（含 GameplayModuleConstants 里的常量桩）；`EterBase/FileDir`、`TempFile` 在 platform 下照抄 40250 函数体（Win32 查找/临时文件走 common 垫片，记 ADAPTED）。`TEMP_CAreaLoaderThread` 在 40250 已全部注释掉，.cpp 不编（N_A）。手改两处：`CMapManager::BeginEnvironment` 的 `ApplyLight` 标签指针经 `uintptr_t` 转 DWORD；`CTerrainImpl::LoadWaterMap` 按 32 位读 water.wtr 的 `long` 再逐个扩宽（LP64 下 `long` 是 8 字节，否则报 FILE DATA SIZE 16392 != 16400）。平台文件：HTP/STP 地形绘制与 `RenderWater` 为空（地形仍由 Godot 适配层画，§3），STP 的 Initialize/Create/Destroy、水面贴图载入、角色阴影贴图创建照抄；`BeginRenderCharacterShadowToTexture` 返回 false（记 DIVERGENT）。录制设备补齐 `CreateTexture/VertexBuffer/IndexBuffer/DepthStencilSurface`、`Get/SetRenderTarget`、`LightEnable`、`Clear`（CPU 表面/贴图），离屏渲染目标的绘制丢弃，light0 只在启用且为方向光时记录。小地图：`CPythonMiniMap` 在正交投影下画 minimap.dds 瓦片并以 stage 1 相机空间坐标 × `D3DTS_TEXTURE1` 采样 `minimap_image_filter.dds` 做圆形遮罩——录制设备把「正交投影 + 未变换顶点」的绘制按四边形转成 UI 命令（带 mask 贴图与四角 mask uv），`UIRenderAddImage` 按 D3DTS_WORLD 平移、按 TFACTOR 调色（标记点），`python_ui_surface.gd` 用按序的子 canvas item 画 UI 流，带遮罩的图各用一个 shader 材质。`port.login_flow`：Warp 后 `IsMapOutdoor()`、`miniMap.GetAtlasSize()` 已载入、`background.GetCurrentMapName()` 非空；`python_game_render_test` 新增「minimap tiles drawn through the filter mask」（9 块）。已知未修：P3-b 起主角武器画在地上（挂点未跟骨骼），另行处理。
 
 每个切片都必须同时跑 legacy/port 双路回归；只有 2V3 稳定并把默认路由切到 `port` 后，才能删除总开关和剩余 legacy 宿主。