X-Git-Url: https://plomlompom.com/repos/foo.html?a=blobdiff_plain;f=src%2Fdraw_wins.h;h=8801f13fe8978d4fd977edfce14d872b6d102606;hb=96cc2077a4b491df2f13e71215db01ed7261cb84;hp=2013efd4f4893b718ee510d4ea5ab145314da5c0;hpb=b944d403e356e444b47b0f5768406c0527151be0;p=plomrogue
diff --git a/src/draw_wins.h b/src/draw_wins.h
index 2013efd..8801f13 100644
--- a/src/draw_wins.h
+++ b/src/draw_wins.h
@@ -1,15 +1,52 @@
+/* draw_wins.h
+ *
+ * Routnes for drawing the game's windows' contents.
+ */
+
#ifndef DRAW_WINS_H
#define DRAW_WINS_H
-#include
+
+#include /* for uint16_t */
struct Win;
-extern void draw_with_linebreaks (struct Win *, char *, uint16_t);
-extern void draw_text_from_bottom (struct Win *, char *);
-extern void draw_log_win (struct Win *);
-extern void draw_map_win (struct Win *);
-extern void draw_info_win (struct Win *);
-extern void draw_keys_win (struct Win *);
+
+/* Write "text" into window "win" as far as possible. Start on row "start_y".
+ *
+ * TODO: Why is this external?
+ */
+extern void draw_with_linebreaks(struct Win * win, char * text,
+ uint16_t start_y);
+
+
+
+/* Write "text" not starting from the top but from the bottom of "win".
+ *
+ * TODO: Why is this external?
+ */
+extern void draw_text_from_bottom(struct Win * win, char * text);
+
+
+
+/* Write game log text into "win" from bottom to top. */
+extern void draw_log_win(struct Win * win);
+
+
+
+/* Draw game map and actors/objects on it into "win". Respect scroll offset. */
+extern void draw_map_win(struct Win * win);
+
+
+
+/* Draw into "win" the game / player status infos. */
+extern void draw_info_win(struct Win * win);
+
+
+
+/* Draw keybindings selection/manipulation menu. */
+extern void draw_keys_win(struct Win * win);
+
+
#endif