/* pcscreen.c —— **电脑屏窗口**（第三种窗口）的最小体检程序。
 * pcscreen.c — minimal self-check program for the **PC screen window** (the third window type).
 *
 * 用途：真机上验 `ui_win_open_pc`（`#582`）那三件与图形窗口不同的行为。
 * Purpose: verify on a real device the three behaviors of `ui_win_open_pc` (`#582`) that differ from a graphics window.
 * 它刻意**只画固定分辨率的东西** —— 屏幕上看到的应该是一整幅 640×480 的框，
 * It deliberately draws **only fixed-resolution things** — what you see should be a full 640x480 frame,
 * 等比缩放贴进画布、**四边都在**（不是被裁掉一截）。
 * scaled proportionally into the canvas, with **all four edges present** (not cropped).
 *
 * 该看到什么：
 * What you should see:
 *   ① 一圈边框正好贴着窗口**四边**（分辨率没被换过 / 没被裁）；
 *   1) A border exactly flush with the window's **four edges** (resolution not swapped / not cropped);
 *   ② 格线是 40 点一格 —— 数得出 16×12 格（不是自适应后的别的数字）；
 *   2) Grid lines every 40 points — you can count 16x12 cells (not some other adaptive number);
 *   ③ 底部两行：最后按下的键、以及鼠标位置；
 *   3) Two bottom lines: last key pressed, and mouse position;
 *   ④ **触摸**：手指按在哪儿，十字准星就画在哪儿（坐标是 640×480 那套）；
 *   4) **Touch**: the crosshair is drawn wherever the finger lands (coordinates are the 640x480 set);
 *   ⑤ **没有手柄区**（底部那排方向键/A/B 不该出现）；
 *   5) **No gamepad area** (the bottom row of D-pad/A/B buttons should not appear);
 *   ⑥ 按 Esc 或点窗口的返回箭头退出。
 *   6) Press Esc or tap the window's back arrow to exit.
 *
 * ⚠ 它**不是**给用户用的示例，是**体检程序** —— 与 `draw_prims.c` 同一性质：
 * ⚠ It is **not** a user-facing example but a **self-check program** — same nature as `draw_prims.c`:
 *   程序要的就是"固定格距、固定分辨率"，好让截图能逐项核对。
 *   The program wants "fixed grid spacing, fixed resolution" so screenshots can be checked item by item.
 *
 * 坐标说明：窗口宽高就是程序的坐标空间（这里 640×480，取 PC 上最眼熟那一档）。
 * Coordinates: the window width/height is the program's coordinate space (here 640x480, the most familiar PC tier).
 * 宿主默认等比缩放让你看全貌，双指可以放大细看 —— 那只是**显示**，
 * The host scales proportionally by default so you see the whole picture, and two fingers can zoom in — that is only **display**,
 * 程序这边的坐标一个数都不会变。
 * not a single coordinate on the program side changes.
 */
#include <vml_ui.h>

#define PC_W 640
#define PC_H 480
#define GRID 40

static int msg[4];

static int lastKey;      /* 最后按下的键码 */
                         /* Last key code pressed */
static int mx;           /* 鼠标（触摸）位置 */
                         /* Mouse (touch) position */
static int my;
static int clicked;      /* 鼠标按下的次数 —— 用来区分"只移动"和"真的点了" */
                         /* Number of mouse presses — distinguishes "just moved" from "actually clicked" */
static int touchSeen;    /* **收到过几次触摸消息** —— 电脑屏窗口里这个数**必须恒为 0** */
                         /* **How many touch messages arrived** — in a PC screen window this must **always be 0** */

static int lang;         /* 界面语言：开局查一次（ui_scr_get_language 是 syscall，别每帧调） */
                         /* UI language: queried once at start (ui_scr_get_language is a syscall, do not call it every frame) */

/* 一个 32 位色：0xAARRGGBB */
/* A 32-bit color: 0xAARRGGBB */
#define RGB_BG    0xFF101820
#define RGB_LINE  0xFF2A3A4A
#define RGB_EDGE  0xFF40C0FF
#define RGB_TEXT  0xFFE0E0E0
#define RGB_DIM   0xFF8090A0
#define RGB_MARK  0xFFFF4040

static void put_int(char* buf, int v)
{
    /* 极简十进制：避免依赖 printf 的格式化路径（当年记的是"那套会崩"，见宿主接口文档）。
       Minimal decimal conversion: avoids printf's formatting path (back then it was recorded as "that path crashes", see the host interface doc).
       ⚠ 2026-10-04 复验：**桌面脚手架**那条早已修好（`printf("%s %d %f %x %c", …)` 实测正确）；
       ⚠ Re-checked 2026-10-04: the **desktop-scaffold** crash was fixed long ago (`printf("%s %d %f %x %c", …)` measured correct);
         手机端这条**本轮未验**（需要真机）⇒ 注释原样保留，手写 put_int 也保留（能跑就别动）。
         the mobile side was **not verified this round** (a real device is needed) ⇒ the note stays as-is and so does the hand-written put_int (if it runs, do not touch it).
       返回写在 buf 里的字符串。
       Returns the string written into buf. */
    char t[12];
    int n = 0, i = 0, neg = 0;
    if (v < 0) { neg = 1; v = -v; }
    if (v == 0) { t[n] = '0'; n = 1; }
    while (v > 0 && n < 11) { t[n] = (char)('0' + v % 10); n = n + 1; v = v / 10; }
    if (neg) { buf[i] = '-'; i = i + 1; }
    while (n > 0) { n = n - 1; buf[i] = t[n]; i = i + 1; }
    buf[i] = 0;
}

static void draw_all(void)
{
    int x, y;
    char buf[64];
    int i;

    ui_2d_clear(RGB_BG);

    /* ① 格线：每 40 点一条 —— 数格子就能看出分辨率有没有被换过 */
    /* 1) Grid lines: one every 40 points — counting cells shows whether the resolution was swapped */
    for (x = GRID; x < PC_W; x = x + GRID)
        ui_2d_line(x, 0, x, PC_H, RGB_LINE, 1);
    for (y = GRID; y < PC_H; y = y + GRID)
        ui_2d_line(0, y, PC_W, y, RGB_LINE, 1);

    /* ② 四边贴边（空心矩形，线宽 3）—— 四边都在才说明没被裁 */
    /* 2) Flush on all four edges (hollow rectangle, line width 3) — all four present means not cropped */
    ui_2d_rect(2, 2, PC_W - 4, PC_H - 4, RGB_EDGE, 0, 3, 0);

    /* ③ 标题 */
    /* 3) Title */
    ui_2d_text(20, 10, lang == 0 ? "电脑屏窗口 640x480" : "PC screen window 640x480",
            RGB_EDGE, 24, VML_ANCHOR_LEFT);

    /* ④ 底部两行：最后按键 + 鼠标位置 */
    /* 4) Two bottom lines: last key + mouse position */
    buf[0] = 'K'; buf[1] = 'E'; buf[2] = 'Y'; buf[3] = ' ';
    i = 4;
    {
        char nb[12];
        int k;
        put_int(nb, lastKey);
        for (k = 0; nb[k] != 0; k = k + 1) { buf[i] = nb[k]; i = i + 1; }
    }
    buf[i] = 0;
    /* 这一行的末尾会再补上 TOUCH 计数（见下面那段） */
    /* The TOUCH counter is appended at the end of this line (see the block below) */
    ui_2d_text(20, PC_H - 64, buf, RGB_TEXT, 20, VML_ANCHOR_LEFT);

    buf[0] = 'M'; buf[1] = 'O'; buf[2] = 'U'; buf[3] = 'S'; buf[4] = 'E'; buf[5] = ' ';
    i = 6;
    {
        char nb[12];
        int k;
        put_int(nb, mx);
        for (k = 0; nb[k] != 0; k = k + 1) { buf[i] = nb[k]; i = i + 1; }
        buf[i] = ','; i = i + 1;
        put_int(nb, my);
        for (k = 0; nb[k] != 0; k = k + 1) { buf[i] = nb[k]; i = i + 1; }
        buf[i] = ' '; i = i + 1;
        buf[i] = '#'; i = i + 1;
        put_int(nb, clicked);
        for (k = 0; nb[k] != 0; k = k + 1) { buf[i] = nb[k]; i = i + 1; }
    }
    /* ⚠ 这一行是**"抑制触摸"的判据**：电脑屏窗口只该发鼠标消息，
       ⚠ This line is the **"touch suppression" criterion**: a PC screen window should only send mouse messages,
       触摸消息一条都不该来。这里若数出非 0，说明抑制没生效 ——
       not a single touch message should arrive. A non-zero count here means suppression is not working —
       而画面上看不出任何异常（准星照旧跟着走），只有这一行会变。
       and nothing looks wrong on screen (the crosshair still follows), only this line changes. */
    buf[i] = ' '; i = i + 1;
    buf[i] = 'T'; i = i + 1;
    buf[i] = 'O'; i = i + 1;
    buf[i] = 'U'; i = i + 1;
    buf[i] = 'C'; i = i + 1;
    buf[i] = 'H'; i = i + 1;
    buf[i] = ' '; i = i + 1;
    {
        char nb[12];
        int k;
        put_int(nb, touchSeen);
        for (k = 0; nb[k] != 0; k = k + 1) { buf[i] = nb[k]; i = i + 1; }
    }
    buf[i] = 0;
    ui_2d_text(20, PC_H - 36, buf, RGB_DIM, 20, VML_ANCHOR_LEFT);

    /* ⚠ **报警块**：只在"收到过触摸消息"时亮（右上角一块实心红）。
       ⚠ **Alarm block**: lights up only when "touch messages were received" (a solid red square in the top-right).
       电脑屏窗口里它**永远不该出现**。
       In a PC screen window it **should never appear**.
       为什么用色块而不是文字：画布上的文字**读不出**（不是 UI 节点），
       Why a color block instead of text: canvas text **cannot be read back** (it is not a UI node),
       而验收脚本要能**逐像素**判 —— 色块一行断言就够，不必上 OCR。
       and the acceptance script must judge **pixel by pixel** — a color block needs one assertion line, no OCR. */
    if (touchSeen > 0)
        ui_2d_rect(PC_W - 44, 8, 36, 20, RGB_MARK, 1, 0, 0);

    /* ⑤ 十字准星：触摸落在哪儿就画在哪儿（这就是"触摸当鼠标"的判据） */
    /* 5) Crosshair: drawn wherever the touch lands (this is the "touch acts as mouse" criterion) */
    if (mx > 0 || my > 0)
    {
        ui_2d_line(mx - 16, my, mx + 16, my, RGB_MARK, 2);
        ui_2d_line(mx, my - 16, mx, my + 16, RGB_MARK, 2);
        ui_2d_circle(mx, my, 8, RGB_MARK, 0, 2);
    }

    ui_2d_present();
}

int main()
{
    int h;

    /* 开电脑屏窗口：固定 640×480、不锁方向、要屏幕键盘。
       Open a PC screen window: fixed 640x480, orientation not locked, on-screen keyboard wanted.
       ⚠ 第 5 个参数是**键盘**（VML_WIN_NEED_KEYBOARD），不是手柄 ——
       ⚠ The 5th parameter is the **keyboard** (VML_WIN_NEED_KEYBOARD), not the gamepad —
       位置与 ui_win_open_ex 的第 5 个参数对称，但语义不同。
       it sits in the same position as the 5th parameter of ui_win_open_ex, but means something different. */
    lang = ui_scr_get_language();

    h = ui_win_open_pc(lang == 0 ? "电脑屏体检" : "PC screen self-check", PC_W, PC_H,
                       VML_WIN_ROTATABLE, VML_WIN_NEED_KEYBOARD);
    if (h < 0) return 1;

    ui_msg_clear();     /* 丢掉开窗之前积压的消息 */
                        /* Drop messages queued up before the window was opened */

    draw_all();

    while (ui_win_is_closed() == 0)
    {
        int t = ui_msg_wait(msg, 0);        /* timeout 0 = **无限等**（事件驱动，省电） */
                                        /* timeout 0 = **wait forever** (event driven, saves power) */
        if (t == 0) continue;

        if (t == VML_MSG_WINDOWCLOSE) break;

        /* 触摸**在这里应该是鼠标消息**（电脑屏窗口不发触摸消息）——
           Touch **should be a mouse message here** (a PC screen window does not send touch messages) —
           若下面这两支一次都不进，说明"抑制触摸"那条没生效。
           if neither of the two branches below is ever entered, that "touch suppression" is not working. */
        if (t == VML_MSG_MOUSEDOWN) { clicked = clicked + 1; mx = msg[1]; my = msg[2]; draw_all(); }
        else if (t == VML_MSG_MOUSEMOVE) { mx = msg[1]; my = msg[2]; draw_all(); }

        /* 触摸消息：**电脑屏窗口里不该出现**（见 touchSeen 的说明）。
           Touch messages: **should not appear in a PC screen window** (see the note on touchSeen).
           计数而不是忽略，是为了让"抑制失效"这件事**看得见**。
           Counting instead of ignoring makes "suppression failed" **visible**. */
        else if (t == VML_MSG_TOUCHDOWN || t == VML_MSG_TOUCHMOVE || t == VML_MSG_TOUCHUP)
        {
            touchSeen = touchSeen + 1;
            draw_all();
        }

        else if (t == VML_MSG_KEYDOWN)
        {
            lastKey = msg[1];
            if (lastKey == VML_KEY_ESCAPE) break;
            draw_all();
        }
    }

    ui_win_close();
    return 0;
}