// demo_ui.rs —— **最新 UI 接口**示范（Rust）
// demo_ui.rs -- the **newest UI interface** demo (Rust)
//
// 四层示范的第四层：开 `ui_*` 绘图窗口 + **查屏幕方向** + 画图元 + `ui_2d_present` +
// The fourth of the four demo layers: open a `ui_*` drawing window + **query the screen orientation** + draw primitives + `ui_2d_present` +
// 处理触摸/按键，**有界**（收到任意键就退出，否则画满 60 帧自动退出），正常结束。
// handle touch/keys, **bounded** (exit on any key, otherwise exit automatically after 60 frames), then exit normally.
//
// 与第三层（BGI）刻意不同：BGI 是"固定分辨率 + 索引色"的老世界，这一层是
// Deliberately different from the third layer (BGI): BGI is the old world of "fixed resolution + indexed colors", while this layer is
// **宿主窗口 + 0xAARRGGBB 真彩 + 统一消息队列**。四条关键差别：
// **a host window + 0xAARRGGBB true color + a unified message queue**. Four key differences:
//
//   ① **开窗显式**：`ui_win_open(标题, 宽, 高)`，宽高来自 `ui_scr_get_w()/ui_scr_get_h()`
//   ① **Opening the window is explicit**: `ui_win_open(title, width, height)`, where width/height come from `ui_scr_get_w()/ui_scr_get_h()`
//      （可用绘图区），不是写死的 640x480。
//      (the usable drawing area), not a hard-coded 640x480.
//   ② **屏幕方向要问**：`ui_scr_get_orientation()` 返回 0=竖屏 / 1=横屏 —— 程序据此决定
//   ② **The screen orientation must be asked**: `ui_scr_get_orientation()` returns 0=portrait / 1=landscape -- the program uses it to decide
//      "面板横排还是竖排"。**开窗之前就能问**（见 `Lib/c/vml_ui.h`）。
//      "lay the panel out horizontally or vertically". **It can be asked before the window is opened** (see `Lib/c/vml_ui.h`).
//   ③ **显式呈现**：图元只是追加进场景，`ui_2d_present()` 才是"这一帧画完了"的帧边界。
//   ③ **Presentation is explicit**: primitives are only appended to the scene; `ui_2d_present()` is the frame boundary that says "this frame is done".
//   ④ **输入是消息队列**：键盘/触摸/定时器/窗口事件全走同一个队列
//   ④ **Input is a message queue**: keyboard/touch/timer/window events all go through the same queue
//      （`ui_msg_fetch_wait` / `ui_msg_get_a` / `ui_win_is_closed`）。
//
// ◆ 跑法与"画面怎么看"（桌面 vmlcli）
// ◆ How to run it and "how to look at the picture" (desktop vmlcli)
//
//   dotnet scripts/vmlcli/bin/Release/net10.0/vmlcli.dll \
//       third_party/vml/Examples/rust/demo_ui.rs --screen 480x640 --frames /tmp/out_frames/
//
// ⚠ **要看画面请用 `--frames 目录`，不要用 `--frame 单个文件`**。原因不在本程序：
// ⚠ **To see the picture use `--frames <dir>`, not `--frame <single file>`**. The reason is not in this program:
//   `ui_win_close()`（#521）在宿主侧把**整个场景置空**（`VmlHostRuntime.WinClose` 的
//   on the host side `ui_win_close()` (#521) **nulls out the whole scene** (`_scene = null` in
//   `_scene = null`），于是程序跑完之后 `--frame` 那一刀**已经没有场景可取**，只会打一行
//   `VmlHostRuntime.WinClose`), so after the program finishes that `--frame` shot **has no scene left to take** and only prints
//   「没有可导出的帧（场景是空的）」。`--frames` 是**每帧 present 当场拍快照**，
//   "no frame to export (the scene is empty)". `--frames` **takes a snapshot right at each present**,
//   所以照常出图。这是桌面脚手架的行为，不是本程序写错了 —— 手机上窗口关掉当然也没有画面。
//   so it still produces images. This is the desktop scaffolding's behavior, not a mistake in this program -- of course there is no picture after the window is closed on a phone either.
//
// ◆ 有界（任务要求）
// ◆ Bounded (a task requirement)
//
//   两条出口都写了：收到**任意按键**（消息类型 1 = KeyDown）立刻退出；或画满 60 帧自动退出。
//   Both exits are implemented: **any key press** (message type 1 = KeyDown) exits immediately; or drawing 60 frames exits automatically.
//   退出前 `ui_win_close()`，程序正常结束、退出码 0。
//   `ui_win_close()` runs before exiting; the program ends normally with exit code 0.
//
// 跑法：命令行页输入  vml run examples/rust/demo_ui.rs
// How to run: type this into the command-line page:  vml run examples/rust/demo_ui.rs
//
// 颜色：0xAARRGGBB 写**负数十进制**（Rust 词法器十进制专用，不认 `0x`）。
// Colors: 0xAARRGGBB is written as a **negative decimal** (the Rust lexer is decimal-only and does not accept `0x`).

// ◆ UI 库的显式引用
//   The explicit reference to the UI library
//
// `use vml_ui::*;` —— 声明文件是 `Lib/rust/vml_ui.rs`（GenLib 生成，155 个 `ui_*`，**不要手改**）：
// `use vml_ui::*;` -- the declaration file is `Lib/rust/vml_ui.rs` (generated by GenLib, 155 `ui_*`; **do not hand-edit**):
//
//     cd third_party/vml && dotnet run --project tools/GenLib -- -n -c vmlui -l rust -o Lib/rust/vml_ui.rs
//
// 本前端**不需要**声明就能解析 `ui_*`（它按 `ui_` 前缀自动链 `vmlui.vml`），
// This frontend resolves `ui_*` **without** any declaration (it auto-links `vmlui.vml` by the `ui_` prefix),
// 这条引用是**文档级**的：它标明"这个程序用 UI 库"，并让这份例程与其余语言同形。
// so this line is **documentation-level**: it states that this program uses the UI library and keeps
// this example shaped like every other language's.
// 实测（删掉这一行，产物与画面完全一致）：见仓库 docs 里那份「UI 库导入约定」的第二节 rust 行。
// Measured: deleting this line changes nothing -- the same instruction count and the same drawn picture;
// see the rust row in section two of the UI-library import convention document under docs.
#include <vml_ui.rs>
use vml_ui::*;

fn main() {
    // ── 开窗之前就问方向（这是这一层与 BGI 最"新"的一条）──────────
    // -- Ask the orientation before opening the window (this is the "newest" item of this layer vs. BGI) --
    let ori = ui_scr_get_orientation();
    let lang = ui_scr_get_language();

    // 开窗：尺寸传 0 ⇒ **交给宿主用真实可用区**。开窗**之前** `ui_scr_get_w/h` 只能估算，而估算与
    // Open the window: pass size 0 ⇒ **the host uses the real available area**. **Before** the open,
    // 实际总有出入（这就是"内容偏上"的根因）⇒ 所以尺寸改在**开窗之后**问（那时才是真实画布）。
    // `ui_scr_get_w/h` can only estimate and the estimate differs from reality (exactly why the content sat high) ⇒ the size is now queried **after** the open, when it is the real canvas.
    if lang == 0 { ui_win_open("UI 接口演示", 0, 0); } else { ui_win_open("UI API demo", 0, 0); }
    ui_scr_set_keep_on(1);

    // 尺寸：开窗之后再问一次（拿不到就退到竖屏默认值）
    // Size: re-queried after the open (falling back to the portrait default if unavailable)
    let mut w = ui_scr_get_w();
    let mut h = ui_scr_get_h();
    if w <= 0 { w = 360; }
    if h <= 0 { h = 620; }
    let tid = ui_timer_set(30, 1);

    let mut frames = 0;
    let mut keys = 0;
    let mut tx = 0;
    let mut ty = 0;
    let mut touched = 0;
    let mut running = 1;

    while running != 0 {
        if ui_win_is_closed() != 0 { break; }
        if frames >= 60 { break; }

        // ── ① 底色 + 标题（居中锚点 = 1）────────────────────────
        // -- ① Background color + title (center anchor = 1) --
        ui_2d_clear(-15724520);
        if lang == 0 { ui_2d_text(w / 2, 26, "Dolaima  ui_*  接口演示 (Rust)", -6643536, 16, VML_ANCHOR_CENTER); } else { ui_2d_text(w / 2, 26, "Dolaima  ui_*  API demo (Rust)", -6643536, 16, VML_ANCHOR_CENTER); }
        if lang == 0 { ui_2d_text(w / 2, 50, "开窗 / 方向 / 图元 / present / 消息队列", -6643536, 12, VML_ANCHOR_CENTER); } else { ui_2d_text(w / 2, 50, "window / orientation / primitives / present / message queue", -6643536, 12, VML_ANCHOR_CENTER); }

        // ── ② 屏幕方向（0=竖屏 1=横屏）──────────────────────────
        // -- ② Screen orientation (0=portrait 1=landscape) --
        if lang == 0 { ui_2d_text(14, 80, "屏幕方向 =", -11409298, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(14, 80, "Orientation =", -11409298, 13, VML_ANCHOR_LEFT); }
        ui_2d_text(96, 80, int_to_str(ori), -11409298, 13, VML_ANCHOR_LEFT);
        if ori == 1 { if lang == 0 { ui_2d_text(126, 80, "(横屏)", -11409298, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(126, 80, "(LANDSCAPE)", -11409298, 13, VML_ANCHOR_LEFT); } }
        else { if lang == 0 { ui_2d_text(126, 80, "(竖屏)", -11409298, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(126, 80, "(PORTRAIT)", -11409298, 13, VML_ANCHOR_LEFT); } }

        // ── ③ 图元：矩形（实心 / 空心 / 圆角）──────────────────
        // -- ③ Primitives: rectangles (filled / hollow / rounded) --
        if lang == 0 { ui_2d_text(14, 108, "图元：矩形", -6643536, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(14, 108, "Primitives: rect", -6643536, 13, VML_ANCHOR_LEFT); }
        ui_2d_rect(14, 126, 84, 46, -11409298, 1, 0, 0);
        ui_2d_rect(108, 126, 84, 46, -131246, 0, 2, 0);
        ui_2d_rect(202, 126, 84, 46, -63488, 1, 0, 12);

        // ── ④ 图元：圆 / 椭圆 / 线 ──────────────────────────────
        // -- ④ Primitives: circle / ellipse / line --
        if lang == 0 { ui_2d_text(14, 196, "图元：圆 / 椭圆 / 线", -6643536, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(14, 196, "Primitives: circle / ellipse / line", -6643536, 13, VML_ANCHOR_LEFT); }
        ui_2d_circle(46, 250, 30, -131246, 1, 0);
        ui_2d_circle(120, 250, 30, -11409298, 0, 3);
        ui_2d_ellipse(210, 250, 44, 26, -63488, 1, 0);
        let mut i = 0;
        while i < 8 {
            ui_2d_line(14, 300 + i * 6, w - 14, 300 + i * 6, -15263713, 2);
            i = i + 1;
        }

        // ── ⑤ 16 级灰度色带（0xAARRGGBB 真彩）──────────────────
        // -- ⑤ A 16-step gray ramp (0xAARRGGBB true color) --
        if lang == 0 { ui_2d_text(14, 358, "真彩（0xAARRGGBB）：", -6643536, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(14, 358, "Truecolor (0xAARRGGBB):", -6643536, 13, VML_ANCHOR_LEFT); }
        let mut s = 0;
        while s < 8 {
            if s == 0 { ui_2d_rect(14 + s * 40, 376, 36, 26, -16777216, 1, 0, 0); }
            if s == 1 { ui_2d_rect(14 + s * 40, 376, 36, 26, -14671840, 1, 0, 0); }
            if s == 2 { ui_2d_rect(14 + s * 40, 376, 36, 26, -12566464, 1, 0, 0); }
            if s == 3 { ui_2d_rect(14 + s * 40, 376, 36, 26, -10066330, 1, 0, 0); }
            if s == 4 { ui_2d_rect(14 + s * 40, 376, 36, 26, -8355712, 1, 0, 0); }
            if s == 5 { ui_2d_rect(14 + s * 40, 376, 36, 26, -6250336, 1, 0, 0); }
            if s == 6 { ui_2d_rect(14 + s * 40, 376, 36, 26, -4210753, 1, 0, 0); }
            if s == 7 { ui_2d_rect(14 + s * 40, 376, 36, 26, -1, 1, 0, 0); }
            s = s + 1;
        }

        // ── ⑥ 动画 + 帧进度条（证明每帧确实在重画）─────────────
        // -- ⑥ Animation + frame progress bar (proof that every frame really redraws) --
        let mut col = 14 + frames - (frames / 20) * 20;
        col = 14 + col * 10;
        if col > w - 46 { col = 14; }
        ui_2d_circle(col, 448, 18, -63488, 1, 0);
        ui_2d_rect(14, 480, (w - 28) * frames / 60, 10, -11409298, 1, 0, 4);

        // ── ⑦ 消息队列：帧数 / 最后一次按键 / 最后一次触摸 ──────
        // -- ⑦ Message queue: frame count / last key / last touch --
        if lang == 0 { ui_2d_text(14, 506, "已画帧数 =", -6643536, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(14, 506, "Frames drawn =", -6643536, 13, VML_ANCHOR_LEFT); }
        ui_2d_text(112, 506, int_to_str(frames), -6643536, 13, VML_ANCHOR_LEFT);
        if lang == 0 { ui_2d_text(14, 528, "最后一次按键 =", -6643536, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(14, 528, "Last key =", -6643536, 13, VML_ANCHOR_LEFT); }
        ui_2d_text(140, 528, int_to_str(keys), -6643536, 13, VML_ANCHOR_LEFT);
        if touched == 1 {
            if lang == 0 { ui_2d_text(14, 550, "最后一次触摸 =", -6643536, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(14, 550, "Last touch =", -6643536, 13, VML_ANCHOR_LEFT); }
            ui_2d_text(140, 550, int_to_str(tx), -6643536, 13, VML_ANCHOR_LEFT);
            ui_2d_text(190, 550, int_to_str(ty), -6643536, 13, VML_ANCHOR_LEFT);
            ui_2d_circle(tx, ty, 26, -131246, 0, 3);
        } else {
            if lang == 0 { ui_2d_text(14, 550, "最后一次触摸 = 无（点一下试试）", -6643536, 13, VML_ANCHOR_LEFT); } else { ui_2d_text(14, 550, "Last touch = none (try tapping)", -6643536, 13, VML_ANCHOR_LEFT); }
        }

        if lang == 0 { ui_2d_text(w / 2, h - 24, "按任意键退出，或画满 60 帧自动退出", -6643536, 12, VML_ANCHOR_CENTER); } else { ui_2d_text(w / 2, h - 24, "Press any key to exit, or it exits after 60 frames", -6643536, 12, VML_ANCHOR_CENTER); }

        // ── ⑧ 帧边界 ────────────────────────────────────────────
        // -- ⑧ Frame boundary --
        ui_2d_present();

        // ── ⑨ 收一条消息（最多等 30ms，保证循环有界）────────────
        // -- ⑨ Take one message (wait at most 30ms, keeping the loop bounded) --
        let t = ui_msg_fetch_wait(30);
        if t == 10 { running = 0; }
        else if t == 1 { keys = ui_msg_get_a(); running = 0; }
        else if t == 6 { tx = ui_msg_get_a(); ty = ui_msg_get_b(); touched = 1; }
        else if t == 4 { tx = ui_msg_get_a(); ty = ui_msg_get_b(); touched = 1; }

        frames = frames + 1;
    }

    // ── 收尾：关定时器、放开屏幕常亮、关窗 ──────────────────────
    // -- Wrap-up: stop the timer, release keep-screen-on, close the window --
    ui_timer_kill(tid);
    ui_scr_set_keep_on(0);
    ui_win_close();
}
