2005-05-04 14:57:50 -04:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: wx/glcanvas.h
|
|
|
|
// Purpose: wxGLCanvas base header
|
|
|
|
// Author: Julian Smart
|
|
|
|
// Modified by:
|
|
|
|
// Created:
|
|
|
|
// Copyright: (c) Julian Smart
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Licence: wxWindows licence
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
2000-02-28 03:22:57 -05:00
|
|
|
#ifndef _WX_GLCANVAS_H_BASE_
|
|
|
|
#define _WX_GLCANVAS_H_BASE_
|
|
|
|
|
2001-09-28 10:01:34 -04:00
|
|
|
#include "wx/defs.h"
|
|
|
|
|
|
|
|
#if wxUSE_GLCANVAS
|
|
|
|
|
2007-04-10 13:38:55 -04:00
|
|
|
#include "wx/app.h"
|
|
|
|
#include "wx/palette.h"
|
|
|
|
#include "wx/window.h"
|
2006-11-05 19:57:46 -05:00
|
|
|
|
2007-07-09 06:09:52 -04:00
|
|
|
class WXDLLIMPEXP_FWD_GL wxGLCanvas;
|
|
|
|
class WXDLLIMPEXP_FWD_GL wxGLContext;
|
2007-04-10 13:38:55 -04:00
|
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// Constants for attributes list
|
|
|
|
// ----------------------------------------------------------------------------
|
2006-11-05 19:57:46 -05:00
|
|
|
|
2007-04-10 13:38:55 -04:00
|
|
|
// The generic OpenGL implementation doesn't support most of these options,
|
|
|
|
// such as stereo, auxiliary buffers, alpha channel, and accumulator buffer.
|
|
|
|
// Other implementations may actually support them.
|
2006-11-05 19:57:46 -05:00
|
|
|
enum
|
|
|
|
{
|
|
|
|
WX_GL_RGBA=1, /* use true color palette */
|
|
|
|
WX_GL_BUFFER_SIZE, /* bits for buffer if not WX_GL_RGBA */
|
|
|
|
WX_GL_LEVEL, /* 0 for main buffer, >0 for overlay, <0 for underlay */
|
|
|
|
WX_GL_DOUBLEBUFFER, /* use doublebuffer */
|
|
|
|
WX_GL_STEREO, /* use stereoscopic display */
|
|
|
|
WX_GL_AUX_BUFFERS, /* number of auxiliary buffers */
|
|
|
|
WX_GL_MIN_RED, /* use red buffer with most bits (> MIN_RED bits) */
|
|
|
|
WX_GL_MIN_GREEN, /* use green buffer with most bits (> MIN_GREEN bits) */
|
|
|
|
WX_GL_MIN_BLUE, /* use blue buffer with most bits (> MIN_BLUE bits) */
|
2006-11-24 05:30:42 -05:00
|
|
|
WX_GL_MIN_ALPHA, /* use alpha buffer with most bits (> MIN_ALPHA bits) */
|
2006-11-05 19:57:46 -05:00
|
|
|
WX_GL_DEPTH_SIZE, /* bits for Z-buffer (0,16,32) */
|
|
|
|
WX_GL_STENCIL_SIZE, /* bits for stencil buffer */
|
|
|
|
WX_GL_MIN_ACCUM_RED, /* use red accum buffer with most bits (> MIN_ACCUM_RED bits) */
|
|
|
|
WX_GL_MIN_ACCUM_GREEN, /* use green buffer with most bits (> MIN_ACCUM_GREEN bits) */
|
|
|
|
WX_GL_MIN_ACCUM_BLUE, /* use blue buffer with most bits (> MIN_ACCUM_BLUE bits) */
|
2006-11-24 05:30:42 -05:00
|
|
|
WX_GL_MIN_ACCUM_ALPHA /* use alpha buffer with most bits (> MIN_ACCUM_ALPHA bits) */
|
2006-11-05 19:57:46 -05:00
|
|
|
};
|
|
|
|
|
2002-12-04 09:11:26 -05:00
|
|
|
#define wxGLCanvasName _T("GLCanvas")
|
|
|
|
|
2007-04-10 13:38:55 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxGLContextBase: OpenGL rendering context
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class WXDLLIMPEXP_GL wxGLContextBase : public wxObject
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
/*
|
|
|
|
The derived class should provide a ctor with this signature:
|
|
|
|
|
|
|
|
wxGLContext(wxGLCanvas *win, const wxGLContext *other = NULL);
|
|
|
|
*/
|
|
|
|
|
|
|
|
// set this context as the current one
|
|
|
|
virtual void SetCurrent(const wxGLCanvas& win) const = 0;
|
|
|
|
};
|
|
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxGLCanvasBase: window which can be used for OpenGL rendering
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class WXDLLIMPEXP_GL wxGLCanvasBase : public wxWindow
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
// default ctor doesn't initialize the window, use Create() later
|
2007-04-15 19:29:45 -04:00
|
|
|
wxGLCanvasBase();
|
2007-04-10 13:38:55 -04:00
|
|
|
|
|
|
|
virtual ~wxGLCanvasBase();
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
The derived class should provide a ctor with this signature:
|
|
|
|
|
|
|
|
wxGLCanvas(wxWindow *parent,
|
|
|
|
wxWindowID id = wxID_ANY,
|
|
|
|
int* attribList = 0,
|
|
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
|
|
const wxSize& size = wxDefaultSize,
|
|
|
|
long style = 0,
|
|
|
|
const wxString& name = wxGLCanvasName,
|
|
|
|
const wxPalette& palette = wxNullPalette);
|
|
|
|
*/
|
|
|
|
|
|
|
|
// operations
|
|
|
|
// ----------
|
|
|
|
|
|
|
|
// set the given context associated with this window as the current one
|
|
|
|
void SetCurrent(const wxGLContext& context) const;
|
|
|
|
|
|
|
|
// flush the back buffer (if we have it)
|
|
|
|
virtual void SwapBuffers() = 0;
|
|
|
|
|
|
|
|
|
|
|
|
// accessors
|
|
|
|
// ---------
|
|
|
|
|
|
|
|
const wxPalette *GetPalette() const { return &m_palette; }
|
|
|
|
|
|
|
|
// miscellaneous helper functions
|
|
|
|
// ------------------------------
|
|
|
|
|
|
|
|
// call glcolor() for the colour with the given name, return false if
|
|
|
|
// colour not found
|
2007-06-19 07:54:36 -04:00
|
|
|
bool SetColour(const wxString& colour);
|
2007-04-10 13:38:55 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// deprecated methods using the implicit wxGLContext
|
|
|
|
#if WXWIN_COMPATIBILITY_2_8
|
|
|
|
wxDEPRECATED( wxGLContext* GetContext() const );
|
|
|
|
|
|
|
|
wxDEPRECATED( void SetCurrent() );
|
|
|
|
|
|
|
|
wxDEPRECATED( void OnSize(wxSizeEvent& event) );
|
|
|
|
#endif // WXWIN_COMPATIBILITY_2_8
|
|
|
|
|
|
|
|
#ifdef __WXUNIVERSAL__
|
|
|
|
// resolve the conflict with wxWindowUniv::SetCurrent()
|
|
|
|
virtual bool SetCurrent(bool doit) { return wxWindow::SetCurrent(doit); };
|
|
|
|
#endif
|
|
|
|
|
|
|
|
protected:
|
|
|
|
// override this to implement SetColour() in GL_INDEX_MODE
|
|
|
|
// (currently only implemented in wxX11 and wxMotif ports)
|
|
|
|
virtual int GetColourIndex(const wxColour& WXUNUSED(col)) { return -1; }
|
|
|
|
|
|
|
|
// create default palette if we're not using RGBA mode
|
|
|
|
// (not supported in most ports)
|
|
|
|
virtual wxPalette CreateDefaultPalette() { return wxNullPalette; }
|
|
|
|
|
|
|
|
|
|
|
|
wxPalette m_palette;
|
|
|
|
|
|
|
|
#if WXWIN_COMPATIBILITY_2_8
|
|
|
|
wxGLContext *m_glContext;
|
|
|
|
#endif // WXWIN_COMPATIBILITY_2_8
|
|
|
|
};
|
|
|
|
|
2007-04-15 19:06:45 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxGLApp: a special wxApp subclass for OpenGL applications which must be used
|
|
|
|
// to select a visual compatible with the given attributes
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class WXDLLIMPEXP_GL wxGLAppBase : public wxApp
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
wxGLAppBase() : wxApp() { }
|
|
|
|
|
|
|
|
// use this in the constructor of the user-derived wxGLApp class to
|
|
|
|
// determine if an OpenGL rendering context with these attributes
|
|
|
|
// is available - returns true if so, false if not.
|
|
|
|
virtual bool InitGLVisual(const int *attribList) = 0;
|
|
|
|
};
|
|
|
|
|
2000-02-28 03:22:57 -05:00
|
|
|
#if defined(__WXMSW__)
|
2007-04-10 13:38:55 -04:00
|
|
|
#include "wx/msw/glcanvas.h"
|
|
|
|
#elif defined(__WXMOTIF__) || defined(__WXX11__)
|
|
|
|
#include "wx/x11/glcanvas.h"
|
2006-01-22 22:27:34 -05:00
|
|
|
#elif defined(__WXGTK20__)
|
2007-04-10 13:38:55 -04:00
|
|
|
#include "wx/gtk/glcanvas.h"
|
2006-01-22 22:27:34 -05:00
|
|
|
#elif defined(__WXGTK__)
|
2007-04-10 13:38:55 -04:00
|
|
|
#include "wx/gtk1/glcanvas.h"
|
2000-02-28 03:22:57 -05:00
|
|
|
#elif defined(__WXMAC__)
|
2007-04-10 13:38:55 -04:00
|
|
|
#include "wx/mac/glcanvas.h"
|
2004-10-01 10:23:59 -04:00
|
|
|
#elif defined(__WXCOCOA__)
|
2007-04-10 13:38:55 -04:00
|
|
|
#include "wx/cocoa/glcanvas.h"
|
2006-11-13 14:50:59 -05:00
|
|
|
#else
|
2007-04-10 13:38:55 -04:00
|
|
|
#error "wxGLCanvas not supported in this wxWidgets port"
|
2000-02-28 03:22:57 -05:00
|
|
|
#endif
|
|
|
|
|
2007-04-15 19:06:45 -04:00
|
|
|
// wxMac and wxMSW don't need anything extra in wxGLAppBase, so declare it here
|
|
|
|
#ifndef wxGL_APP_DEFINED
|
|
|
|
|
|
|
|
class WXDLLIMPEXP_GL wxGLApp : public wxGLAppBase
|
2001-09-28 10:01:34 -04:00
|
|
|
{
|
|
|
|
public:
|
2007-04-15 19:06:45 -04:00
|
|
|
wxGLApp() : wxGLAppBase() { }
|
2001-09-28 10:01:34 -04:00
|
|
|
|
2007-04-15 19:06:45 -04:00
|
|
|
virtual bool InitGLVisual(const int *attribList);
|
2001-09-28 10:01:34 -04:00
|
|
|
|
|
|
|
private:
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxGLApp)
|
|
|
|
};
|
|
|
|
|
2007-04-15 19:06:45 -04:00
|
|
|
#endif // !wxGL_APP_DEFINED
|
|
|
|
|
2007-04-10 13:38:55 -04:00
|
|
|
#endif // wxUSE_GLCANVAS
|
|
|
|
|
|
|
|
#endif // _WX_GLCANVAS_H_BASE_
|