X-Git-Url: https://de.git.xonotic.org/?a=blobdiff_plain;f=ui.h;h=a9b94688c9fd58a286f8ae7ab5bfade2f96daef0;hb=83b77bee53d11d3e694f34e242e15cacdce188cd;hp=5d58c6ddf0ad5a443556a530c373252774ea3cc8;hpb=8468ffaf8162a4fe8361127385c40141c375661d;p=xonotic%2Fdarkplaces.git

diff --git a/ui.h b/ui.h
index 5d58c6dd..a9b94688 100644
--- a/ui.h
+++ b/ui.h
@@ -1,4 +1,9 @@
 
+#ifndef UI_H
+#define UI_H
+
+// these defines and structures are for internal use only
+// (ui_t is passed around by users of the system, but should not be altered)
 #define MAX_UI_COUNT 16
 #define MAX_UI_ITEMS 256
 
@@ -7,6 +12,7 @@ typedef struct
 	char name[32];
 	int flags;
 	qpic_t *draw_pic;
+	char *draw_string;
 	int draw_x, draw_y;
 	int click_x, click_y, click_x2, click_y2;
 	void(*leftkey)(void *nativedata1, void *nativedata2, float data1, float data2);
@@ -26,16 +32,40 @@ typedef struct
 }
 ui_t;
 
+// engine use:
+// initializes the ui system
 void ui_init(void);
+// updates the mouse position, given an absolute loation (some input systems use this)
 void ui_mouseupdate(float x, float y);
+// updates the mouse position, by an offset from the previous location (some input systems use this)
 void ui_mouseupdaterelative(float x, float y);
+// left key update
+void ui_leftkeyupdate(int pressed);
+// right key update
+void ui_rightkeyupdate(int pressed);
+// up key update
+void ui_upkeyupdate(int pressed);
+// down key update
+void ui_downkeyupdate(int pressed);
+// mouse button update (note: 0 = left, 1 = right, 2 = middle, 3+ not supported yet)
+void ui_mousebuttonupdate(int button, int pressed);
+// perform input updates and check for clicks on items (note: calls callbacks)
+void ui_update(void);
+// draw all items of all panels
+void ui_draw(void);
+
+// intentionally public functions:
+// creates a panel
 ui_t *ui_create(void);
+// frees a panel
 void ui_free(ui_t *ui);
+// empties a panel, removing all the items
 void ui_clear(ui_t *ui);
+// sets an item in a panel (adds or replaces the item)
 void ui_item
 (
 	ui_t *ui, char *basename, int number,
-	float x, float y, qpic_t *pic,
+	float x, float y, qpic_t *pic, char *string,
 	float left, float top, float width, float height,
 	void(*leftkey)(void *nativedata1, void *nativedata2, float data1, float data2),
 	void(*rightkey)(void *nativedata1, void *nativedata2, float data1, float data2),
@@ -43,13 +73,11 @@ void ui_item
 	void(*mouseclick)(void *nativedata1, void *nativedata2, float data1, float data2, float xfrac, float yfrac),
 	void *nativedata1, void *nativedata2, float data1, float data2
 );
+// removes an item from a panel
 void ui_item_remove(ui_t *ui, char *basename, int number);
+// checks if a panel is enabled
 int ui_uiactive(ui_t *ui);
+// enables/disables a panel on the screen
 void ui_activate(ui_t *ui, int yes);
-void ui_leftkeyupdate(int pressed);
-void ui_rightkeyupdate(int pressed);
-void ui_upkeyupdate(int pressed);
-void ui_downkeyupdate(int pressed);
-void ui_mousebuttonupdate(int button, int pressed);
-void ui_update(void);
-void ui_draw(void);
+
+#endif