1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/msw/glcanvas.h
3 // Purpose: wxGLCanvas, for using OpenGL with wxWidgets under Windows
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_GLCANVAS_H_
13 #define _WX_GLCANVAS_H_
15 #include "wx/palette.h"
16 #include "wx/scrolwin.h"
19 #include "wx/msw/winundef.h"
23 //---------------------------------------------------------------------------
24 // Constants for attriblist
25 //---------------------------------------------------------------------------
27 // The generic GL implementation doesn't support most of these options,
28 // such as stereo, auxiliary buffers, alpha channel, and accum buffer.
29 // Other implementations may actually support them.
33 WX_GL_RGBA
=1, /* use true color palette */
34 WX_GL_BUFFER_SIZE
, /* bits for buffer if not WX_GL_RGBA */
35 WX_GL_LEVEL
, /* 0 for main buffer, >0 for overlay, <0 for underlay */
36 WX_GL_DOUBLEBUFFER
, /* use doublebuffer */
37 WX_GL_STEREO
, /* use stereoscopic display */
38 WX_GL_AUX_BUFFERS
, /* number of auxiliary buffers */
39 WX_GL_MIN_RED
, /* use red buffer with most bits (> MIN_RED bits) */
40 WX_GL_MIN_GREEN
, /* use green buffer with most bits (> MIN_GREEN bits) */
41 WX_GL_MIN_BLUE
, /* use blue buffer with most bits (> MIN_BLUE bits) */
42 WX_GL_MIN_ALPHA
, /* use blue buffer with most bits (> MIN_ALPHA bits) */
43 WX_GL_DEPTH_SIZE
, /* bits for Z-buffer (0,16,32) */
44 WX_GL_STENCIL_SIZE
, /* bits for stencil buffer */
45 WX_GL_MIN_ACCUM_RED
, /* use red accum buffer with most bits (> MIN_ACCUM_RED bits) */
46 WX_GL_MIN_ACCUM_GREEN
, /* use green buffer with most bits (> MIN_ACCUM_GREEN bits) */
47 WX_GL_MIN_ACCUM_BLUE
, /* use blue buffer with most bits (> MIN_ACCUM_BLUE bits) */
48 WX_GL_MIN_ACCUM_ALPHA
/* use blue buffer with most bits (> MIN_ACCUM_ALPHA bits) */
51 class WXDLLIMPEXP_GL wxGLCanvas
; /* forward reference */
53 class WXDLLIMPEXP_GL wxGLContext
: public wxObject
56 wxGLContext(bool isRGB
, wxGLCanvas
*win
, const wxPalette
& palette
= wxNullPalette
);
58 wxGLContext( bool isRGB
, wxGLCanvas
*win
,
59 const wxPalette
& WXUNUSED(palette
),
60 const wxGLContext
*other
/* for sharing display lists */ );
62 virtual ~wxGLContext();
67 void SetColour(const wxChar
*colour
);
72 inline wxWindow
* GetWindow() const { return m_window
; }
74 inline WXHDC
GetHDC() const { return m_hDC
; }
76 inline HGLRC
GetGLRC() const { return m_glContext
; }
84 class WXDLLIMPEXP_GL wxGLCanvas
: public wxWindow
86 DECLARE_CLASS(wxGLCanvas
)
88 wxGLCanvas(wxWindow
*parent
, wxWindowID id
= wxID_ANY
,
89 const wxPoint
& pos
= wxDefaultPosition
,
90 const wxSize
& size
= wxDefaultSize
, long style
= 0,
91 const wxString
& name
= wxGLCanvasName
, int *attribList
= 0,
92 const wxPalette
& palette
= wxNullPalette
);
94 wxGLCanvas(wxWindow
*parent
,
95 const wxGLContext
*shared
,
96 wxWindowID id
= wxID_ANY
,
97 const wxPoint
& pos
= wxDefaultPosition
,
98 const wxSize
& size
= wxDefaultSize
,
100 const wxString
& name
= wxGLCanvasName
,
101 int *attribList
= (int *) NULL
,
102 const wxPalette
& palette
= wxNullPalette
);
104 wxGLCanvas(wxWindow
*parent
,
105 const wxGLCanvas
*shared
,
106 wxWindowID id
= wxID_ANY
,
107 const wxPoint
& pos
= wxDefaultPosition
,
108 const wxSize
& size
= wxDefaultSize
,
110 const wxString
& name
= wxGLCanvasName
,
112 const wxPalette
& palette
= wxNullPalette
);
114 virtual ~wxGLCanvas();
116 // Replaces wxWindow::Create functionality, since
117 // we need to use a different window class
118 bool Create(wxWindow
*parent
, wxWindowID id
,
119 const wxPoint
& pos
, const wxSize
& size
,
120 long style
, const wxString
& name
);
124 #ifdef __WXUNIVERSAL__
125 virtual bool SetCurrent(bool doit
) { return wxWindow::SetCurrent(doit
); };
128 void SetColour(const wxChar
*colour
);
132 void OnSize(wxSizeEvent
& event
);
134 void OnQueryNewPalette(wxQueryNewPaletteEvent
& event
);
136 void OnPaletteChanged(wxPaletteChangedEvent
& event
);
138 inline wxGLContext
* GetContext() const { return m_glContext
; }
140 inline WXHDC
GetHDC() const { return m_hDC
; }
142 void SetupPixelFormat(int *attribList
= (int *) NULL
);
144 void SetupPalette(const wxPalette
& palette
);
146 wxPalette
CreateDefaultPalette();
148 inline wxPalette
* GetPalette() const { return (wxPalette
*) &m_palette
; }
151 wxGLContext
* m_glContext
; // this is typedef-ed ptr, in fact
155 DECLARE_EVENT_TABLE()