Add a simple GWIN window manager, Change the way GWIN visibility works

8 files changed, 764 insertions, 509 deletions

diff --git a/include/gfx_rules.h b/include/gfx_rules.h
index 4b7e9506..7e14ef9d 100644
--- a/include/gfx_rules.h
+++ b/include/gfx_rules.h
@@ -46,38 +46,50 @@
 			#warning "GWIN: Drawing can occur outside the defined windows as GDISP_NEED_CLIP is FALSE"
 		#endif
 	#endif
-	#if GWIN_NEED_BUTTON
-		#if !GDISP_NEED_TEXT
-			#error "GWIN: GDISP_NEED_TEXT is required if GWIN_NEED_BUTTON is TRUE."
-		#endif
-		#if !GFX_USE_GEVENT
+	#if GWIN_NEED_WINDOWMANAGER
+		#if !GFX_USE_GQUEUE || !GQUEUE_NEED_ASYNC
 			#if GFX_DISPLAY_RULE_WARNINGS
-				#warning "GWIN: GFX_USE_GEVENT is required if GWIN_NEED_BUTTON is TRUE. It has been turned on for you."
+				#warning "GWIN: GFX_USE_GQUEUE and GQUEUE_NEED_ASYNC is required if GWIN_NEED_WINDOWMANAGER is TRUE. It has been turned on for you."
 			#endif
-			#undef GFX_USE_GEVENT
-			#define GFX_USE_GEVENT	TRUE
+			#undef GFX_USE_GQUEUE
+			#undef GQUEUE_NEED_ASYNC
+			#define GFX_USE_GQUEUE		TRUE
+			#define GQUEUE_NEED_ASYNC	TRUE
 		#endif
-		#if !GFX_USE_GINPUT || !(GINPUT_NEED_MOUSE || GINPUT_NEED_TOGGLE)
+	#endif
+	#if GWIN_NEED_CONSOLE
+		#if !GDISP_NEED_TEXT
+			#error "GWIN: GDISP_NEED_TEXT is required if GWIN_NEED_CONSOLE is TRUE."
+		#endif
+	#endif
+	#if GWIN_NEED_GRAPH
+	#endif
+	#if GWIN_NEED_BUTTON || GWIN_NEED_SLIDER || GWIN_NEED_CHECKBOX
+		#if !GWIN_NEED_WIDGET
 			#if GFX_DISPLAY_RULE_WARNINGS
-				#warning "GWIN: You have set GWIN_NEED_BUTTON to TRUE but no supported GINPUT (mouse/toggle) devices have been included"
+				#warning "GWIN: GWIN_NEED_WIDGET is required when a Widget is used. It has been turned on for you."
 			#endif
+			#undef GWIN_NEED_WIDGET
+			#define GWIN_NEED_WIDGET	TRUE
+		#endif
+	#endif
+	#if GWIN_NEED_WIDGET
+		#if !GDISP_NEED_TEXT
+			#error "GWIN: GDISP_NEED_TEXT is required if GWIN_NEED_WIDGET is TRUE."
+		#endif
+		#if !GFX_USE_GINPUT
+			// This test also ensures that GFX_USE_GEVENT is set
+			#error "GWIN: GFX_USE_GINPUT (and one or more input sources) is required if GWIN_NEED_WIDGET is TRUE"
 		#endif
 		#if !GDISP_NEED_MULTITHREAD && !GDISP_NEED_ASYNC
 			#if GFX_DISPLAY_RULE_WARNINGS
-				#warning "GWIN: Either GDISP_NEED_MULTITHREAD or GDISP_NEED_ASYNC is required if GWIN_NEED_BUTTON is TRUE."
+				#warning "GWIN: Either GDISP_NEED_MULTITHREAD or GDISP_NEED_ASYNC is required if GWIN_NEED_WIDGET is TRUE."
 				#warning "GWIN: GDISP_NEED_MULTITHREAD has been turned on for you."
 			#endif
 			#undef GDISP_NEED_MULTITHREAD
 			#define GDISP_NEED_MULTITHREAD	TRUE
 		#endif
 	#endif
-	#if GWIN_NEED_CONSOLE
-		#if !GDISP_NEED_TEXT
-			#error "GWIN: GDISP_NEED_TEXT is required if GWIN_NEED_CONSOLE is TRUE."
-		#endif
-	#endif
-	#if GWIN_NEED_GRAPH
-	#endif
 #endif
 
 #if GFX_USE_GINPUT
diff --git a/include/gwin/button.h b/include/gwin/button.h
index 1b0ff36b..53096ea3 100644
--- a/include/gwin/button.h
+++ b/include/gwin/button.h
@@ -73,10 +73,15 @@ extern "C" {
  * @param[in] width		The width of the window
  * @param[in] height	The height of the window
  *
- * @note				The drawing color gets set to White and the background drawing color to Black.
- * @note				Don't forget to set the font using @p gwinSetFont() or @p gwinSetDefaultFont()
+ * @note				The drawing color and the background color get set to the current defaults. If you haven't called
+ * 						@p gwinSetDefaultColor() or @p gwinSetDefaultBgColor() then these are White and Black respectively.
+ * @note				The font gets set to the current default font. If you haven't called @p gwinSetDefaultFont() then there
+ * 						is no default font and text drawing operations will no nothing.
  * @note				The dimensions and position may be changed to fit on the real screen.
- * @note				The button is not automatically drawn. Call gwinDraw() to draw it.
+ * @note				A button remembers its normal button state. If there is a window manager then it is automatically
+ * 						redrawn if the window is moved or its visibility state is changed.
+ * @note				The button is initially marked as invisible so that more properties can be set before display.
+ * 						Call @p gwinSetVisible() to display it when ready.
  *
  * @api
  */	
diff --git a/include/gwin/class_gwin.h b/include/gwin/class_gwin.h
index b7d8c5a8..5e3cb01f 100644
--- a/include/gwin/class_gwin.h
+++ b/include/gwin/class_gwin.h
@@ -24,55 +24,91 @@
 #if GFX_USE_GWIN || defined(__DOXYGEN__)
 
 /**
- * @brief	The Virtual Method Table for a GWIN window
+ * @brief	The predefined flags for a Window
  * @{
  */
-typedef struct gwinVMT {
-	const char *classname;							// @< The GWIN classname
-	void (*Destroy)(GWindowObject *gh);				// @< The GWIN Destroy function (optional)
-	void (*AfterClear)(GWindowObject *gh);			// @< The GWIN After-Clear function (optional)
-} gwinVMT;
+#define GWIN_FLG_DYNAMIC				0x0001			// @< The GWIN structure is allocated
+#define GWIN_FLG_VISIBLE				0x0002			// @< The window is visible
+#define GWIN_FLG_MINIMIZED				0x0004			// @< The window is minimized
+#define GWIN_FLG_MAXIMIZED				0x0008			// @< The window is maximized
+#define GWIN_FLG_WIDGET					0x0010			// @< This is a widget
+#define GWIN_FLG_ENABLED				0x0020			// @< The widget is enabled
+#define GWIN_FLG_ALLOCTXT				0x0040			// @< The widget text is allocated
+#define GWIN_FLG_MOUSECAPTURE			0x0080			// @< The widget has captured the mouse
+#define GWIN_FIRST_WM_FLAG				0x0100			// @< 4 bits free for the window manager to use
+#define GWIN_FIRST_CONTROL_FLAG			0x1000			// @< 4 bits free for Windows and Widgets to use
 /* @} */
 
 /**
- * @brief	The Virtual Method Table for a widget
- * @note	A widget must have a destroy function. Either use @p _gwidgetDestroy() or use your own function
- * 			which internally calls @p _gwidgetDestroy().
- * @note	If no MouseDown(), MouseUp() or MouseMove() function is provided, the widget will not accept being attached to a mouse input source.
- * @note	If no ToggleOn() or ToggleOff() function is provided, the widget will not accept being attached to a toggle input source.
- * @note	If no DialMove() function is provided, the widget will not accept being attached to a dial input source.
- * @note	AssignToggle() and AssignDial() enable a widget to handle more than one toggle/dial device attached to the widget.
- * 			For example, a slider might accept two toggles, one for slider-down and one for slider-up.
- * 			The function enables the widget to record that a particular device instance performs each particular role.
- * 			(eg toggle0 = slider-down, toggle1 = slider-up).
+ * @brief	The Virtual Method Table for a GWIN window
  * @{
  */
-typedef struct gwidgetVMT {
-	struct gwinVMT			g;														// @< This is still a GWIN
-	void (*DefaultDraw)		(GWidgetObject *gw, void *param);						// @< The default drawing routine (mandatory)
-	void (*MouseDown)		(GWidgetObject *gw, coord_t x, coord_t y);				// @< Process mouse down events (optional)
-	void (*MouseUp)			(GWidgetObject *gw, coord_t x, coord_t y);				// @< Process mouse up events (optional)
-	void (*MouseMove)		(GWidgetObject *gw, coord_t x, coord_t y);				// @< Process mouse move events (optional)
-	void (*ToggleOff)		(GWidgetObject *gw, uint16_t instance);					// @< Process toggle off events (optional)
-	void (*ToggleOn)		(GWidgetObject *gw, uint16_t instance);					// @< Process toggle on events (optional)
-	void (*DialMove)		(GWidgetObject *gw, uint16_t instance, uint16_t value);	// @< Process dial move events (optional)
-	void (*AllEvents)		(GWidgetObject *gw, GEvent *pe);						// @< Process all events (optional)
-	bool_t (*AssignToggle)	(GWidgetObject *gw, uint16_t role, uint16_t instance);	// @< Test the role and save the toggle instance handle (optional)
-	bool_t (*AssignDial)	(GWidgetObject *gw, uint16_t role, uint16_t instance);	// @< Test the role and save the dial instance handle (optional)
-} gwidgetVMT;
+typedef struct gwinVMT {
+	const char *		classname;						// @< The GWIN classname (mandatory)
+	void (*Destroy)		(GWindowObject *gh);			// @< The GWIN destroy function (optional)
+	void (*Redraw)		(GWindowObject *gh);			// @< The GWIN redraw routine (optional)
+	void (*AfterClear)	(GWindowObject *gh);			// @< The GWIN after-clear function (optional)
+} gwinVMT;
 /* @} */
 
-/**
- * @brief	The predefined flags for a GWIN and a Widget
- * @{
- */
-#define GWIN_FLG_DYNAMIC				0x0001			// @< The GWIN structure is allocated
-#define GWIN_FLG_WIDGET					0x0002			// @< This is a widget
-#define GWIN_FLG_ENABLED				0x0002			// @< The widget is enabled
-#define GWIN_FLG_ALLOCTXT				0x0008			// @< The widget text is allocated
-#define GWIN_FLG_MOUSECAPTURE			0x0010			// @< The widget has captured the mouse
-#define GWIN_FIRST_CONTROL_FLAG			0x0100			// @< Free for GWINs and Widgets to use
-/* @} */
+#if GWIN_NEED_WIDGET || defined(__DOXYGEN__)
+	/**
+	 * @brief	The Virtual Method Table for a widget
+	 * @note	A widget must have a destroy function. Either use @p _gwidgetDestroy() or use your own function
+	 * 			which internally calls @p _gwidgetDestroy().
+	 * @note	A widget must have a redraw function. Use @p _gwidgetRedraw().
+	 * @note	If no MouseDown(), MouseUp() or MouseMove() function is provided, the widget will not accept being attached to a mouse input source.
+	 * @note	If no ToggleOn() or ToggleOff() function is provided, the widget will not accept being attached to a toggle input source.
+	 * @note	If no DialMove() function is provided, the widget will not accept being attached to a dial input source.
+	 * @note	AssignToggle() and AssignDial() enable a widget to handle more than one toggle/dial device attached to the widget.
+	 * 			For example, a slider might accept two toggles, one for slider-down and one for slider-up.
+	 * 			The function enables the widget to record that a particular device instance performs each particular role.
+	 * 			(eg toggle0 = slider-down, toggle1 = slider-up).
+	 * @{
+	 */
+	typedef struct gwidgetVMT {
+		struct gwinVMT			g;														// @< This is still a GWIN
+		void (*DefaultDraw)		(GWidgetObject *gw, void *param);						// @< The default drawing routine (mandatory)
+		void (*MouseDown)		(GWidgetObject *gw, coord_t x, coord_t y);				// @< Process mouse down events (optional)
+		void (*MouseUp)			(GWidgetObject *gw, coord_t x, coord_t y);				// @< Process mouse up events (optional)
+		void (*MouseMove)		(GWidgetObject *gw, coord_t x, coord_t y);				// @< Process mouse move events (optional)
+		void (*ToggleOff)		(GWidgetObject *gw, uint16_t instance);					// @< Process toggle off events (optional)
+		void (*ToggleOn)		(GWidgetObject *gw, uint16_t instance);					// @< Process toggle on events (optional)
+		void (*DialMove)		(GWidgetObject *gw, uint16_t instance, uint16_t value);	// @< Process dial move events (optional)
+		void (*AllEvents)		(GWidgetObject *gw, GEvent *pe);						// @< Process all events (optional)
+		bool_t (*AssignToggle)	(GWidgetObject *gw, uint16_t role, uint16_t instance);	// @< Test the role and save the toggle instance handle (optional)
+		bool_t (*AssignDial)	(GWidgetObject *gw, uint16_t role, uint16_t instance);	// @< Test the role and save the dial instance handle (optional)
+	} gwidgetVMT;
+	/* @} */
+#endif
+
+#if GWIN_NEED_WINDOWMANAGER || defined(__DOXYGEN__)
+	// @note	There is only ever one instance of each GWindowManager type
+	typedef struct GWindowManager {
+		const struct gwmVMT	*vmt;
+	} GWindowManager;
+
+	/**
+	 * @brief	The Virtual Method Table for a window manager
+	 * @{
+	 */
+	typedef struct gwmVMT {
+		void (*Init)		(void);									// @< The window manager has just been set as the current window manager
+		void (*DeInit)		(void);									// @< The window manager has just been removed as the current window manager
+		bool_t (*Add)		(GHandle gh, coord_t x, coord_t y, coord_t w, coord_t h);	// @< A window has been added
+		void (*Delete)		(GHandle gh);							// @< A window has been deleted
+		void (*Visible)		(GHandle gh);							// @< A window has changed its visibility state
+		void (*Redim)		(GHandle gh, coord_t x, coord_t y, coord_t w, coord_t h);	// @< A window wants to be moved or resized
+		void (*Raise)		(GHandle gh);							// @< A window wants to be on top
+		void (*MinMax)		(GHandle gh, GWindowMinMax minmax);		// @< A window wants to be minimized/maximised
+	} gwmVMT;
+	/* @} */
+
+	/**
+	 * @brief	The list of all windows in the system
+	 */
+	extern gfxQueueASync	_GWINList;
+#endif
 
 #ifdef __cplusplus
 extern "C" {
@@ -86,32 +122,44 @@ extern "C" {
  * @param[in]	w, h	The width and height of the GWIN window
  * @param[in]	size	The size of the GWIN object to allocate
  * @param[in]	vmt		The virtual method table for the GWIN object
+ * @param[in]	flags	The default flags to use
  *
  * @notapi
  */
-GHandle _gwinInit(GWindowObject *pgw, coord_t x, coord_t y, coord_t w, coord_t h, size_t size, const gwinVMT *vmt);
+GHandle _gwindowInit(GWindowObject *pgw, coord_t x, coord_t y, coord_t w, coord_t h, size_t size, const gwinVMT *vmt, uint16_t flags);
 
-/**
- * @brief	Initialise (and allocate if necessary) the base Widget object
- *
- * @param[in]	pgw		The GWidgetObject structure. If NULL one is allocated from the heap
- * @param[in]	x, y	The top left corner of the Widget relative to the screen
- * @param[in]	w, h	The width and height of the Widget window
- * @param[in]	size	The size of the Widget object to allocate
- * @param[in]	vmt		The virtual method table for the Widget object
- *
- * @notapi
- */
-GHandle _gwidgetInit(GWidgetObject *pgw, coord_t x, coord_t y, coord_t w, coord_t h, size_t size, const gwidgetVMT *vmt);
+#if GWIN_NEED_WIDGET || defined(__DOXYGEN__)
+	/**
+	 * @brief	Initialise (and allocate if necessary) the base Widget object
+	 *
+	 * @param[in]	pgw		The GWidgetObject structure. If NULL one is allocated from the heap
+	 * @param[in]	x, y	The top left corner of the Widget relative to the screen
+	 * @param[in]	w, h	The width and height of the Widget window
+	 * @param[in]	size	The size of the Widget object to allocate
+	 * @param[in]	vmt		The virtual method table for the Widget object
+	 *
+	 * @notapi
+	 */
+	GHandle _gwidgetInit(GWidgetObject *pgw, coord_t x, coord_t y, coord_t w, coord_t h, size_t size, const gwidgetVMT *vmt);
 
-/**
- * @brief	Destroy the Widget object
- *
- * @param[in]	gw		The widget to destroy
- *
- * @notapi
- */
-void _gwidgetDestroy(GHandle gh);
+	/**
+	 * @brief	Destroy the Widget object
+	 *
+	 * @param[in]	gh		The widget to destroy
+	 *
+	 * @notapi
+	 */
+	void _gwidgetDestroy(GHandle gh);
+
+	/**
+	 * @brief	Redraw the Widget object
+	 *
+	 * @param[in]	gh		The widget to redraw
+	 *
+	 * @notapi
+	 */
+	void _gwidgetRedraw(GHandle gh);
+#endif
 
 #ifdef __cplusplus
 }
diff --git a/include/gwin/console.h b/include/gwin/console.h
index 0496c620..349efeb8 100644
--- a/include/gwin/console.h
+++ b/include/gwin/console.h
@@ -55,11 +55,15 @@ extern "C" {
  * @param[in] width		The width of the window
  * @param[in] height	The height of the window
  *
- * @note				The console is not automatically cleared on creation. You must do that by calling gwinClear() (possibly after changing your background color)
- * @note				Don't forget to set the font using @p gwinSetFont() or @p gwinSetDefaultFont()
- * @note				If the dispay does not support scrolling, the window will be cleared when the bottom line is reached.
- * @note				The default drawing color gets set to White and the background drawing color to Black.
+ * @note				The drawing color and the background color get set to the current defaults. If you haven't called
+ * 						@p gwinSetDefaultColor() or @p gwinSetDefaultBgColor() then these are White and Black respectively.
+ * @note				The font gets set to the current default font. If you haven't called @p gwinSetDefaultFont() then there
+ * 						is no default font and text drawing operations will no nothing.
  * @note				The dimensions and position may be changed to fit on the real screen.
+ * @note				On creation the window is marked as visible but is not automatically cleared. You may do that by calling @p gwinClear()
+ * 						(possibly after changing your background color)
+ * @note				A console does not save the drawing state. It is not automatically redrawn if the window is moved or
+ * 						its visibility state is changed.
  *
  * @api
  */
diff --git a/include/gwin/graph.h b/include/gwin/graph.h
index 3c4c42a9..f1ea9450 100644
--- a/include/gwin/graph.h
+++ b/include/gwin/graph.h
@@ -95,8 +95,15 @@ extern "C" {
  * @param[in] width		The width of the window
  * @param[in] height	The height of the window
  *
- * @note				The console is not automatically cleared on creation. You must do that by calling gwinClear() (possibly after changing your background color)
- * @note				Don't forget to set the font using @p gwinSetFont() or @p gwinSetDefaultFont()
+ * @note				The drawing color and the background color get set to the current defaults. If you haven't called
+ * 						@p gwinSetDefaultColor() or @p gwinSetDefaultBgColor() then these are White and Black respectively.
+ * @note				The font gets set to the current default font. If you haven't called @p gwinSetDefaultFont() then there
+ * 						is no default font and text drawing operations will no nothing.
+ * @note				The dimensions and position may be changed to fit on the real screen.
+ * @note				On creation the window is marked as visible but is not automatically cleared. You may do that by calling @p gwinClear()
+ * 						(possibly after changing your background color)
+ * @note				A graph does not save the drawing state. It is not automatically redrawn if the window is moved or
+ * 						its visibility state is changed.
  * @note				The coordinate system within the window for graphing operations (but not for any other drawing
  * 						operation) is relative to the bottom left corner and then shifted right and up by the specified
  * 						graphing x and y origin. Note that this system is inverted in the y direction relative to the display.
diff --git a/include/gwin/gwidget.h b/include/gwin/gwidget.h
index 40124a43..21cfd4ac 100644
--- a/include/gwin/gwidget.h
+++ b/include/gwin/gwidget.h
@@ -74,7 +74,7 @@ extern "C" {
  * @param[in] gh		The widget handle
  * @param[in] enabled	Enable or disable the widget
  *
- * @note				The widget is not automatically redrawn. Call @p gwinDraw() to redraw the widget.
+ * @note				The widget is automatically redrawn.
  * @note				Non-widgets will ignore this call.
  *
  * @api
@@ -82,48 +82,13 @@ extern "C" {
 void gwinSetEnabled(GHandle gh, bool_t enabled);
 
 /**
- * @brief	Enable a widget
- *
- * @param[in] gh		The widget handle
- *
- * @note				The widget is not automatically redrawn. Call @p gwinDraw() to redraw the widget.
- * @note				Non-widgets will ignore this call.
- *
- * @api
- */
-#define gwinEnable(gh)				gwinSetEnabled(gh, TRUE)
-
-/**
- * @brief	Disable a widget
- *
- * @param[in] gh		The widget handle
- *
- * @note				The widget is not automatically redrawn. Call @p gwinDraw() to redraw the widget.
- * @note				Non-widgets will ignore this call.
- *
- * @api
- */
-#define gwinDisable(gh)				gwinSetEnabled(gh, FALSE)
-
-/**
- * @brief   Redraw the widget
- *
- * @param[in] gh		The widget handle
- *
- * @note				Non-widgets will ignore this call.
- *
- * @api
- */
-void gwinDraw(GHandle gh);
-
-/**
  * @brief   Set the text of a widget.
  *
  * @param[in] gh		The widget handle
  * @param[in] txt		The text to set. This must be a constant string unless useAlloc is set.
  * @param[in] useAlloc	If TRUE the string specified will be copied into dynamically allocated memory.
  *
- * @note				The widget is not automatically redrawn. Call @p gwinDraw() to redraw the widget.
+ * @note				The widget is automatically redrawn
  * @note				Non-widgets will ignore this call.
  *
  * @api
diff --git a/include/gwin/gwin.h b/include/gwin/gwin.h
index 7a6aba09..d915a4f0 100644
--- a/include/gwin/gwin.h
+++ b/include/gwin/gwin.h
@@ -30,521 +30,713 @@
 
 /**
  * @brief	A window object structure
- * @note	Do you access the members directly. Treat it as a black-box and use the method functions.
- *
+ * @note	Do not access the members directly. Treat it as a black-box and use the method functions.
  * @{
  */
 typedef struct GWindowObject {
-	const struct gwinVMT	*vmt;	// @< The VMT for this GWIN
-	coord_t		x, y;				// @< Screen relative position
-	coord_t		width, height;		// @< Dimensions of this window
-	color_t		color, bgcolor;		// @< Current drawing colors
-	uint16_t	flags;				// @< Window flags (the meaning is private to the GWIN class)
-#if GDISP_NEED_TEXT
-	font_t		font;				// @< Current font
-#endif
+	#if GWIN_NEED_WINDOWMANAGER
+		gfxQueueASyncItem	wmq;				// @< The next window (for the window manager)
+	#endif
+	const struct gwinVMT	*vmt;				// @< The VMT for this GWIN
+	coord_t					x, y;				// @< Screen relative position
+	coord_t					width, height;		// @< Dimensions of this window
+	color_t					color, bgcolor;		// @< The current drawing colors
+	uint16_t				flags;				// @< Window flags (the meaning is private to the GWIN class)
+	#if GDISP_NEED_TEXT
+		font_t				font;				// @< The current font
+	#endif
 } GWindowObject, * GHandle;
 /* @} */
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* Base Functions */
-
 /**
- * @brief   Create a basic window.
- * @return  NULL if there is no resultant drawing area, otherwise a window handle.
- *
- * @param[in] pgw		The window structure to initialize. If this is NULL the structure is dynamically allocated.
- * @param[in] x,y		The screen coordinates for the top left corner of the window
- * @param[in] width		The width of the window
- * @param[in] height	The height of the window
- *
- * @note				The default drawing color gets set to White and the background drawing color to Black.
- * @note				No default font is set so make sure to set one before drawing any text.
- * @note				The dimensions and position may be changed to fit on the real screen.
- * @note				The window is not automatically cleared on creation. You must do that by calling @p gwinClear()
- * 						(possibly after changing your background color)
- *
- * @api
- */
-GHandle gwinCreateWindow(GWindowObject *pgw, coord_t x, coord_t y, coord_t width, coord_t height);
-
-/**
- * @brief   Destroy a window (of any type). Releases any dynamically allocated memory.
- *
- * @param[in] gh		The window handle
- *
- * @api
- */
-void gwinDestroy(GHandle gh);
-
-/**
- * @brief	Get the real class name of the GHandle
- * @details	Returns a string describing the object class.
- *
- * @param[in] gh	The window
- */
-const char *gwinGetClassName(GHandle gh);
-
-/**
- * @brief	Get an ID that uniquely describes the class of the GHandle
- *
- * @param[in] gh	The window
+ * @brief	A window's minimized, maximized or normal size
  */
-#define gwinGetClassID(gh)		((void *)((gh)->vmt))
+typedef enum { GWIN_NORMAL, GWIN_MAXIMIZE, GWIN_MINIMIZE } GWindowMinMax;
 
-/**
- * @brief	Get the X coordinate of the window
- * @details	Returns the X coordinate of the origin of the window.
- *			The coordinate is relative to the physical screen zero point.
- *
- * @param[in] gh	The window
- */
-#define gwinGetScreenX(gh)			((gh)->x)
-
-/**
- * @brief	Get the Y coordinate of the window
- * @details	Returns the Y coordinate of the origin of the window.
- *			The coordinate is relative to the physical screen zero point.
- *
- * @param[in] gh	The window
- */
-#define gwinGetScreenY(gh)			((gh)->y)
-
-/**
- * @brief	Get the width of the window
- *
- * @param[in] gh	The window
- */
-#define gwinGetWidth(gh)			((gh)->width)
-
-/**
- * @brief	Get the height of the window
- *
- * @param[in] gh	The window
- */
-#define gwinGetHeight(gh)			((gh)->height)
-
-/**
- * @brief	Set the default foreground color for all new GWIN windows
- *
- * @param[in] gh	The window
- * @param[in] clr	The color to be set
- */
-void gwinSetDefaultColor(color_t clr);
+#ifdef __cplusplus
+extern "C" {
+#endif
 
-/**
- * @brief	Set the default background color for all new GWIN windows
- *
- * @param[in] gh	The window
- * @param[in] bgclr	The background color
- */
-void gwinSetDefaultBgColor(color_t bgclr);
+/*-------------------------------------------------
+ * Window Manager functions
+ *-------------------------------------------------*/
 
-/**
- * @brief	Set foreground color
- * @details Set the color which will be used to draw
- *
- * @param[in] gh	The window
- * @param[in] clr	The color to be set
- */
-#define gwinSetColor(gh, clr)		(gh)->color = (clr)
+#if GWIN_NEED_WINDOWMANAGER
+	// Forward definition
+	struct GWindowManager;
 
-/**
- * @brief	Set background color
- * @details	Set the color which will be used as background
- * @note	gwinClear() must be called to set the background color
- *
- * @param[in] gh	The window
- * @param[in] bgclr	The background color
- */
-#define gwinSetBgColor(gh, bgclr)	(gh)->bgcolor = (bgclr)
+	/**
+	 * @brief   Set the window manager for the GWIN system.
+	 *
+	 * @param[in] gwm		The window manager to use. Can be NULL to turn off the existing window manager.
+	 *
+	 * @note				A window manager is responsible for handling when window visibility is changed or
+	 * 						a window is resized for moved. Note that only saved window states will be redrawn. Each
+	 * 						window type can save different information (or none at all). See the documentation on each window
+	 * 						type to see which information it saves (and can therefore be automatically redrawn).
+	 * 						For window types that do not save any state information, the window manager determines what to do.
+	 * 						Generally it will just clear the window to its background color.
+	 *
+	 * @api
+	 */
+	void gwinSetWindowManager(struct GWindowManager *gwm);
+#endif
 
-/* Set up for text */
+/*-------------------------------------------------
+ * Functions that affect all windows
+ *-------------------------------------------------*/
 
-#if GDISP_NEED_TEXT || defined(__DOXYGEN__)
 	/**
-	 * @brief	Set the default font for all new GWIN windows
+	 * @brief	Set the default foreground color for all new GWIN windows
 	 *
 	 * @param[in] gh	The window
+	 * @param[in] clr	The color to be set
+	 *
+	 * @api
 	 */
-	void gwinSetDefaultFont(font_t font);
+	void gwinSetDefaultColor(color_t clr);
 
 	/**
-	 * @brief   Set the current font for this window.
+	 * @brief	Set the default background color for all new GWIN windows
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] font		The font to use for text functions
+	 * @param[in] gh	The window
+	 * @param[in] bgclr	The background color
 	 *
 	 * @api
 	 */
-	void gwinSetFont(GHandle gh, font_t font);
-#endif
+	void gwinSetDefaultBgColor(color_t bgclr);
 
-/* Drawing Functions */
+	#if GDISP_NEED_TEXT || defined(__DOXYGEN__)
+		/**
+		 * @brief	Set the default font for all new GWIN windows
+		 *
+		 * @param[in] gh	The window
+		 *
+		 * @api
+		 */
+		void gwinSetDefaultFont(font_t font);
+	#endif
 
-/**
- * @brief   Clear the window
- * @note	Uses the current background color to clear the window
- *
- * @param[in] gh		The window handle
- *
- * @api
- */
-void gwinClear(GHandle gh);
-
-/**
- * @brief   Set a pixel in the window
- * @note	Uses the current foreground color to set the pixel
- * @note	May leave GDISP clipping to this window's dimensions
- *
- * @param[in] gh		The window handle
- * @param[in] x,y		The coordinates of the pixel
- *
- * @api
- */
-void gwinDrawPixel(GHandle gh, coord_t x, coord_t y);
-
-/**
- * @brief   Draw a line in the window
- * @note	Uses the current foreground color to draw the line
- * @note	May leave GDISP clipping to this window's dimensions
- *
- * @param[in] gh		The window handle
- * @param[in] x0,y0		The start position
- * @param[in] x1,y1 	The end position
- *
- * @api
- */
-void gwinDrawLine(GHandle gh, coord_t x0, coord_t y0, coord_t x1, coord_t y1);
 
-/**
- * @brief   Draw a box in the window
- * @note	Uses the current foreground color to draw the box
- * @note	May leave GDISP clipping to this window's dimensions
- *
- * @param[in] gh		The window handle
- * @param[in] x,y		The start position
- * @param[in] cx,cy		The size of the box (outside dimensions)
- *
- * @api
- */
-void gwinDrawBox(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy);
+/*-------------------------------------------------
+ * Base functions
+ *-------------------------------------------------*/
 
-/**
- * @brief   Fill an rectangular area in the window
- * @note	Uses the current foreground color to fill the box
- * @note	May leave GDISP clipping to this window's dimensions
- *
- * @param[in] gh		The window handle
- * @param[in] x,y		The start position
- * @param[in] cx,cy		The size of the box (outside dimensions)
- *
- * @api
- */
-void gwinFillArea(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy);
+	/**
+	 * @brief   Create a basic window.
+	 * @return  NULL if there is no resultant drawing area, otherwise a window handle.
+	 *
+	 * @param[in] pgw		The window structure to initialize. If this is NULL the structure is dynamically allocated.
+	 * @param[in] x,y		The screen coordinates for the top left corner of the window
+	 * @param[in] width		The width of the window
+	 * @param[in] height	The height of the window
+	 *
+	 * @note				The drawing color and the background color get set to the current defaults. If you haven't called
+	 * 						@p gwinSetDefaultColor() or @p gwinSetDefaultBgColor() then these are White and Black respectively.
+	 * @note				The font gets set to the current default font. If you haven't called @p gwinSetDefaultFont() then there
+	 * 						is no default font and text drawing operations will no nothing.
+	 * @note				The dimensions and position may be changed to fit on the real screen.
+	 * @note				On creation the window is marked as visible.
+	 * @note				A basic window does not save the drawing state. It is not automatically redrawn if the window is moved or
+	 * 						its visibility state is changed.
+	 *
+	 * @api
+	 */
+	GHandle gwinCreateWindow(GWindowObject *pgw, coord_t x, coord_t y, coord_t width, coord_t height);
 
-/**
- * @brief   Fill an area in the window using the supplied bitmap.
- * @details The bitmap is in the pixel format specified by the low level driver
- * @note	If GDISP_NEED_ASYNC is defined then the buffer must be static
- * 			or at least retained until this call has finished the blit. You can
- * 			tell when all graphics drawing is finished by @p gdispIsBusy() going FALSE.
- * @note	May leave GDISP clipping to this window's dimensions
- *
- * @param[in] gh		The window handle
- * @param[in] x, y		The start filled area
- * @param[in] cx, cy	The width and height to be filled
- * @param[in] srcx, srcy	The bitmap position to start the fill from
- * @param[in] srccx		The width of a line in the bitmap.
- * @param[in] buffer	The pixels to use to fill the area.
- *
- * @api
- */
-void gwinBlitArea(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy, coord_t srcx, coord_t srcy, coord_t srccx, const pixel_t *buffer);
+	/**
+	 * @brief   Destroy a window (of any type). Releases any dynamically allocated memory.
+	 *
+	 * @param[in] gh		The window handle
+	 *
+	 * @api
+	 */
+	void gwinDestroy(GHandle gh);
 
-/* Circle Functions */
+	/**
+	 * @brief	Get the real class name of the GHandle
+	 * @details	Returns a string describing the object class.
+	 *
+	 * @param[in] gh	The window
+	 *
+	 * @api
+	 */
+	const char *gwinGetClassName(GHandle gh);
 
-#if GDISP_NEED_CIRCLE || defined(__DOXYGEN__)
 	/**
-	 * @brief   Draw a circle in the window.
-	 * @note	Uses the current foreground color to draw the circle
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief	Get an ID that uniquely describes the class of the GHandle
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x, y		The center of the circle
-	 * @param[in] radius	The radius of the circle
+	 * @param[in] gh	The window
 	 *
 	 * @api
 	 */
-	void gwinDrawCircle(GHandle gh, coord_t x, coord_t y, coord_t radius);
+	#define gwinGetClassID(gh)		((void *)((gh)->vmt))
 
 	/**
-	 * @brief   Draw a filled circle in the window.
-	 * @note	Uses the current foreground color to draw the filled circle
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief	Get the X coordinate of the window
+	 * @details	Returns the X coordinate of the origin of the window.
+	 *			The coordinate is relative to the physical screen zero point.
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x, y		The center of the circle
-	 * @param[in] radius	The radius of the circle
+	 * @param[in] gh	The window
 	 *
 	 * @api
 	 */
-	void gwinFillCircle(GHandle gh, coord_t x, coord_t y, coord_t radius);
-#endif
+	#define gwinGetScreenX(gh)			((gh)->x)
 
-/* Ellipse Functions */
+	/**
+	 * @brief	Get the Y coordinate of the window
+	 * @details	Returns the Y coordinate of the origin of the window.
+	 *			The coordinate is relative to the physical screen zero point.
+	 *
+	 * @param[in] gh	The window
+	 *
+	 * @api
+	 */
+	#define gwinGetScreenY(gh)			((gh)->y)
 
-#if GDISP_NEED_ELLIPSE || defined(__DOXYGEN__)
 	/**
-	 * @brief   Draw an ellipse.
-	 * @note	Uses the current foreground color to draw the ellipse
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief	Get the width of the window
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The center of the ellipse
-	 * @param[in] a,b		The dimensions of the ellipse
+	 * @param[in] gh	The window
 	 *
 	 * @api
 	 */
-	void gwinDrawEllipse(GHandle gh, coord_t x, coord_t y, coord_t a, coord_t b);
+	#define gwinGetWidth(gh)			((gh)->width)
 
 	/**
-	 * @brief   Draw an filled ellipse.
-	 * @note	Uses the current foreground color to draw the filled ellipse
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief	Get the height of the window
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The center of the ellipse
-	 * @param[in] a,b		The dimensions of the ellipse
+	 * @param[in] gh	The window
 	 *
 	 * @api
 	 */
-	void gwinFillEllipse(GHandle gh, coord_t x, coord_t y, coord_t a, coord_t b);
-#endif
+	#define gwinGetHeight(gh)			((gh)->height)
 
-/* Arc Functions */
+	/**
+	 * @brief	Set foreground color
+	 * @details Set the color which will be used to draw
+	 *
+	 * @param[in] gh	The window
+	 * @param[in] clr	The color to be set
+	 *
+	 * @api
+	 */
+	#define gwinSetColor(gh, clr)		(gh)->color = (clr)
 
-#if GDISP_NEED_ARC || defined(__DOXYGEN__)
-	/*
-	 * @brief	Draw an arc in the window.
-	 * @note	Uses the current foreground color to draw the arc
-	 * @note	May leave GDISP clipping to this window's dimensions
+	/**
+	 * @brief	Set background color
+	 * @details	Set the color which will be used as background
+	 * @note	gwinClear() must be called to set the background color
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The center point
-	 * @param[in] radius	The radius of the arc
-	 * @param[in] start		The start angle (0 to 360)
-	 * @param[in] end		The end angle (0 to 360)
+	 * @param[in] gh	The window
+	 * @param[in] bgclr	The background color
 	 *
 	 * @api
 	 */
-	void gwinDrawArc(GHandle gh, coord_t x, coord_t y, coord_t radius, coord_t startangle, coord_t endangle);
+	#define gwinSetBgColor(gh, bgclr)	(gh)->bgcolor = (bgclr)
 
-	/*
-	 * @brief	Draw a filled arc in the window.
-	 * @note	Uses the current foreground color to draw the filled arc
-	 * @note	May leave GDISP clipping to this window's dimensions
+	/**
+	 * @brief	Sets whether a window is visible or not
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The center point
-	 * @param[in] radius	The radius of the arc
-	 * @param[in] start		The start angle (0 to 360)
-	 * @param[in] end		The end angle (0 to 360)
+	 * @param[in] gh		The window
+	 * @param[in] visible	Whether the window should be visible or not
+	 *
+	 * @note	When a window is marked as not visible, drawing operations
+	 * 			on the window do nothing.
+	 * @note	When a window is marked as visible, it is not automatically
+	 * 			redrawn as many window types don't remember their drawing state.
+	 * 			Widgets such as Buttons, Sliders etc will be redrawn.
+	 * @note	If there is no window manager in use, when a window is marked
+	 * 			as not visible, nothing is done to remove the window from the screen.
+	 * 			When there is a window manager, it is up to the window manager to
+	 * 			handle what happens.
 	 *
 	 * @api
 	 */
-	void gwinFillArc(GHandle gh, coord_t x, coord_t y, coord_t radius, coord_t startangle, coord_t endangle);
-#endif
+	void gwinSetVisible(GHandle gh, bool_t visible);
 
-/* Read a pixel Function */
+	/**
+	 * @brief	Gets the visibility of a window
+	 * @return	TRUE if visible
+	 *
+	 * @param[in] gh		The window
+	 *
+	 * @api
+	 */
+	bool_t gwinGetVisible(GHandle gh);
 
-#if GDISP_NEED_PIXELREAD || defined(__DOXYGEN__)
 	/**
-	 * @brief   Get the color of a pixel in the window.
-	 * @return  The color of the pixel.
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief	Move a window
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The position in the window
+	 * @param[in] gh		The window
+	 * @param[in] x, y		The new position (screen relative) for this window
+	 *
+	 * @note	The final window position may not be the requested position. Windows
+	 * 			are clipped to the screen area and the window manager may also affect the position.
+	 * @note	The window is redrawn if it is visible. See the comments in @p gwinSetVisible()
+	 * 			with regard to what can be redrawn and what can't.
+	 * @note	It is up to the window manager to determine what happens with the screen area
+	 * 			uncovered by moving the window. When there is no window manager, nothing
+	 * 			is done with the uncovered area.
 	 *
 	 * @api
 	 */
-	color_t gwinGetPixelColor(GHandle gh, coord_t x, coord_t y);
-#endif
+	void gwinMove(GHandle gh, coord_t x, coord_t y);
 
-/* Extra Text Functions */
+	/**
+	 * @brief	Resize a window
+	 *
+	 * @param[in] gh				The window
+	 * @param[in] width, height		The new size of the window
+	 *
+	 * @note	The final window size may not be the requested size. Windows
+	 * 			are clipped to the screen area and the window manager may also affect the size.
+	 * @note	The window is redrawn if it is visible. See the comments in @p gwinSetVisible()
+	 * 			with regard to what can be redrawn and what can't.
+	 * @note	It is up to the window manager to determine what happens with any screen area
+	 * 			uncovered by resizing the window. When there is no window manager, nothing
+	 * 			is done with the uncovered area.
+	 *
+	 * @api
+	 */
+	void gwinResize(GHandle gh, coord_t width, coord_t height);
 
-#if GDISP_NEED_TEXT || defined(__DOXYGEN__)
 	/**
-	 * @brief   Draw a text character at the specified position in the window.
-	 * @pre		The font must have been set.
-	 * @note	Uses the current foreground color to draw the character
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief	Minimize, Maximize or Restore a window
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The position for the text
-	 * @param[in] c			The character to draw
+	 * @param[in] gh				The window
+	 * @param[in] minmax			The new minimized/maximized state
+	 *
+	 * @note	The final window state may not be the requested state. Window Managers
+	 * 			do not need to implement changing the minmax state. If there is no
+	 * 			window manager this call is ignored.
+	 * @note	The window is redrawn if it is changed. See the comments in @p gwinSetVisible()
+	 * 			with regard to what can be redrawn and what can't.
+	 * @note	It is up to the window manager to determine what happens with any screen area
+	 * 			uncovered by resizing the window.
+	 * @note	When a window is minimised it may be asked to draw the window or the window
+	 * 			manager may draw the minimised window.
 	 *
 	 * @api
 	 */
-	void gwinDrawChar(GHandle gh, coord_t x, coord_t y, char c);
+	void gwinSetMinMax(GHandle gh, GWindowMinMax minmax);
 
 	/**
-	 * @brief   Draw a text character with a filled background at the specified position in the window.
-	 * @pre		The font must have been set.
-	 * @note	Uses the current foreground color to draw the character and fills the background using the background drawing color
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief	Get the Minimized/Maximized state of a window
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The position for the text
-	 * @param[in] c			The character to draw
+	 * @param[in] gh				The window
 	 *
 	 * @api
 	 */
-	void gwinFillChar(GHandle gh, coord_t x, coord_t y, char c);
+	GWindowMinMax gwinGetMinMax(GHandle gh);
 
 	/**
-	 * @brief   Draw a text string in the window
-	 * @pre		The font must have been set.
-	 * @note	Uses the current foreground color to draw the character
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief	Raise a window to the top of the z-order
 	 *
-	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The position for the text
-	 * @param[in] str		The string to draw
+	 * @param[in] gh				The window
+	 *
+	 * @note	The window z-order is only supported by some window managers. If there is no
+	 * 			window manager this call simple tries to redraw the window. See the comments
+	 * 			in @p gwinSetVisible() with regard to what can be redrawn and what can't.
 	 *
 	 * @api
 	 */
-	void gwinDrawString(GHandle gh, coord_t x, coord_t y, const char *str);
+	void gwinRaise(GHandle gh);
+
+	#if GDISP_NEED_TEXT || defined(__DOXYGEN__)
+		/**
+		 * @brief   Set the current font for this window.
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] font		The font to use for text functions
+		 *
+		 * @api
+		 */
+		void gwinSetFont(GHandle gh, font_t font);
+	#endif
+
+/*-------------------------------------------------
+ * Drawing functions
+ *-------------------------------------------------*/
 
 	/**
-	 * @brief   Draw a text string with a filled background in the window
-	 * @pre		The font must have been set.
-	 * @note	Uses the current foreground color to draw the character and fills the background using the background drawing color
-	 * @note	May leave GDISP clipping to this window's dimensions
+	 * @brief   Clear the window
+	 * @note	Uses the current background color to clear the window
 	 *
 	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The position for the text
-	 * @param[in] str		The string to draw
 	 *
 	 * @api
 	 */
-	void gwinFillString(GHandle gh, coord_t x, coord_t y, const char *str);
+	void gwinClear(GHandle gh);
 
 	/**
-	 * @brief   Draw a text string verticly centered within the specified box.
-	 * @pre		The font must have been set.
-	 * @note	Uses the current foreground color to draw the character.
-	 * @note    The specified box does not need to align with the window box
+	 * @brief   Set a pixel in the window
+	 * @note	Uses the current foreground color to set the pixel
 	 * @note	May leave GDISP clipping to this window's dimensions
 	 *
 	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The position for the text (need to define top-right or base-line - check code)
-	 * @param[in] cx,cy		The width and height of the box
-	 * @param[in] str		The string to draw
-	 * @param[in] justify	Justify the text left, center or right within the box
+	 * @param[in] x,y		The coordinates of the pixel
 	 *
 	 * @api
 	 */
-	void gwinDrawStringBox(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy, const char* str, justify_t justify);
+	void gwinDrawPixel(GHandle gh, coord_t x, coord_t y);
 
 	/**
-	 * @brief   Draw a text string verticly centered within the specified filled box.
-	 * @pre		The font must have been set.
-	 * @note	Uses the current foreground color to draw the character and fills the background using the background drawing color
-	 * @note    The entire box is filled. Note this box does not need to align with the window box
+	 * @brief   Draw a line in the window
+	 * @note	Uses the current foreground color to draw the line
 	 * @note	May leave GDISP clipping to this window's dimensions
 	 *
 	 * @param[in] gh		The window handle
-	 * @param[in] x,y		The position for the text (need to define top-right or base-line - check code)
-	 * @param[in] cx,cy		The width and height of the box
-	 * @param[in] str		The string to draw
-	 * @param[in] justify	Justify the text left, center or right within the box
+	 * @param[in] x0,y0		The start position
+	 * @param[in] x1,y1 	The end position
 	 *
 	 * @api
 	 */
-	void gwinFillStringBox(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy, const char* str, justify_t justify);
-#endif
+	void gwinDrawLine(GHandle gh, coord_t x0, coord_t y0, coord_t x1, coord_t y1);
 
-#if GDISP_NEED_CONVEX_POLYGON || defined(__DOXYGEN__)
 	/**
-	 * @brief   Draw an enclosed polygon (convex, non-convex or complex).
-	 *
-	 * @note	Uses the current foreground color.
+	 * @brief   Draw a box in the window
+	 * @note	Uses the current foreground color to draw the box
+	 * @note	May leave GDISP clipping to this window's dimensions
 	 *
 	 * @param[in] gh		The window handle
-	 * @param[in] tx, ty	Transform all points in pntarray by tx, ty
-	 * @param[in] pntarray	An array of points
-	 * @param[in] cnt		The number of points in the array
+	 * @param[in] x,y		The start position
+	 * @param[in] cx,cy		The size of the box (outside dimensions)
 	 *
 	 * @api
 	 */
-	void gwinDrawPoly(GHandle gh, coord_t tx, coord_t ty, const point *pntarray, unsigned cnt);
+	void gwinDrawBox(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy);
 
 	/**
-	 * @brief   Fill a convex polygon
-	 * @details Doesn't handle non-convex or complex polygons.
-	 *
-	 * @note	Uses the current foreground color.
+	 * @brief   Fill an rectangular area in the window
+	 * @note	Uses the current foreground color to fill the box
+	 * @note	May leave GDISP clipping to this window's dimensions
 	 *
 	 * @param[in] gh		The window handle
-	 * @param[in] tx, ty	Transform all points in pntarray by tx, ty
-	 * @param[in] pntarray	An array of points
-	 * @param[in] cnt		The number of points in the array
-	 *
-	 * @note	Convex polygons are those that have no internal angles. That is;
-	 * 			you can draw a line from any point on the polygon to any other point
-	 * 			on the polygon without it going outside the polygon. In our case we generalise
-	 * 			this a little by saying that an infinite horizontal line (at any y value) will cross
-	 * 			no more than two edges on the polygon. Some non-convex polygons do fit this criteria
-	 * 			and can therefore be drawn.
-	 * @note	This routine is designed to be very efficient with even simple display hardware.
+	 * @param[in] x,y		The start position
+	 * @param[in] cx,cy		The size of the box (outside dimensions)
 	 *
 	 * @api
 	 */
-	void gwinFillConvexPoly(GHandle gh, coord_t tx, coord_t ty, const point *pntarray, unsigned cnt);
-#endif
+	void gwinFillArea(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy);
 
-#if GDISP_NEED_IMAGE || defined(__DOXYGEN__)
 	/**
-	 * @brief	Draw the image
-	 * @return	GDISP_IMAGE_ERR_OK (0) on success or an error code.
+	 * @brief   Fill an area in the window using the supplied bitmap.
+	 * @details The bitmap is in the pixel format specified by the low level driver
+	 * @note	If GDISP_NEED_ASYNC is defined then the buffer must be static
+	 * 			or at least retained until this call has finished the blit. You can
+	 * 			tell when all graphics drawing is finished by @p gdispIsBusy() going FALSE.
+	 * @note	May leave GDISP clipping to this window's dimensions
 	 *
 	 * @param[in] gh		The window handle
-	 * @param[in] img   	The image structure
-	 * @param[in] x,y		The window location to draw the image
-	 * @param[in] cx,cy		The area on the screen to draw
-	 * @param[in] sx,sy		The image position to start drawing at
-	 *
-	 * @pre		gdispImageOpen() must have returned successfully.
-	 *
-	 * @note	If sx,sy + cx,cy is outside the image boundaries the area outside the image
-	 * 			is simply not drawn.
-	 * @note	If @p gdispImageCache() has been called first for this frame, this routine will draw using a
-	 * 			fast blit from the cached frame. If not, it reads the input and decodes it as it
-	 * 			is drawing. This may be significantly slower than if the image has been cached (but
-	 * 			uses a lot less RAM)
+	 * @param[in] x, y		The start filled area
+	 * @param[in] cx, cy	The width and height to be filled
+	 * @param[in] srcx, srcy	The bitmap position to start the fill from
+	 * @param[in] srccx		The width of a line in the bitmap.
+	 * @param[in] buffer	The pixels to use to fill the area.
+	 *
+	 * @api
 	 */
-	gdispImageError gwinImageDraw(GHandle gh, gdispImage *img, coord_t x, coord_t y, coord_t cx, coord_t cy, coord_t sx, coord_t sy);
-#endif
+	void gwinBlitArea(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy, coord_t srcx, coord_t srcy, coord_t srccx, const pixel_t *buffer);
+
+/*-------------------------------------------------
+ * Circle, ellipse and arc functions
+ *-------------------------------------------------*/
+
+	#if GDISP_NEED_CIRCLE || defined(__DOXYGEN__)
+		/**
+		 * @brief   Draw a circle in the window.
+		 * @note	Uses the current foreground color to draw the circle
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x, y		The center of the circle
+		 * @param[in] radius	The radius of the circle
+		 *
+		 * @api
+		 */
+		void gwinDrawCircle(GHandle gh, coord_t x, coord_t y, coord_t radius);
+
+		/**
+		 * @brief   Draw a filled circle in the window.
+		 * @note	Uses the current foreground color to draw the filled circle
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x, y		The center of the circle
+		 * @param[in] radius	The radius of the circle
+		 *
+		 * @api
+		 */
+		void gwinFillCircle(GHandle gh, coord_t x, coord_t y, coord_t radius);
+	#endif
+
+	#if GDISP_NEED_ELLIPSE || defined(__DOXYGEN__)
+		/**
+		 * @brief   Draw an ellipse.
+		 * @note	Uses the current foreground color to draw the ellipse
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The center of the ellipse
+		 * @param[in] a,b		The dimensions of the ellipse
+		 *
+		 * @api
+		 */
+		void gwinDrawEllipse(GHandle gh, coord_t x, coord_t y, coord_t a, coord_t b);
+
+		/**
+		 * @brief   Draw an filled ellipse.
+		 * @note	Uses the current foreground color to draw the filled ellipse
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The center of the ellipse
+		 * @param[in] a,b		The dimensions of the ellipse
+		 *
+		 * @api
+		 */
+		void gwinFillEllipse(GHandle gh, coord_t x, coord_t y, coord_t a, coord_t b);
+	#endif
+
+	#if GDISP_NEED_ARC || defined(__DOXYGEN__)
+		/*
+		 * @brief	Draw an arc in the window.
+		 * @note	Uses the current foreground color to draw the arc
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The center point
+		 * @param[in] radius	The radius of the arc
+		 * @param[in] start		The start angle (0 to 360)
+		 * @param[in] end		The end angle (0 to 360)
+		 *
+		 * @api
+		 */
+		void gwinDrawArc(GHandle gh, coord_t x, coord_t y, coord_t radius, coord_t startangle, coord_t endangle);
+
+		/*
+		 * @brief	Draw a filled arc in the window.
+		 * @note	Uses the current foreground color to draw the filled arc
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The center point
+		 * @param[in] radius	The radius of the arc
+		 * @param[in] start		The start angle (0 to 360)
+		 * @param[in] end		The end angle (0 to 360)
+		 *
+		 * @api
+		 */
+		void gwinFillArc(GHandle gh, coord_t x, coord_t y, coord_t radius, coord_t startangle, coord_t endangle);
+	#endif
+
+/*-------------------------------------------------
+ * Pixel read-back functions
+ *-------------------------------------------------*/
+
+	#if GDISP_NEED_PIXELREAD || defined(__DOXYGEN__)
+		/**
+		 * @brief   Get the color of a pixel in the window.
+		 * @return  The color of the pixel.
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The position in the window
+		 *
+		 * @api
+		 */
+		color_t gwinGetPixelColor(GHandle gh, coord_t x, coord_t y);
+	#endif
+
+/*-------------------------------------------------
+ * Text functions
+ *-------------------------------------------------*/
+
+	#if GDISP_NEED_TEXT || defined(__DOXYGEN__)
+		/**
+		 * @brief   Draw a text character at the specified position in the window.
+		 * @pre		The font must have been set.
+		 * @note	Uses the current foreground color to draw the character
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The position for the text
+		 * @param[in] c			The character to draw
+		 *
+		 * @api
+		 */
+		void gwinDrawChar(GHandle gh, coord_t x, coord_t y, char c);
+
+		/**
+		 * @brief   Draw a text character with a filled background at the specified position in the window.
+		 * @pre		The font must have been set.
+		 * @note	Uses the current foreground color to draw the character and fills the background using the background drawing color
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The position for the text
+		 * @param[in] c			The character to draw
+		 *
+		 * @api
+		 */
+		void gwinFillChar(GHandle gh, coord_t x, coord_t y, char c);
+
+		/**
+		 * @brief   Draw a text string in the window
+		 * @pre		The font must have been set.
+		 * @note	Uses the current foreground color to draw the character
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The position for the text
+		 * @param[in] str		The string to draw
+		 *
+		 * @api
+		 */
+		void gwinDrawString(GHandle gh, coord_t x, coord_t y, const char *str);
+
+		/**
+		 * @brief   Draw a text string with a filled background in the window
+		 * @pre		The font must have been set.
+		 * @note	Uses the current foreground color to draw the character and fills the background using the background drawing color
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The position for the text
+		 * @param[in] str		The string to draw
+		 *
+		 * @api
+		 */
+		void gwinFillString(GHandle gh, coord_t x, coord_t y, const char *str);
+
+		/**
+		 * @brief   Draw a text string verticly centered within the specified box.
+		 * @pre		The font must have been set.
+		 * @note	Uses the current foreground color to draw the character.
+		 * @note    The specified box does not need to align with the window box
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The position for the text (need to define top-right or base-line - check code)
+		 * @param[in] cx,cy		The width and height of the box
+		 * @param[in] str		The string to draw
+		 * @param[in] justify	Justify the text left, center or right within the box
+		 *
+		 * @api
+		 */
+		void gwinDrawStringBox(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy, const char* str, justify_t justify);
+
+		/**
+		 * @brief   Draw a text string verticly centered within the specified filled box.
+		 * @pre		The font must have been set.
+		 * @note	Uses the current foreground color to draw the character and fills the background using the background drawing color
+		 * @note    The entire box is filled. Note this box does not need to align with the window box
+		 * @note	May leave GDISP clipping to this window's dimensions
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] x,y		The position for the text (need to define top-right or base-line - check code)
+		 * @param[in] cx,cy		The width and height of the box
+		 * @param[in] str		The string to draw
+		 * @param[in] justify	Justify the text left, center or right within the box
+		 *
+		 * @api
+		 */
+		void gwinFillStringBox(GHandle gh, coord_t x, coord_t y, coord_t cx, coord_t cy, const char* str, justify_t justify);
+	#endif
+
+/*-------------------------------------------------
+ * Polygon functions
+ *-------------------------------------------------*/
+
+	#if GDISP_NEED_CONVEX_POLYGON || defined(__DOXYGEN__)
+		/**
+		 * @brief   Draw an enclosed polygon (convex, non-convex or complex).
+		 *
+		 * @note	Uses the current foreground color.
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] tx, ty	Transform all points in pntarray by tx, ty
+		 * @param[in] pntarray	An array of points
+		 * @param[in] cnt		The number of points in the array
+		 *
+		 * @api
+		 */
+		void gwinDrawPoly(GHandle gh, coord_t tx, coord_t ty, const point *pntarray, unsigned cnt);
+
+		/**
+		 * @brief   Fill a convex polygon
+		 * @details Doesn't handle non-convex or complex polygons.
+		 *
+		 * @note	Uses the current foreground color.
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] tx, ty	Transform all points in pntarray by tx, ty
+		 * @param[in] pntarray	An array of points
+		 * @param[in] cnt		The number of points in the array
+		 *
+		 * @note	Convex polygons are those that have no internal angles. That is;
+		 * 			you can draw a line from any point on the polygon to any other point
+		 * 			on the polygon without it going outside the polygon. In our case we generalise
+		 * 			this a little by saying that an infinite horizontal line (at any y value) will cross
+		 * 			no more than two edges on the polygon. Some non-convex polygons do fit this criteria
+		 * 			and can therefore be drawn.
+		 * @note	This routine is designed to be very efficient with even simple display hardware.
+		 *
+		 * @api
+		 */
+		void gwinFillConvexPoly(GHandle gh, coord_t tx, coord_t ty, const point *pntarray, unsigned cnt);
+	#endif
+
+/*-------------------------------------------------
+ * Image functions
+ *-------------------------------------------------*/
+
+	#if GDISP_NEED_IMAGE || defined(__DOXYGEN__)
+		/**
+		 * @brief	Draw the image
+		 * @return	GDISP_IMAGE_ERR_OK (0) on success or an error code.
+		 *
+		 * @param[in] gh		The window handle
+		 * @param[in] img   	The image structure
+		 * @param[in] x,y		The window location to draw the image
+		 * @param[in] cx,cy		The area on the screen to draw
+		 * @param[in] sx,sy		The image position to start drawing at
+		 *
+		 * @pre		gdispImageOpen() must have returned successfully.
+		 *
+		 * @note	If sx,sy + cx,cy is outside the image boundaries the area outside the image
+		 * 			is simply not drawn.
+		 * @note	If @p gdispImageCache() has been called first for this frame, this routine will draw using a
+		 * 			fast blit from the cached frame. If not, it reads the input and decodes it as it
+		 * 			is drawing. This may be significantly slower than if the image has been cached (but
+		 * 			uses a lot less RAM)
+		 *
+		 * @api
+		 */
+		gdispImageError gwinImageDraw(GHandle gh, gdispImage *img, coord_t x, coord_t y, coord_t cx, coord_t cy, coord_t sx, coord_t sy);
+	#endif
 
 #ifdef __cplusplus
 }
 #endif
 
-/* Include widgets */
-#include "gwin/gwidget.h"
-
-/* Include extra window types */
-#if GWIN_NEED_CONSOLE || defined(__DOXYGEN__)
-	#include "gwin/console.h"
-#endif
-#if GWIN_NEED_GRAPH || defined(__DOXYGEN__)
-	#include "gwin/graph.h"
-#endif
+/*-------------------------------------------------
+ * Additional functionality
+ *-------------------------------------------------*/
+
+	/* Include widgets */
+	#if GWIN_NEED_WIDGET || defined(__DOXYGEN__)
+		#include "gwin/gwidget.h"
+	#endif
+
+	/* Include extra window types */
+	#if GWIN_NEED_CONSOLE || defined(__DOXYGEN__)
+		#include "gwin/console.h"
+	#endif
+	#if GWIN_NEED_GRAPH || defined(__DOXYGEN__)
+		#include "gwin/graph.h"
+	#endif
 
 #endif /* GFX_USE_GWIN */
 
diff --git a/include/gwin/options.h b/include/gwin/options.h
index 683a6e55..3619e075 100644
--- a/include/gwin/options.h
+++ b/include/gwin/options.h
@@ -21,20 +21,22 @@
  * @{
  */
 	/**
-	 * @brief   Should button functions be included.
+	 * @brief   Should a window manager be used.
 	 * @details	Defaults to FALSE
 	 */
-	#ifndef GWIN_NEED_BUTTON
-		#define GWIN_NEED_BUTTON	FALSE
+	#ifndef GWIN_NEED_WINDOWMANAGER
+		#define GWIN_NEED_WINDOWMANAGER	FALSE
+	#endif
+	/**
+	 * @brief   Should widget functions be included. Needed for any widget (eg Buttons, Sliders etc)
+	 * @details	Defaults to FALSE
+	 */
+	#ifndef GWIN_NEED_WIDGET
+		#define GWIN_NEED_WIDGET	FALSE
 	#endif
 	/**
 	 * @brief   Should console functions be included.
 	 * @details	Defaults to FALSE
-	 * @note	To use chprintf() for printing in a console window you need to
-	 * 			include in your application source file...
-	 * 			\#include "chprintf.h"
-	 * 			Also in your makefile, as part of your list of C source files, include
-	 * 			${CHIBIOS}/os/various/chprintf.c
 	 */
 	#ifndef GWIN_NEED_CONSOLE
 		#define GWIN_NEED_CONSOLE	FALSE
@@ -47,12 +49,26 @@
 		#define GWIN_NEED_GRAPH		FALSE
 	#endif
 	/**
+	 * @brief   Should button functions be included.
+	 * @details	Defaults to FALSE
+	 */
+	#ifndef GWIN_NEED_BUTTON
+		#define GWIN_NEED_BUTTON	FALSE
+	#endif
+	/**
 	 * @brief   Should slider functions be included.
 	 * @details	Defaults to FALSE
 	 */
 	#ifndef GWIN_NEED_SLIDER
 		#define GWIN_NEED_SLIDER	FALSE
 	#endif
+	/**
+	 * @brief   Should checkbox functions be included.
+	 * @details	Defaults to FALSE
+	 */
+	#ifndef GWIN_NEED_CHECKBOX
+		#define GWIN_NEED_CHECKBOX	FALSE
+	#endif
 /**
  * @}
  *
@@ -76,6 +92,12 @@
 	/**
 	 * @brief   Console Windows need BaseStreamSequential support (ChibiOS only)
 	 * @details	Defaults to FALSE
+	 * @note	To use the ChibiOS basestream functions such as chprintf()
+	 * 			for printing in a console window you need to set this option to
+	 * 			TRUE in your gfxconf.h and include in your application source file...
+	 * 			\#include "chprintf.h"
+	 * 			In your makefile, as part of your list of C source files, include
+	 * 			${CHIBIOS}/os/various/chprintf.c
 	 */
 	#ifndef GWIN_CONSOLE_USE_BASESTREAM
 		#define GWIN_CONSOLE_USE_BASESTREAM		FALSE