textat x,y

Author: omiq

README.md

@@ -85,6 +85,27 @@ Run this once after unpacking, and macOS will stop treating the binary as “fro
 
 - **`SLEEP`**: pause execution for a number of 60 Hz “ticks” (e.g., `SLEEP 60` ≈ 1 second).
 
+### Screen coordinates and cursor positioning
+
+- **Coordinate system**:
+  - `LOCATE col, row` and `TEXTAT col, row, text` both use **0‑based** screen coordinates, where `0,0` is the top‑left corner.
+  - Internally these are mapped to ANSI escape sequences as `ESC[row+1;col+1H`.
+- **`LOCATE`**:
+  - Moves the cursor without printing: e.g. `LOCATE 10,5` positions the cursor at column 10, row 5 before the next `PRINT`.
+- **`TEXTAT`**:
+  - `TEXTAT x, y, text` moves the cursor to `(x, y)` and writes `text` directly at that absolute position.
+  - `text` is any string expression, for example: `TEXTAT 0, 0, "SCORE: " + STR$(S)`.
+- **Keeping final text visible**:
+  - Terminals often print the shell prompt immediately after your program exits; if your last output is on the bottom row, an implicit newline or prompt can scroll it off‑screen.
+  - To make sure your final UI remains visible, **explicitly position the cursor after your last `TEXTAT`/`LOCATE` output**, for example:
+
+```basic
+LOCATE 0, 22
+PRINT "PRESS ANY KEY TO CONTINUE";
+```
+
+  - This ensures the cursor (and thus any following prompt) appears where you expect, rather than accidentally pushing your last line out of view.
+
 
 ## 🎛️ Usage
 

basic.c

@@ -219,6 +219,7 @@ static void statement_read(char **p);
 static void print_value(struct value *v);
 static void print_spaces(int count);
 static void statement_sleep(char **p);
+static void statement_textat(char **p);
 static void statement_def(char **p);
 static void statement_get(char **p);
 static void do_sleep_ticks(double ticks);
@@ -2090,6 +2091,45 @@ static void statement_print(char **p)
 }
 
 
+static void statement_textat(char **p)
+{
+    struct value vx, vy, vtext;
+    int x, y;
+
+    /* TEXTAT x, y, text */
+    vx = eval_expr(p);
+    ensure_num(&vx);
+    skip_spaces(p);
+    if (**p != ',') {
+        runtime_error("TEXTAT: expected ',' after X");
+        return;
+    }
+    (*p)++;
+
+    vy = eval_expr(p);
+    ensure_num(&vy);
+    skip_spaces(p);
+    if (**p != ',') {
+        runtime_error("TEXTAT: expected ',' after Y");
+        return;
+    }
+    (*p)++;
+
+    vtext = eval_expr(p);
+    ensure_str(&vtext);
+
+    x = (int)vx.num;
+    if (x < 0) x = 0;
+    y = (int)vy.num;
+    if (y < 0) y = 0;
+
+    /* Move cursor with ANSI: rows/cols are 1-based */
+    printf("\033[%d;%dH", y + 1, x + 1);
+    fputs(vtext.str, stdout);
+    fflush(stdout);
+}
+
+
 static void statement_locate(char **p)
 {
     // Passed as LOCATE x, y
@@ -2538,6 +2578,11 @@ static void execute_statement(char **p)
         statement_let(p);
         return;
     }
+    if (c == 'T' && starts_with_kw(*p, "TEXTAT")) {
+        *p += 6;
+        statement_textat(p);
+        return;
+    }
     if (c == 'L' && starts_with_kw(*p, "LOCATE")) {
         *p += 6;
         statement_locate(p);