OpenGLContext.hxx

Go to the documentation of this file.

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */
 
#pragma once
 
#include <vcl/dllapi.h>
#include <vcl/sysdata.hxx>
#include <vcl/vclptr.hxx>
#include <rtl/ref.hxx>
 
class Point;
class Size;
class SystemChildWindow;
namespace vcl { class Window; }
 
struct VCL_DLLPUBLIC GLWindow
{
    unsigned int            Width;
    unsigned int            Height;
    bool bMultiSampleSupported;
 
    GLWindow()
        : Width(0)
        , Height(0)
        , bMultiSampleSupported(false)
    {
    }
 
    virtual bool Synchronize(bool bOnoff) const;
 
    virtual ~GLWindow();
};
 
class VCL_DLLPUBLIC OpenGLContext
{
    friend class OpenGLTests;
protected:
    OpenGLContext();
public:
    static rtl::Reference<OpenGLContext> Create();
    virtual ~OpenGLContext();
 
    // Avoid implicitly defined copy constructors/assignments for the DLLPUBLIC class (they may
    // require forward-declared classes used internally to be defined in places using OpenGLContext)
    OpenGLContext(const OpenGLContext&) = delete;
    OpenGLContext(OpenGLContext&&) = delete;
    OpenGLContext& operator=(const OpenGLContext&) = delete;
    OpenGLContext& operator=(OpenGLContext&&) = delete;
 
    void acquire() { mnRefCount++; }
    void release() { if ( --mnRefCount == 0 ) delete this; }
    void dispose();
 
    void requestLegacyContext();
 
    bool init(vcl::Window* pParent);
 
    void reset();
 
    virtual bool isCurrent();
    virtual bool isAnyCurrent();
    static void clearCurrent();
    static void prepareForYield();
    static bool hasCurrent();
 
    virtual void makeCurrent();
    void registerAsCurrent();
    virtual void resetCurrent();
    virtual void restoreDefaultFramebuffer();
    virtual void swapBuffers();
    virtual void sync();
    void show();
 
    void setWinPosAndSize(const Point &rPos, const Size& rSize);
    virtual const GLWindow& getOpenGLWindow() const = 0;
 
    SystemChildWindow* getChildWindow();
    const SystemChildWindow* getChildWindow() const;
 
    bool isInitialized() const
    {
        return mbInitialized;
    }
 
    virtual SystemWindowData generateWinData(vcl::Window* pParent, bool bRequestLegacyContext);
 
private:
    virtual void initWindow();
    virtual void destroyCurrentContext();
    virtual void adjustToNewSize();
 
protected:
    bool InitGL();
    static void InitGLDebugging();
    static void InitChildWindow(SystemChildWindow *pChildWindow);
    static void BuffersSwapped();
    virtual GLWindow& getModifiableOpenGLWindow() = 0;
    virtual bool ImplInit();
 
    VclPtr<vcl::Window> m_xWindow;
    VclPtr<vcl::Window> mpWindow; //points to m_pWindow or the parent window, don't delete it
    VclPtr<SystemChildWindow> m_pChildWindow;
    bool mbInitialized;
    int  mnRefCount;
    bool mbRequestLegacyContext;
 
public:
 
    // Don't hold references to ourselves:
    OpenGLContext *mpPrevContext;
    OpenGLContext *mpNextContext;
};
 
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */