Window

Opening a window, asking for the size, closing it, screen orientation.

For the full list see "UI development". Each call below comes with a one-line usage note and an example; signatures come from Lib/c/vml_ui.h (the authoritative source).

ui_scr_get_orientation(void)

The device orientation: VML_ORIENT_PORTRAIT(0) / VML_ORIENT_LANDSCAPE(1). **Do not infer it from scr_w > scr_h** - that is the available drawing area (which changes when the gamepad is collapsed); the orientation is a property of the device itself.

if (ui_scr_get_orientation() == VML_ORIENT_LANDSCAPE) { /* lay out horizontally */ }

ui_scr_get_h(void)

The height of the available drawing area.

int h = ui_scr_get_h();

ui_scr_get_w(void)

The width of the available drawing area (you can ask this before opening a window).

int w = ui_scr_get_w();

ui_win_close(void)

Closes the window (for a program that ends on its own).

ui_win_close();

ui_win_is_closed(void)

Whether the user has already closed the window (the exit condition of your main loop).

while (ui_win_is_closed() == 0) { ... }

ui_win_open(char* title, int w, int h)

Opens a drawing window. **Ask ui_scr_get_w/h() for the available drawing area first, then open with it** - a hard-coded size overflows on a small screen.

int w = ui_scr_get_w(), h = ui_scr_get_h();
ui_win_open("My game", w, h);

ui_win_open_ex(char* title, int w, int h, int rotatable, int gamepad)

The same, plus two declarations that take effect before the window opens: the rotation policy and whether you want a gamepad area.

/* Gomoku: portrait only + no gamepad */
ui_win_open_ex("Gomoku", w, h, VML_WIN_PORTRAIT, VML_WIN_NO_GAMEPAD);
/* Racing: locked to landscape + gamepad wanted */
ui_win_open_ex("Racing", w, h, VML_WIN_LANDSCAPE, VML_WIN_NEED_GAMEPAD);

ui_win_open_pc(char* title, int w, int h, int rotatable, int keyboard)

Opens a "PC screen" window: the "character grid + mouse" model of an old DOS/BGI program (it wants a keyboard and mouse, not the phone gamepad).

ui_win_open_pc("Old program", 640, 400, VML_WIN_ROTATABLE, VML_WIN_NEED_KEYBOARD);