From 6743cde23dc39204f972af24cde93806630bfaa2 Mon Sep 17 00:00:00 2001
From: Tectu <joel@unormal.org>
Date: Tue, 26 Jun 2012 13:57:00 +0200
Subject: [PATCH] gui doc

---
 gui.h | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/gui.h b/gui.h
index 44c640a6..54031295 100644
--- a/gui.h
+++ b/gui.h
@@ -24,8 +24,37 @@ extern "C" {
 enum {horizontal, vertical};
 enum {inactive, active};
 
+/*
+ * Description: creates the GUI thread
+ *
+ * param:		- interval:	thread sleep in milliseconds after each GUI element update
+ *				- priority: priority of the thread
+ *
+ * return:		pointer to created thread
+ */
 Thread *guiInit(uint16_t interval, tprio_t priority);
+
+/*
+ * Description: prints all GUI elements structs (linked list)
+ * 
+ * param:		- chp: pointer to output stream
+ *
+ * return:		none
+ */
 void guiPrintNode(BaseSequentialStream *chp);
+
+/*
+ * Description: draws a button on the screen and keeps it's state up to date
+ *
+ * param:		- x0, y0, x1, y1:	start and end coordinates of the button's rectangle
+ *				- str:				string that gets drawn into the rectangle - button's lable
+ *				- fontColor:		color of the lable
+ *				- buttonColor:		color of the rectangle
+ *				- active:			pass pointer to variable which holds the state 'active' or 'inactive'
+ *				- state:			pass pointer to variable whcih will keep the state of the button (pressed / unpressed)'
+ *
+ * return:		1 if button successfully created
+ */
 uint8_t guiDrawButton(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, char *str, uint16_t fontColor, uint16_t buttonColor, uint8_t *active, uint8_t *state);
 
 #ifdef __cplusplus