TGLContext.cxx

Go to the documentation of this file.

// @(#)root/gl:$Id$
// Author:  Timur Pocheptsov, Jun 2007
 
/*************************************************************************
 * Copyright (C) 1995-2004, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/
 
#include <memory>
#include <stdexcept>
#include <algorithm>
#include <memory>
 
#include "TVirtualX.h"
#include "GuiTypes.h"
#include "TString.h"
#include "TError.h"
 
#include "TROOT.h"
#include "TVirtualMutex.h"
 
#include "TGLContextPrivate.h"
#include "RConfigure.h"
#include "TGLIncludes.h"
#include "TGLContext.h"
#include "TGLWidget.h"
#include "TGLFormat.h"
#include "TGLUtil.h"
 
#include "TGLFontManager.h"
 
/** \class TGLContext
\ingroup opengl
This class encapsulates window-system specific information about a
GL-context and alows their proper management in ROOT.
*/
 
ClassImp(TGLContext);
 
Bool_t TGLContext::fgGlewInitDone = kFALSE;
 
////////////////////////////////////////////////////////////////////////////////
/// TGLContext ctor "from" TGLWidget.
/// Is shareDefault is true, the shareList is set from default
/// context-identity. Otherwise the given shareList is used (can be
/// null).
/// Makes thread switching.
 
TGLContext::TGLContext(TGLWidget *wid, Bool_t shareDefault,
                       const TGLContext *shareList)
   : fDevice(wid),
     fFromCtor(kTRUE),
     fValid(kFALSE),
     fIdentity(nullptr)
{
   if (shareDefault)
      shareList = TGLContextIdentity::GetDefaultContextAny();
 
   if (!gVirtualX->IsCmdThread()) {
      gROOT->ProcessLineFast(Form("((TGLContext *)0x%zx)->SetContext((TGLWidget *)0x%zx, (TGLContext *)0x%zx)",
                                  (size_t)this, (size_t)wid, (size_t)shareList));
   } else {
 
      R__LOCKGUARD(gROOTMutex);
 
      SetContext(wid, shareList);
   }
 
   if (shareDefault)
      fIdentity = TGLContextIdentity::GetDefaultIdentity();
   else
      fIdentity = shareList ? shareList->GetIdentity() : new TGLContextIdentity;
 
   fIdentity->AddRef(this);
 
   fFromCtor = kFALSE;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Initialize GLEW - static private function.
/// Called immediately after creation of the first GL context.
 
void TGLContext::GlewInit()
{
   if (!fgGlewInitDone)
   {
      GLenum status = glewInit();
      if (status != GLEW_OK)
         Warning("TGLContext::GlewInit", "GLEW initalization failed.");
      else if (gDebug > 0)
         Info("TGLContext::GlewInit", "GLEW initalization successful.");
      fgGlewInitDone = kTRUE;
   }
}
 
//==============================================================================
#ifdef WIN32
//==============================================================================
 
namespace {
 
   struct LayoutCompatible_t {
      void          *fDummy0;
      void          *fDummy1;
      HWND          *fPHwnd;
      unsigned char  fDummy2;
      unsigned       fDummy3;
      unsigned short fDummy4;
      unsigned short fDummy5;
      void          *fDummy6;
      unsigned       fDummy7:2;
   };
 
}
 
////////////////////////////////////////////////////////////////////////////////
///WIN32 gl-context creation. Defined as a member-function (this code removed from ctor)
///to make WIN32/X11 separation cleaner.
///This function is public only for calls via gROOT and called from ctor.
 
void TGLContext::SetContext(TGLWidget *widget, const TGLContext *shareList)
{
   if (!fFromCtor) {
      Error("TGLContext::SetContext", "SetContext must be called only from ctor");
      return;
   }
 
   fPimpl.reset(new TGLContextPrivate);
   LayoutCompatible_t *trick =
      reinterpret_cast<LayoutCompatible_t *>(widget->GetId());
   HWND hWND = *trick->fPHwnd;
   HDC  hDC  = GetWindowDC(hWND);
 
   if (!hDC) {
      Error("TGLContext::SetContext", "GetWindowDC failed");
      throw std::runtime_error("GetWindowDC failed");
   }
 
   const Rgl::TGuardBase &dcGuard = Rgl::make_guard(ReleaseDC, hWND, hDC);
   if (HGLRC glContext = wglCreateContext(hDC)) {
      if (shareList && !wglShareLists(shareList->fPimpl->fGLContext, glContext)) {
         wglDeleteContext(glContext);
         Error("TGLContext::SetContext", "Context sharing failed!");
         throw std::runtime_error("Context sharing failed");
      }
      fPimpl->fHWND = hWND;
      fPimpl->fHDC = hDC;
      fPimpl->fGLContext = glContext;
   } else {
      Error("TGLContext::SetContext", "wglCreateContext failed");
      throw std::runtime_error("wglCreateContext failed");
   }
 
   //Register context for "parent" gl-device.
   fValid = kTRUE;
   fDevice->AddContext(this);
   TGLContextPrivate::RegisterContext(this);
 
   dcGuard.Stop();
}
 
////////////////////////////////////////////////////////////////////////////////
///If context is valid (TGLPaintDevice, for which context was created still exists),
///make it current.
 
Bool_t TGLContext::MakeCurrent()
{
   if (!fValid) {
      Error("TGLContext::MakeCurrent", "This context is invalid.");
      return kFALSE;
   }
 
   if (!gVirtualX->IsCmdThread())
      return Bool_t(gROOT->ProcessLineFast(Form("((TGLContext *)0x%zx)->MakeCurrent()", (size_t)this)));
   else {
 
      R__LOCKGUARD(gROOTMutex);
 
      Bool_t rez = wglMakeCurrent(fPimpl->fHDC, fPimpl->fGLContext);
      if (rez) {
         if (!fgGlewInitDone)
            GlewInit();
         fIdentity->DeleteGLResources();
      }
      return rez;
   }
}
 
////////////////////////////////////////////////////////////////////////////////
///Reset current context.
 
Bool_t TGLContext::ClearCurrent()
{
   return wglMakeCurrent(0, 0);
}
 
////////////////////////////////////////////////////////////////////////////////
///If context is valid (TGLPaintDevice, for which context was created still exists),
///swap buffers (in case of P-buffer call glFinish()).
 
void TGLContext::SwapBuffers()
{
   if (!fValid) {
      Error("TGLContext::SwapBuffers", "This context is invalid.");
      return;
   }
 
   if (!gVirtualX->IsCmdThread())
      gROOT->ProcessLineFast(Form("((TGLContext *)0x%zx)->SwapBuffers()", (size_t)this));
   else {
 
      R__LOCKGUARD(gROOTMutex);
 
      if (fPimpl->fHWND)
         wglSwapLayerBuffers(fPimpl->fHDC, WGL_SWAP_MAIN_PLANE);
      else
         glFinish();
   }
}
 
////////////////////////////////////////////////////////////////////////////////
///Make the context invalid and (do thread switch, if needed)
///free resources.
 
void TGLContext::Release()
{
   if (!gVirtualX->IsCmdThread()) {
      gROOT->ProcessLineFast(Form("((TGLContext *)0x%zx)->Release()", (size_t)this));
      return;
   }
 
   R__LOCKGUARD(gROOTMutex);
 
   if (fPimpl->fHWND)
      ReleaseDC(fPimpl->fHWND, fPimpl->fHDC);
 
   TGLContextPrivate::RemoveContext(this);
   wglDeleteContext(fPimpl->fGLContext);
   fValid = kFALSE;
}
 
#elif defined(R__HAS_COCOA)
 
////////////////////////////////////////////////////////////////////////////////
///This function is public only for calls via gROOT and called from ctor.
 
void TGLContext::SetContext(TGLWidget *widget, const TGLContext *shareList)
{
   if (!fFromCtor) {
      Error("TGLContext::SetContext", "SetContext must be called only from ctor");
      return;
   }
 
   fPimpl.reset(new TGLContextPrivate);
 
   fPimpl->fGLContext = gVirtualX->CreateOpenGLContext(widget->GetId(), shareList ? shareList->fPimpl->fGLContext : 0);
   fPimpl->fWindowID = widget->GetId();
 
   fValid = kTRUE;
   fDevice->AddContext(this);
   TGLContextPrivate::RegisterContext(this);
}
 
////////////////////////////////////////////////////////////////////////////////
///If context is valid (TGLPaintDevice, for which context was created still exists),
///make it current.
 
Bool_t TGLContext::MakeCurrent()
{
   if (!fValid) {
      Error("TGLContext::MakeCurrent", "This context is invalid.");
      return kFALSE;
   }
 
   const Bool_t rez = gVirtualX->MakeOpenGLContextCurrent(fPimpl->fGLContext, fPimpl->fWindowID);
   if (rez) {
      if (!fgGlewInitDone)
         GlewInit();
      fIdentity->DeleteGLResources();
 
   }
 
   return rez;
}
 
////////////////////////////////////////////////////////////////////////////////
///Reset current context.
 
Bool_t TGLContext::ClearCurrent()
{
   return kFALSE;
}
 
////////////////////////////////////////////////////////////////////////////////
///If context is valid (TGLPaintDevice, for which context was created still exists),
///swap buffers (in case of P-buffer call glFinish()).
 
void TGLContext::SwapBuffers()
{
   if (!fValid) {
      Error("TGLContext::SwapBuffers", "This context is invalid.");
      return;
   }
 
   gVirtualX->FlushOpenGLBuffer(fPimpl->fGLContext);
}
 
////////////////////////////////////////////////////////////////////////////////
///Make the context invalid and free resources.
 
void TGLContext::Release()
{
   TGLContextPrivate::RemoveContext(this);
   gVirtualX->DeleteOpenGLContext(fPimpl->fGLContext);
   fValid = kFALSE;
}
 
//==============================================================================
#else // X11
//==============================================================================
 
////////////////////////////////////////////////////////////////////////////////
///X11 gl-context creation. Defined as a member-function (this code removed from ctor)
///to make WIN32/X11 separation cleaner.
///This function is public only for calls via gROOT and called from ctor.
 
void TGLContext::SetContext(TGLWidget *widget, const TGLContext *shareList)
{
   if (!fFromCtor) {
      Error("TGLContext::SetContext", "SetContext must be called only from ctor");
      return;
   }
 
   fPimpl = std::make_unique<TGLContextPrivate>();
   Display *dpy = static_cast<Display *>(widget->GetInnerData().first);
   XVisualInfo *visInfo = static_cast<XVisualInfo *>(widget->GetInnerData().second);
 
   GLXContext glCtx = shareList ? glXCreateContext(dpy, visInfo, shareList->fPimpl->fGLContext, True)
                                : glXCreateContext(dpy, visInfo, None, True);
 
   if (!glCtx) {
      Error("TGLContext::SetContext", "glXCreateContext failed!");
      throw std::runtime_error("glXCreateContext failed!");
   }
 
   fPimpl->fDpy = dpy;
   fPimpl->fVisualInfo = visInfo;
   fPimpl->fGLContext = glCtx;
   fPimpl->fWindowID = widget->GetId();
 
   fValid = kTRUE;
   fDevice->AddContext(this);
   TGLContextPrivate::RegisterContext(this);
}
 
////////////////////////////////////////////////////////////////////////////////
///If context is valid (TGLPaintDevice, for which context was created still exists),
///make it current.
 
Bool_t TGLContext::MakeCurrent()
{
   if (!fValid) {
      Error("TGLContext::MakeCurrent", "This context is invalid.");
      return kFALSE;
   }
 
   if (fPimpl->fWindowID != 0) {
      const Bool_t rez = glXMakeCurrent(fPimpl->fDpy, fPimpl->fWindowID,
                                        fPimpl->fGLContext);
      if (rez) {
         if (!fgGlewInitDone)
            GlewInit();
         fIdentity->DeleteGLResources();
      }
      return rez;
   }
 
   return kFALSE;
}
 
////////////////////////////////////////////////////////////////////////////////
///Reset current context.
 
Bool_t TGLContext::ClearCurrent()
{
   return glXMakeCurrent(fPimpl->fDpy, None, nullptr);
}
 
////////////////////////////////////////////////////////////////////////////////
///If context is valid (TGLPaintDevice, for which context was created still exists),
///swap buffers (in case of P-buffer call glFinish()).
 
void TGLContext::SwapBuffers()
{
   if (!fValid) {
      Error("TGLContext::SwapCurrent", "This context is invalid.");
      return;
   }
 
   if (fPimpl->fWindowID != 0)
      glXSwapBuffers(fPimpl->fDpy, fPimpl->fWindowID);
   else
      glFinish();
}
 
////////////////////////////////////////////////////////////////////////////////
///Make the context invalid and (do thread switch, if needed)
///free resources.
 
void TGLContext::Release()
{
   TGLContextPrivate::RemoveContext(this);
   glXDestroyContext(fPimpl->fDpy, fPimpl->fGLContext);
   fValid = kFALSE;
}
 
//==============================================================================
#endif
//==============================================================================
 
////////////////////////////////////////////////////////////////////////////////
///TGLContext dtor. If it's called before TGLPaintDevice's dtor
///(context is valid) resource will be freed and context
///un-registered.
 
TGLContext::~TGLContext()
{
   if (fValid) {
      Release();
      fDevice->RemoveContext(this);
   }
 
   fIdentity->Release(this);
}
 
////////////////////////////////////////////////////////////////////////////////
///We can have several shared contexts,
///and gl-scene wants to know, if some context
///(defined by its identity) can be used.
 
TGLContextIdentity *TGLContext::GetIdentity()const
{
   return fIdentity;
}
 
////////////////////////////////////////////////////////////////////////////////
///Ask TGLContextPrivate to lookup context in its internal map.
 
TGLContext *TGLContext::GetCurrent()
{
   return TGLContextPrivate::GetCurrentContext();
}
 
 
/** \class TGLContextIdentity
\ingroup opengl
Identifier of a shared GL-context.
Objects shared among GL-contexts include:
display-list definitions, texture objects and shader programs.
*/
 
ClassImp(TGLContextIdentity);
 
TGLContextIdentity* TGLContextIdentity::fgDefaultIdentity = new TGLContextIdentity;
 
////////////////////////////////////////////////////////////////////////////////
/// Constructor.
 
TGLContextIdentity::TGLContextIdentity():
fFontManager(nullptr), fCnt(0), fClientCnt(0)
{
}
 
////////////////////////////////////////////////////////////////////////////////
/// Destructor.
 
TGLContextIdentity::~TGLContextIdentity()
{
   if (fFontManager) delete fFontManager;
}
 
////////////////////////////////////////////////////////////////////////////////
///Add context ctx to the list of references.
 
void TGLContextIdentity::AddRef(TGLContext* ctx)
{
   ++fCnt;
   fCtxs.push_back(ctx);
}
 
////////////////////////////////////////////////////////////////////////////////
///Remove context ctx from the list of references.
 
void TGLContextIdentity::Release(TGLContext* ctx)
{
   CtxList_t::iterator i = std::find(fCtxs.begin(), fCtxs.end(), ctx);
   if (i != fCtxs.end())
   {
      fCtxs.erase(i);
      --fCnt;
      CheckDestroy();
   }
   else
   {
      Error("TGLContextIdentity::Release", "unregistered context.");
   }
}
 
////////////////////////////////////////////////////////////////////////////////
///Remember dl range for deletion in next MakeCurrent or dtor execution.
 
void TGLContextIdentity::RegisterDLNameRangeToWipe(UInt_t base, Int_t size)
{
   fDLTrash.push_back(DLRange_t(base, size));
}
 
////////////////////////////////////////////////////////////////////////////////
///Delete GL resources registered for destruction.
 
void TGLContextIdentity::DeleteGLResources()
{
   if (!fDLTrash.empty())
   {
      for (DLTrashIt_t it = fDLTrash.begin(), e = fDLTrash.end(); it != e; ++it)
         glDeleteLists(it->first, it->second);
      fDLTrash.clear();
   }
 
   if (fFontManager)
      fFontManager->ClearFontTrash();
}
 
////////////////////////////////////////////////////////////////////////////////
///Find identitfy of current context. Static.
 
TGLContextIdentity* TGLContextIdentity::GetCurrent()
{
   TGLContext* ctx = TGLContext::GetCurrent();
   return ctx ? ctx->GetIdentity() : nullptr;
}
 
////////////////////////////////////////////////////////////////////////////////
///Get identity of a default Gl context. Static.
 
TGLContextIdentity* TGLContextIdentity::GetDefaultIdentity()
{
   if (fgDefaultIdentity == nullptr)
      fgDefaultIdentity = new TGLContextIdentity;
   return fgDefaultIdentity;
}
 
////////////////////////////////////////////////////////////////////////////////
///Get the first GL context with the default identity.
///Can return zero, but that's OK, too. Static.
 
TGLContext* TGLContextIdentity::GetDefaultContextAny()
{
   if (fgDefaultIdentity == nullptr || fgDefaultIdentity->fCtxs.empty())
      return nullptr;
   return fgDefaultIdentity->fCtxs.front();
}
 
////////////////////////////////////////////////////////////////////////////////
///Get the free-type font-manager associated with this context-identity.
 
TGLFontManager* TGLContextIdentity::GetFontManager()
{
   if(!fFontManager) fFontManager = new TGLFontManager();
   return fFontManager;
}
 
////////////////////////////////////////////////////////////////////////////////
///Private function called when reference count is reduced.
 
void TGLContextIdentity::CheckDestroy()
{
   if (fCnt <= 0 && fClientCnt <= 0)
   {
      if (this == fgDefaultIdentity)
         fgDefaultIdentity = nullptr;
      delete this;
   }
}