aboutsummaryrefslogtreecommitdiffstats
path: root/src/gwin/gwin_gl3d.h
blob: 736d89a809a0b323c82e27d984332c5b78668ee8 (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
/*
 * 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	src/gwin/gwin_gl3d.h
 * @brief	GWIN 3D module header file
 *
 * @defgroup 3D 3D
 * @ingroup Windows
 *
 * @brief	Widget that can be used to render OpenGL.
 *
 * @details	3D GWIN window based on OpenGL (or more exactly Tiny GL)
 *
 * @pre		GFX_USE_GWIN must be set to GFXON in your gfxconf.h
 * @pre		GWIN_NEED_GL3D must be set to GFXON in your gfxconf.h
 *
 * @{
 */

#ifndef _GWIN_GL3D_H
#define _GWIN_GL3D_H

/* This file is included within "src/gwin/gwin.h" */


// A gl3d window
typedef struct GGL3DObject {
	GWindowObject		g;
	struct GLContext *	glcxt;
	} GGL3DObject;

/*===========================================================================*/
/* External declarations.                                                    */
/*===========================================================================*/

/**
 * @brief   Create a gl3d window.
 * @return  NULL if there is no resultant drawing area, otherwise a window handle.
 *
 * @param[in] g			The GDisplay to display this window on
 * @param[in] gg		The GGL3DObject structure to initialise. If this is NULL the structure is dynamically allocated.
 * @param[in] pInit		The initialization parameters to use
 *
 * @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 GFX_WHITE and GFX_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.
 *
 * @api
 */
GHandle gwinGGL3DCreate(GDisplay *g, GGL3DObject *gg, const GWindowInit *pInit);
#define gwinGL3DCreate(gg, pInit)			gwinGGL3DCreate(GDISP, gg, pInit)

/* Include the gl interface */
#include "../../3rdparty/tinygl-0.4-ugfx/include/GL/gl.h"

#endif	/* _GWIN_GL3D_H */
/** @} */