RE_GLDrawable.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * NAME:        RE_GLDrawable.h (RE Library, C++)
 *
 * COMMENTS:
 */

#ifndef __RE_GLDRAWABLE_H_INCLUDED__
#define __RE_GLDRAWABLE_H_INCLUDED__

#include "RE_API.h"

// We must include this before the Qt OpenGL headers in order to ensure the
// correct linkage on Windows.
#include "RE_OGL.h"

#if defined(EXPERIMENTAL_GL_DRAWABLE_FEEL)
#include <UT/UT_UniquePtr.h>
#endif

#include <QtGui/QOpenGLContext>
#include <QtWidgets/QWidget>
#undef emit


// Object names for QWidget and QWindow (drawable surface) objects used
// for OpenGL rendering.  Note that the drawable surface name must be exactly
// equal to the drawable name plus "Window" as the suffix.  This is a
// restriction of the QWidgetWindow class.
#define RE_GL_DRAWABLE_OBJ_NAME "RE_GLDrawable"
#define RE_GL_DRAWABLE_SURFACE_OBJ_NAME RE_GL_DRAWABLE_OBJ_NAME "Window"

#define RE_GL_DRAWABLE_WRAPPER_OBJ_NAME RE_GL_DRAWABLE_OBJ_NAME "Wrapper"


class QSurfaceFormat;

class RE_GLDrawable;
#if defined(EXPERIMENTAL_GL_DRAWABLE_FEEL)
class RE_Render;
class RE_Visual;
#endif


class RE_GLContext : public QOpenGLContext
{
public:
#if !defined(EXPERIMENTAL_GL_DRAWABLE_FEEL)
    RE_GLContext() :
        myDrawable(nullptr)
    {}
#else
    RE_GLContext(
        const QSurfaceFormat &format, QOpenGLContext *shared_context=nullptr) 
        : myDrawable(nullptr)
    {
        setFormat(format);
        if (shared_context)
            setShareContext(shared_context);
    }
#endif

    ~RE_GLContext() override {}

    RE_GLDrawable *drawable() const { return myDrawable; }
    void setDrawable(RE_GLDrawable *drawable) { myDrawable = drawable; }

private:
    RE_GLDrawable *myDrawable;
};

/// GL drawable for Qt5.
/// It's basically a plain Qt widget that manages a GL context.
class RE_API RE_GLDrawable : public QWidget
{
public:
#if !defined(EXPERIMENTAL_GL_DRAWABLE_FEEL)
    RE_GLDrawable(const QSurfaceFormat &format);
    RE_GLDrawable(
        const QSurfaceFormat &format, QWidget *parent, 
        QOpenGLContext *sharedContext);
#else
    RE_GLDrawable(
        RE_Visual *visual, QWidget *parent=nullptr, bool is_main=false);
#endif
    ~RE_GLDrawable() override;

#if defined(EXPERIMENTAL_GL_DRAWABLE_FEEL)
    RE_Visual *getVisual() { return myVisual; }
    RE_Render *getRender() { return myRender.get(); }
#endif

#if !defined(EXPERIMENTAL_GL_DRAWABLE_FEEL)
    RE_GLContext *context() { return &myContext; }
#endif

#if defined(EXPERIMENTAL_GL_DRAWABLE_FEEL)
    bool isQuadBufferStereo() const;
#endif

    QPaintEngine *paintEngine() const override { return nullptr; };
    static const char *widgetTag() { return RE_GL_DRAWABLE_OBJ_NAME; }

    /// Return the string tag used to identify whether a QWindow
    /// is used a drawable surface for Houdini.
    static const char * drawableSurfaceTag() 
        { return RE_GL_DRAWABLE_SURFACE_OBJ_NAME; }

    /// Return the string tag used to identify whether a QWidget
    /// is the wrapper widget of a GL drawable in Houdini.
    static const char *widgetWrapperTag()
        { return RE_GL_DRAWABLE_WRAPPER_OBJ_NAME; }

protected:
    void paintEvent(QPaintEvent *event) override;
    void resizeEvent(QResizeEvent *event) override;
    void mousePressEvent(QMouseEvent *event) override;

private:
    void init_();

#if !defined(EXPERIMENTAL_GL_DRAWABLE_FEEL)
    RE_GLContext myContext;
#else
    UT_UniquePtr<RE_Render> myRender;
    RE_Visual *myVisual;
#endif
};


#endif // __RE_GLDRAWABLE_H_INCLUDED__