compiler/examples/onepiece-doudizhu-win32/README.md

海贼王 · 斗地主（Win32 / TypePHP 示例）

将 HelgeSverre-libui-sdk/examples/onepiece-doudizhu.php（libui 版）移植为 TypePHP（tpc.exe）AOT 编译的原生 Win32 程序，参考 landlord-win32 的 「纯 PHP 逻辑 + C++ 薄封装 Win32 绑定」架构。

特性

• 完整保留原作玩法：三大势力（海军 / 七武海 / 四皇）、9 名角色技能、 叫地主 → 出牌 → 结算全流程，内置 AI 对手与托管。
• 界面由 Win32 GDI 自绘（海洋渐变背景、势力配色卡牌、对手面板、 可拖拽手牌、底部操作按钮）。
• 游戏逻辑 100% 在 PHP 中实现（php-src/doudizhu/），与 libui 版共用同一套 领域模型；C++（cpp-src/win32.cc）仅封装窗口、消息循环与 GDI 绘制原语。
• 单文件 exe，无外部 PHP 依赖，不依赖 libui / mbstring / miniaudio。

目录结构

onepiece-doudizhu-win32/
├── main.php                    入口：Win32 消息循环驱动 GameController
├── project.yml                 tpc.exe 构建配置（mode: bin）
├── build.bat                   一键编译脚本（需 VS 2022 x64 工具链环境）
├── cpp-src/
│   └── win32.cc                Win32 窗口 + GDI 绘制原语（C++ 薄封装）
└── php-src/
    ├── win32.stub.php          win_* 原生函数声明（stub）
    └── doudizhu/               游戏域模型 + 渲染 shim
        ├── Card / Deck / Combo / MoveGenerator / Game / Ai / Skill /
        │   Character / Faction / PlayerState   纯逻辑（与 libui 版同源）
        ├── GameController.php  对局编排 + Win32 输入/渲染适配
        ├── Render.php          libui DrawContext 兼容 shim → GDI
        └── Sound.php           音效管理器（TypePHP 版为空实现，保留 API）

编译

在 x64 Native Tools Command Prompt for VS 2022（或已加载 vcvars64.bat 的终端）中执行：

build.bat

脚本会：

1. 校验 cl.exe 可用（不在 VS 环境中会提示）。
2. 从 TypePHP 根目录调用 tpc.exe project.yml（tpc 打包后按 CWD 解析 vendor/autoload.php，必须从根目录运行）。
3. 将产物 onepiece_doudizhu.exe 复制回示例目录。

等价手动命令：

set PHP_HOME=D:\git\php\tpc_v1095_windows_x86_64
set PHPX_HOME=%PHP_HOME%\phpx
set PATH=%PHP_HOME%;%PATH%
cd /d D:\git\php\tpc_v1095_windows_x86_64
tpc.exe examples\onepiece-doudizhu-win32\project.yml --no-progress

运行

onepiece_doudizhu.exe

• 拖拽手牌选牌，底部按钮：出牌 / 不出 / 提示 / 技能 / 托管。
• 右上角按钮切换音效（当前为占位实现）。
• 关闭窗口或 Esc 退出。

移植要点

1. 渲染 shim（Render.php）：原 GameController 的绘制代码直接使用 libui 的 DrawContext / Brush / Color / FontDescriptor / DrawTextAlign / TextWeight，这些符号在 php-src/doudizhu/Render.php 中同命名空间重新声明， WinDrawContext 把每个调用翻译为 win_fill_rect / win_fill_ellipse / win_fill_rounded_rect / win_stroke_rounded_rect / win_draw_text_ex。 渐变近似为纯色填充；颜色统一 0xRRGGBB → COLORREF(0xBBGGRR) 转换。
2. 输入驱动：libui 的 AreaDelegate::mouse/key 改为 main.php 主循环 轮询 win_peek_message()，把 WM_LBUTTONDOWN/UP/MOUSEMOVE/KEYDOWN 转换为 GameController::onMouse()/onKey() 调用。
3. 定时器：Loop::delay 改为 GameController::tick()，由主循环每帧 调用，驱动 AI 走子 / 叫分 / 托管（基于 win_get_tick_count()）。
4. TypePHP 兼容性修正（相对 libui 版源码）：
   • 顶层游离代码（define('FONT', …)）包装进 ensureDdzFont()，由 main() 调用——TPC 要求所有执行代码位于函数内。
   • readonly 属性 / &$ref 引用遍历等改为普通属性 / 下标赋值（TPC 语法限制）。
   • mb_strlen / mb_substr 改为 ddz_utf8_len / ddz_utf8_substr （PCRE 实现，TPC 运行时未链接 mbstring）。
   • Brush::linearGradient() 签名改为与 libui 一致的 (x0,y0,x1,y1, stops) 形式，避免 TPC 变参类型推断失败。
5. 双缓冲位图管理（win32.cc）：修复 GetStockObject(BITMAP) 用法错误 （BITMAP 是类型不是常量），改为保存/恢复 DC 原 bitmap 后再删除离屏位图。
6. 窗口尺寸（win32.cc）：win_create_window 把传入宽高当作客户区尺寸 （AdjustWindowRect 自动补上标题栏/边框），保证底部按钮完整可见；窗口 样式为 WS_OVERLAPPEDWINDOW，支持拖拽缩放与最大化。新增 win_get_client_size() 返回当前客户区尺寸，render()/drawButtons() 每帧按实际尺寸自适应布局（绘制与点击命中均基于当前尺寸记录的矩形）。
7. 运行时兼容性：MoveGenerator::all() 的 $cnt 闭包改为 count($byRank[$r] ?? [])——原实现 count($byRank[$r]) 在顺子/连对 枚举缺失 rank 时对 null 调用 count()，TypePHP 运行时（PHP 8 严格类型） 抛 TypeError: count(): Argument #1 must be of type Countable|array。
8. 窗口标题乱码（win32.cc）：本机腾讯电脑管家（tsbx.dll）会 inline-hook 进程内 user32 的 DefWindowProcA / CreateWindowExW / SetWindowTextW， 导致窗口标题被改写为乱码（"wm<崑s " 之类）。修复：
   • DdzWndProc 末尾显式调用 DefWindowProcW（而非 DefWindowProc 宏， 后者在非 UNICODE 编译下展开为被 hook 的 DefWindowProcA）。
   • php_win_create_window 通过 LoadLibraryW("C:\\Windows\\System32\\user32.dll")
     • GetProcAddress 解析原始 CreateWindowExW / SetWindowTextW 调用， 创建后再用原始 SetWindowTextW 重设一次标题（双保险）。
   • 对照组验证：Explorer / Edge / SmartGit 等其它进程窗口标题读取正常， 仅本进程自定义 WndProc 窗口受影响，证明是进程内 hook 而非系统/代码问题。
9. 托管节奏（GameController.php）：Win32 移植版里 defer() 与 delay() 都由主循环 tick() 驱动、机制相同。原代码在托管/AI 走子/叫分处同时挂 defer（立即执行）+ delay（兜底），导致动作在下一帧瞬间完成，玩家 来不及点「取消托管」。修复：
   • 去掉托管分支的 defer，只保留 1500ms 延迟（充足取消窗口）。
   • scheduleAi() 去掉 defer，AI 出牌节奏改为 800ms。
   • scheduleBidStep() 去掉 defer，AI 叫分节奏改为 700ms。
   • toggleAutoPlay() 关闭托管时调用 cancelTimers() 立即取消挂起的 托管定时器；autoPlayStep() 原有 !$this->autoPlay 保护兜底。
   • toggleAutoPlay() 关闭托管且轮到玩家时，重新调用 setActionsForHumanTurn() 重算按钮状态——托管时「出牌/不出/提示/技能」 按 !autoPlay 被禁用，恢复后必须重算才能重新可点。