aboutsummaryrefslogtreecommitdiffstats
path: root/src/gfx.h
blob: 61b68b7339dc347b6e831b60ee9ff40063dcd2b7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
/*
 * This file is subject to the terms of the GFX License. If a copy of
 * the license was not distributed with this file, you can obtain one at:
 *
 *              http://ugfx.io/license.html
 */

/**
 * @file    gfx.h
 * @brief   GFX system header file.
 *
 * @addtogroup GFX
 *
 * @brief	Main module to glue all the others together
 *
 * @{
 */

#ifndef _GFX_H
#define _GFX_H

// Everything here is C, not C++
#ifdef __cplusplus
extern "C" {
#endif

// ------------------------------ Initial preparation ---------------------------------
#undef  GFX_COMPILESTAGE
#define GFX_COMPILESTAGE				GFX_COMPILESTAGE_PREP

// Compiling stages
#define GFX_COMPILESTAGE_USERPROGRAM		0		// Compiling the user program
#define GFX_COMPILESTAGE_PREP				1		// gfx.h: Initial preparation
#define GFX_COMPILESTAGE_USERCONFIG			2		// gfx.h: Load the user configuration
#define GFX_COMPILESTAGE_COMPILECONFIG		3		// gfx.h: Determine build environment info - COMPILER, CPU etc
#define GFX_COMPILESTAGE_OPTIONS			3		// gfx.h: Enumerate all options
#define GFX_COMPILESTAGE_DRIVERCONFIG		4		// gfx.h: Load driver configuration
#define GFX_COMPILESTAGE_DRIVERAPI			5		// gfx.h: Load driver public api
#define GFX_COMPILESTAGE_RULES				6		// gfx.h: Apply configuration rules
#define GFX_COMPILESTAGE_APIDEFS			7		// gfx.h: Define API definitions
#define GFX_COMPILESTAGE_COMPILEDRIVERS		100		// gfx.c: Compile drivers
#define GFX_COMPILESTAGE_COMPILECAPI		101		// gfx.c: Compile the uGFX C API
#define GFX_COMPILESTAGE_COMPILECPPAPI		102		// gfx.cpp: Compile the uGFX C++ API

// ------------------------------ Load the user configuration ---------------------------------
#undef  GFX_COMPILESTAGE
#define GFX_COMPILESTAGE				GFX_COMPILESTAGE_USERCONFIG

// Definitions for option configuration
#define GFXOFF		(0)
#define GFXON		(-1)

// gfxconf.h is the user's project configuration for the GFX system.
#include "gfxconf.h"

// ------------------------------ Determine build environment info - COMPILER, CPU etc ---------------------------------
#undef  GFX_COMPILESTAGE
#define GFX_COMPILESTAGE				GFX_COMPILESTAGE_COMPILECONFIG

/**
 * @name    GFX compatibility options
 * @{
 */
	/**
	 * @brief   Include the uGFX V2.x API
	 * @details	Defaults to GFXON
	 */
	#ifndef GFX_COMPAT_V2
		#define GFX_COMPAT_V2				GFXON
	#endif
/** @} */

#if GFX_COMPAT_V2
	// These need to be defined here for compatibility with V2.x user config files
	#if !defined(FALSE)
		#define FALSE       0
	#endif
	#if !defined(TRUE)
		#define TRUE        -1
	#endif
#endif

// Are we in the uGFX library implementation itself? - not API documented
#ifndef GFX_COMPILE_INTERNAL_API
	#define GFX_COMPILE_INTERNAL_API		GFXOFF
#endif

// Macro concatination and strify - not API documented
#define GFXCAT(a, b)	a ## b
#define GFXCATX(a, b)	GFXCAT(a, b)
#define GFXSTR(a)		#a
#define GFXSTRX(a)		GFXSTR(a)

// Include Compiler and CPU support
#include "gfx_compilers.h"

// Include standard types
#include "gfx_types.h"

// Public uGFX API calling convention
#ifndef GFXAPI
	#define GFXAPI
#endif

// Public uGFX API callback convention
#ifndef GFXUSERFN
	#define GFXUSERFN		GFXAPI
#endif

// Private uGFX API calling convention
#if GFX_COMPILE_INTERNAL_API && !defined(GFXINTERNAL)
	#define GFXINTERNAL
#endif

// ------------------------------ Enumerate all options ---------------------------------
#undef  GFX_COMPILESTAGE
#define GFX_COMPILESTAGE				GFX_COMPILESTAGE_OPTIONS

/**
 * Get all the options for each sub-system.
 */
#include "gfx_options.h"
#include "gos/gos_options.h"
#include "gdriver/gdriver_options.h"
#include "gfile/gfile_options.h"
#include "gmisc/gmisc_options.h"
#include "gtrans/gtrans_options.h"
#include "gqueue/gqueue_options.h"
#include "gevent/gevent_options.h"
#include "gtimer/gtimer_options.h"
#include "gdisp/gdisp_options.h"
#include "gwin/gwin_options.h"
#include "ginput/ginput_options.h"
#include "gadc/gadc_options.h"
#include "gaudio/gaudio_options.h"

// ------------------------------ Load driver configuration ---------------------------------
#undef  GFX_COMPILESTAGE
#define GFX_COMPILESTAGE				GFX_COMPILESTAGE_DRIVERCONFIG

// ------------------------------ Apply configuration rules ---------------------------------
#undef  GFX_COMPILESTAGE
#define GFX_COMPILESTAGE				GFX_COMPILESTAGE_RULES

/**
 * Interdependency safety checks on the sub-systems.
 * These must be in dependency order.
 */
#ifndef GFX_DISPLAY_RULE_WARNINGS
	#define GFX_DISPLAY_RULE_WARNINGS	GFXOFF
#endif
#include "gwin/gwin_rules.h"
#include "ginput/ginput_rules.h"
#include "gdisp/gdisp_rules.h"
#include "gaudio/gaudio_rules.h"
#include "gadc/gadc_rules.h"
#include "gevent/gevent_rules.h"
#include "gtimer/gtimer_rules.h"
#include "gqueue/gqueue_rules.h"
#include "gmisc/gmisc_rules.h"
#include "gtrans/gtrans_rules.h"
#include "gfile/gfile_rules.h"
#include "gdriver/gdriver_rules.h"
#include "gos/gos_rules.h"

// ------------------------------ Define API definitions ---------------------------------
#undef  GFX_COMPILESTAGE
#define GFX_COMPILESTAGE				GFX_COMPILESTAGE_APIDEFS

/**
 *  Include the sub-system header files
 */
#include "gos/gos.h"
#if GFX_COMPILE_INTERNAL_API
	#include "gdriver/gdriver.h"
#endif
#include "gfile/gfile.h"
#include "gmisc/gmisc.h"
#include "gtrans/gtrans.h"
#include "gqueue/gqueue.h"
#include "gevent/gevent.h"
#include "gtimer/gtimer.h"
#include "gdisp/gdisp.h"
#include "gwin/gwin.h"
#include "ginput/ginput.h"
#include "gadc/gadc.h"
#include "gaudio/gaudio.h"

/**
 * @brief	The one call to start it all
 *
 * @note	This will initialise each sub-system that has been turned on.
 * 			For example, if GFX_USE_GDISP is defined then display will be initialised
 * 			and cleared to black.
 * @note	If you define GFX_OS_NO_INIT as GFXON in your gfxconf.h file then ugfx doesn't try to
 * 			initialise the operating system for you when you call @p gfxInit().
 * @note	If you define GFX_OS_EXTRA_INIT_FUNCTION in your gfxconf.h file the macro is the
 * 			name of a void function with no parameters that is called immediately after
 * 			operating system initialisation (whether or not GFX_OS_NO_INIT is set).
 * @note	If you define GFX_OS_EXTRA_DEINIT_FUNCTION in your gfxconf.h file the macro is the
 * 			name of a void function with no parameters that is called immediately before
 * 			operating system de-initialisation (as ugfx is exiting).
 * @note	If GFX_OS_CALL_UGFXMAIN is set uGFXMain() is called after all initialisation is complete.
 *
 * @api
 */
void GFXAPI gfxInit(void);

/**
 * @brief	The one call to end it all
 *
 * @note	This will de-initialise each sub-system that has been turned on.
 *
 * @api
 */
void GFXAPI gfxDeinit(void);

#if GFX_OS_CALL_UGFXMAIN || defined(__DOXYGEN__)
	/**
	 * @brief	The user supplied function containing all the user uGFX application code.
	 *
	 * @note	This is called by gfxInit() and is expected to never return.
	 * 			It is defined by the user.
	 *
	 * @pre		GFX_OS_CALL_UGFXMAIN is GFXON
	 */
	void GFXUSERFN uGFXMain(void);
#endif

// ------------------------------ Compiling the user program ---------------------------------
#undef  GFX_COMPILESTAGE
#define GFX_COMPILESTAGE				GFX_COMPILESTAGE_USERPROGRAM

#ifdef __cplusplus
}
#endif
#endif /* _GFX_H */
/** @} */