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(USE_QT6)
#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(USE_QT6)
class RE_GLContext : public QOpenGLContext
{
public:
    RE_GLContext() :
        myDrawable(nullptr)
    {}

    ~RE_GLContext() override {}

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

private:
    RE_GLDrawable *myDrawable;
};
#endif


/// GL drawable.
/// It's basically a plain Qt widget that manages a GL context.
class RE_API RE_GLDrawable : public QWidget
{
public:
    RE_GLDrawable(const QSurfaceFormat &format);
    RE_GLDrawable(
        const QSurfaceFormat &format, QWidget *parent, 
        QOpenGLContext *sharedContext);
    ~RE_GLDrawable() override;

#if defined(USE_QT6)
    QOpenGLContext *context() { return myContext.get(); }
#else
    RE_GLContext *context() { return &myContext; }
#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:
#if defined(USE_QT6)
    void init_(
        const QSurfaceFormat *format, QOpenGLContext *shared_context=nullptr);
#else
    void init_();
#endif

#if defined(USE_QT6)
    UT_UniquePtr<QOpenGLContext> myContext;
#else
    RE_GLContext myContext;
#endif
};


#endif // __RE_GLDRAWABLE_H_INCLUDED__