Add explanatory comments on text drawing functions

1 files changed, 26 insertions, 24 deletions

diff --git a/src/text/text.h b/src/text/text.h
index 630f04f..3b7921d 100644
--- a/src/text/text.h
+++ b/src/text/text.h
@@ -25,6 +25,7 @@ typedef struct TextEngine {
 
 static TextEngine text_engine = {0};
 
+// Initializes the text engine.
 static inline
 void
 txt_init(u32 *font_data, u16 *font_tilemap, u16 font_offset) {
@@ -43,38 +44,35 @@ txt_init(u32 *font_data, u16 *font_tilemap, u16 font_offset) {
     text_engine.font_tilemap = font_tilemap;
 }
 
+// Writes a message to the tile text background.
 static inline
 void
-txt_putc(char c) {
-    if (c == '\0') {
-        return;
-    }
-    if (c == '\n') {
-        text_engine.cursor_x = 0;
-        text_engine.cursor_y++;
-    } else {
-        int x = text_engine.cursor_x;
-        int y = text_engine.cursor_y;
-        text_engine.font_tilemap[x + 32 * y] = text_engine.font_map[(u16)c];
-        text_engine.cursor_x += 1;
-        if (text_engine.cursor_x >= 30) {
+txt_puts(char *msg) {
+    while (*msg) {
+        char c = *msg++;
+        if (c == '\0') {
+            continue;
+        }
+        if (c == '\n') {
             text_engine.cursor_x = 0;
             text_engine.cursor_y++;
+        } else {
+            int x = text_engine.cursor_x;
+            int y = text_engine.cursor_y;
+            text_engine.font_tilemap[x + 32 * y] = text_engine.font_map[(u16)c];
+            text_engine.cursor_x += 1;
+            if (text_engine.cursor_x >= 30) {
+                text_engine.cursor_x = 0;
+                text_engine.cursor_y++;
+            }
+        }
+        if (text_engine.cursor_y >= 20) {
+            text_engine.cursor_y = 0;
         }
-    }
-    if (text_engine.cursor_y >= 20) {
-        text_engine.cursor_y = 0;
-    }
-}
-
-static inline
-void
-txt_puts(char *msg) {
-    while (*msg) {
-        txt_putc(*msg++);
     }
 }
 
+// Clears the current line on the tile text mode.
 static inline
 void
 txt_clear_line(void) {
@@ -86,6 +84,7 @@ txt_clear_line(void) {
     text_engine.cursor_x = 0;
 }
 
+// Clears the screen on the tile text mode.
 static inline
 void
 txt_clear_screen(void) {
@@ -97,6 +96,7 @@ txt_clear_screen(void) {
     text_engine.cursor_y = 0;
 }
 
+// Moves the tile mode cursor to the specified position.
 static inline
 void
 txt_position(size_t tile_x, size_t tile_y) {
@@ -127,6 +127,8 @@ txt_draws(char *msg, size_t x, size_t y, size_t spacing) {
                 txt_puts(buf); \
         }
 
+// Draws text to the screen with formatting starting on the x and y position and
+// with custom character spacing.
 #define txt_drawf(msg, x, y, s, ...) \
         { \
                 char buf[256] = {0}; \