|
Shinya Kitaoka |
810553 |
#pragma once
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
#ifndef TGLDISPLAYLISTSMANAGER_H
|
|
Toshihiro Shimizu |
890ddd |
#define TGLDISPLAYLISTSMANAGER_H
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
// TnzCore includes
|
|
Toshihiro Shimizu |
890ddd |
#include "tgl.h"
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
// tcg includes
|
|
Toshihiro Shimizu |
890ddd |
#include "tcg/tcg_observer_notifier.h"
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
// Qt includes
|
|
Toshihiro Shimizu |
890ddd |
#include <qmutex></qmutex>
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
#undef DVAPI
|
|
Toshihiro Shimizu |
890ddd |
#undef DVVAR
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
#ifdef TGL_EXPORTS
|
|
Toshihiro Shimizu |
890ddd |
#define DVAPI DV_EXPORT_API
|
|
Toshihiro Shimizu |
890ddd |
#define DVVAR DV_EXPORT_VAR
|
|
Toshihiro Shimizu |
890ddd |
#else
|
|
Toshihiro Shimizu |
890ddd |
#define DVAPI DV_IMPORT_API
|
|
Toshihiro Shimizu |
890ddd |
#define DVVAR DV_IMPORT_VAR
|
|
Toshihiro Shimizu |
890ddd |
#endif
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
//**************************************************************************************************
|
|
Toshihiro Shimizu |
890ddd |
// TGLDisplayListsProxy declaration
|
|
Toshihiro Shimizu |
890ddd |
//**************************************************************************************************
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
120a6e |
//! TGLDisplayListsProxy is a wrapper to a dummy OpenGL context attached to a
|
|
Shinya Kitaoka |
120a6e |
//! specific display lists space.
|
|
Toshihiro Shimizu |
890ddd |
/*!
|
|
Shinya Kitaoka |
120a6e |
TGLDisplayListsProxy implements the basic functionalities necessary to address
|
|
Shinya Kitaoka |
120a6e |
a display lists
|
|
Shinya Kitaoka |
120a6e |
space without having to access any actual associated OpenGL context. This is
|
|
Shinya Kitaoka |
120a6e |
equivalent to
|
|
Toshihiro Shimizu |
890ddd |
making a hidden OpenGL context (the display lists proxy) the \a current one.
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
120a6e |
\note Implementations of the TGLDisplayListsProxy must take ownership of the
|
|
Shinya Kitaoka |
120a6e |
proxy.
|
|
Toshihiro Shimizu |
890ddd |
*/
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
120a6e |
class TGLDisplayListsProxy {
|
|
Shinya Kitaoka |
120a6e |
QMutex m_mutex;
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
public:
|
|
Shinya Kitaoka |
120a6e |
virtual ~TGLDisplayListsProxy() {}
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
120a6e |
virtual void makeCurrent() = 0;
|
|
Shinya Kitaoka |
120a6e |
virtual void doneCurrent() = 0;
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
120a6e |
QMutex *mutex() { return &m_mutex; }
|
|
Toshihiro Shimizu |
890ddd |
};
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
//**************************************************************************************************
|
|
Toshihiro Shimizu |
890ddd |
// TGLDisplayListsProxy template specializations
|
|
Toshihiro Shimizu |
890ddd |
//**************************************************************************************************
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
template <typename context=""></typename>
|
|
Shinya Kitaoka |
d1f6c4 |
class TGLDisplayListsProxyT final : public TGLDisplayListsProxy {
|
|
Shinya Kitaoka |
120a6e |
Context *m_proxy;
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
public:
|
|
Shinya Kitaoka |
120a6e |
TGLDisplayListsProxyT(Context *proxy) : m_proxy(proxy) {}
|
|
Shinya Kitaoka |
120a6e |
~TGLDisplayListsProxyT() { delete m_proxy; }
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
473e70 |
void makeCurrent() override { m_proxy->makeCurrent(); }
|
|
Shinya Kitaoka |
473e70 |
void doneCurrent() override { m_proxy->doneCurrent(); }
|
|
Toshihiro Shimizu |
890ddd |
};
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
//**************************************************************************************************
|
|
Toshihiro Shimizu |
890ddd |
// TGLDisplayListsManager declaration
|
|
Toshihiro Shimizu |
890ddd |
//**************************************************************************************************
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
120a6e |
//! TGLDisplayListsManager is a singleton class used to track OpenGL shared
|
|
Shinya Kitaoka |
120a6e |
//! display lists spaces.
|
|
Toshihiro Shimizu |
890ddd |
/*!
|
|
Shinya Kitaoka |
120a6e |
OpenGL contexts can share their display lists space (in particular, this
|
|
Shinya Kitaoka |
120a6e |
includes texture
|
|
Shinya Kitaoka |
120a6e |
objects) with other contexts. Typically, sharing specification happens when a
|
|
Shinya Kitaoka |
120a6e |
new context
|
|
Shinya Kitaoka |
120a6e |
is created - at that point, the new context is allowed to share the lists
|
|
Shinya Kitaoka |
120a6e |
space of another
|
|
Toshihiro Shimizu |
890ddd |
known context, pretty much the same way a shared smart pointer does.
|
|
Toshihiro Shimizu |
890ddd |
\n\n
|
|
Shinya Kitaoka |
120a6e |
However, OpenGL provides access to the display lists space \a only through
|
|
Shinya Kitaoka |
120a6e |
their attached
|
|
Shinya Kitaoka |
120a6e |
OpenGL contexts; meaning that an external object has to know at least one
|
|
Shinya Kitaoka |
120a6e |
associated context
|
|
Toshihiro Shimizu |
890ddd |
to operate on a display lists space.
|
|
Toshihiro Shimizu |
890ddd |
\n\n
|
|
Shinya Kitaoka |
120a6e |
We'll call such an associated context a \a proxy of the display lists space.
|
|
Shinya Kitaoka |
120a6e |
It is a dummy
|
|
Shinya Kitaoka |
120a6e |
OpenGL context that shares the display lists spaces with those that are
|
|
Shinya Kitaoka |
120a6e |
attached to it.
|
|
Toshihiro Shimizu |
890ddd |
\n\n
|
|
Shinya Kitaoka |
120a6e |
Observe that the use of one such dummy context, rather than one of the
|
|
Shinya Kitaoka |
120a6e |
originally
|
|
Shinya Kitaoka |
120a6e |
attached ones, is strictly necessary in a multithreaded environment, since
|
|
Shinya Kitaoka |
120a6e |
an OpenGL
|
|
Shinya Kitaoka |
120a6e |
context can be active in exactly one thread at a given time <\I> - and any of
|
|
Shinya Kitaoka |
120a6e |
the attached
|
|
Toshihiro Shimizu |
890ddd |
contexts could always be current in another thread.
|
|
Toshihiro Shimizu |
890ddd |
\n\n
|
|
Shinya Kitaoka |
120a6e |
However, the use of a single proxy per display lists space means that multiple
|
|
Shinya Kitaoka |
120a6e |
threads
|
|
Shinya Kitaoka |
120a6e |
could try to access it at the same time. Synchronization in this case must be
|
|
Shinya Kitaoka |
120a6e |
handled by
|
|
Toshihiro Shimizu |
890ddd |
the user by accessing the proxy's built-in mutex.
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
120a6e |
\warning TGLDisplayListsManager relies on the user to attach a context to the
|
|
Shinya Kitaoka |
120a6e |
\b correct
|
|
Toshihiro Shimizu |
890ddd |
display lists id.
|
|
Toshihiro Shimizu |
890ddd |
*/
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
d1f6c4 |
class DVAPI TGLDisplayListsManager final : public tcg::notifier<> {
|
|
Toshihiro Shimizu |
890ddd |
public:
|
|
Shinya Kitaoka |
120a6e |
struct Observer : public tcg::observer<tgldisplaylistsmanager> {</tgldisplaylistsmanager>
|
|
Shinya Kitaoka |
120a6e |
virtual void onDisplayListDestroyed(int dlSpaceId) = 0;
|
|
Shinya Kitaoka |
120a6e |
};
|
|
Toshihiro Shimizu |
890ddd |
|
|
Toshihiro Shimizu |
890ddd |
public:
|
|
Shinya Kitaoka |
120a6e |
static TGLDisplayListsManager *instance();
|
|
Shinya Kitaoka |
120a6e |
|
|
Shinya Kitaoka |
120a6e |
int storeProxy(TGLDisplayListsProxy *proxy); //!< Stores the specified proxy,
|
|
Shinya Kitaoka |
38fd86 |
//! returning its associated
|
|
Shinya Kitaoka |
38fd86 |
//! display
|
|
Shinya Kitaoka |
120a6e |
//!< lists id. Context attaches should follow.
|
|
Shinya Kitaoka |
120a6e |
void attachContext(int dlSpaceId, TGlContext context); //!< Attaches the
|
|
Shinya Kitaoka |
38fd86 |
//! specified context
|
|
Shinya Kitaoka |
38fd86 |
//! to a display lists
|
|
Shinya Kitaoka |
38fd86 |
//! space
|
|
Shinya Kitaoka |
120a6e |
void releaseContext(TGlContext context); //!< Releases a context reference to
|
|
Shinya Kitaoka |
38fd86 |
//! its display lists space
|
|
Shinya Kitaoka |
120a6e |
int displayListsSpaceId(TGlContext context); //!< Returns the display lists
|
|
Shinya Kitaoka |
38fd86 |
//! space id of a known context,
|
|
Shinya Kitaoka |
38fd86 |
//! or
|
|
Shinya Kitaoka |
120a6e |
//!< -1 if it did not attach to any known space.
|
|
Shinya Kitaoka |
120a6e |
TGLDisplayListsProxy *dlProxy(int dlSpaceId); //!< Returns the display lists
|
|
Shinya Kitaoka |
38fd86 |
//! space proxy associated to
|
|
Shinya Kitaoka |
38fd86 |
//! the
|
|
Shinya Kitaoka |
38fd86 |
//!< specified id.
|
|
Toshihiro Shimizu |
890ddd |
};
|
|
Toshihiro Shimizu |
890ddd |
|
|
Shinya Kitaoka |
120a6e |
#endif // TGLDISPLAYLISTSMANAGER_H
|