1fb9f6f13a
The main advantage of SPDX license identifiers over the traditional license headers is that it's more difficult to overlook inappropriate licenses for kwin, for example GPL 3. We also don't have to copy a lot of boilerplate text. In order to create this change, I ran licensedigger -r -c from the toplevel source directory.
150 lines
3.9 KiB
C++
150 lines
3.9 KiB
C++
/********************************************************************
|
|
KWin - the KDE window manager
|
|
This file is part of the KDE project.
|
|
|
|
SPDX-FileCopyrightText: 2006-2007 Rivo Laks <rivolaks@hot.ee>
|
|
SPDX-FileCopyrightText: 2010, 2011 Martin Gräßlin <mgraesslin@kde.org>
|
|
|
|
SPDX-License-Identifier: GPL-2.0-or-later
|
|
*********************************************************************/
|
|
|
|
#ifndef KWIN_GLTEXTURE_H
|
|
#define KWIN_GLTEXTURE_H
|
|
|
|
#include <kwinglutils_export.h>
|
|
|
|
#include <QSize>
|
|
#include <QRegion>
|
|
#include <QSharedPointer>
|
|
#include <QExplicitlySharedDataPointer>
|
|
#include <QMatrix4x4>
|
|
|
|
#include <epoxy/gl.h>
|
|
|
|
class QImage;
|
|
class QPixmap;
|
|
|
|
/** @addtogroup kwineffects */
|
|
/** @{ */
|
|
|
|
namespace KWin
|
|
{
|
|
|
|
class GLVertexBuffer;
|
|
class GLTexturePrivate;
|
|
|
|
enum TextureCoordinateType {
|
|
NormalizedCoordinates = 0,
|
|
UnnormalizedCoordinates
|
|
};
|
|
|
|
class KWINGLUTILS_EXPORT GLTexture
|
|
{
|
|
public:
|
|
GLTexture();
|
|
GLTexture(const GLTexture& tex);
|
|
explicit GLTexture(const QImage& image, GLenum target = GL_TEXTURE_2D);
|
|
explicit GLTexture(const QPixmap& pixmap, GLenum target = GL_TEXTURE_2D);
|
|
explicit GLTexture(const QString& fileName);
|
|
GLTexture(GLenum internalFormat, int width, int height, int levels = 1, bool needsMutability = false);
|
|
explicit GLTexture(GLenum internalFormat, const QSize &size, int levels = 1, bool needsMutability = false);
|
|
|
|
/**
|
|
* Create a GLTexture wrapper around an existing texture.
|
|
* Management of the underlying texture remains the responsibility of the caller.
|
|
* @since 5.18
|
|
*/
|
|
explicit GLTexture(GLuint textureId, GLenum internalFormat, const QSize &size, int levels = 1);
|
|
virtual ~GLTexture();
|
|
|
|
GLTexture & operator = (const GLTexture& tex);
|
|
|
|
bool isNull() const;
|
|
QSize size() const;
|
|
int width() const;
|
|
int height() const;
|
|
/**
|
|
* @since 4.7
|
|
*/
|
|
bool isYInverted() const;
|
|
/**
|
|
* @since 4.8
|
|
*/
|
|
void setYInverted(bool inverted);
|
|
|
|
/**
|
|
* Specifies which component of a texel is placed in each respective
|
|
* component of the vector returned to the shader.
|
|
*
|
|
* Valid values are GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_ONE and GL_ZERO.
|
|
*
|
|
* @see swizzleSupported()
|
|
* @since 5.2
|
|
*/
|
|
void setSwizzle(GLenum red, GLenum green, GLenum blue, GLenum alpha);
|
|
|
|
/**
|
|
* Returns a matrix that transforms texture coordinates of the given type,
|
|
* taking the texture target and the y-inversion flag into account.
|
|
*
|
|
* @since 4.11
|
|
*/
|
|
QMatrix4x4 matrix(TextureCoordinateType type) const;
|
|
|
|
void update(const QImage& image, const QPoint &offset = QPoint(0, 0), const QRect &src = QRect());
|
|
virtual void discard();
|
|
void bind();
|
|
void unbind();
|
|
void render(const QRegion ®ion, const QRect& rect, bool hardwareClipping = false);
|
|
|
|
GLuint texture() const;
|
|
GLenum target() const;
|
|
GLenum filter() const;
|
|
GLenum internalFormat() const;
|
|
|
|
QImage toImage() const;
|
|
|
|
/** @short
|
|
* Make the texture fully transparent
|
|
*/
|
|
void clear();
|
|
bool isDirty() const;
|
|
void setFilter(GLenum filter);
|
|
void setWrapMode(GLenum mode);
|
|
void setDirty();
|
|
|
|
void generateMipmaps();
|
|
|
|
static bool framebufferObjectSupported();
|
|
|
|
/**
|
|
* Returns true if texture swizzle is supported, and false otherwise
|
|
*
|
|
* Texture swizzle requires OpenGL 3.3, GL_ARB_texture_swizzle, or OpenGL ES 3.0.
|
|
*
|
|
* @since 5.2
|
|
*/
|
|
static bool supportsSwizzle();
|
|
|
|
/**
|
|
* Returns @c true if texture formats R* are supported, and @c false otherwise.
|
|
*
|
|
* This requires OpenGL 3.0, GL_ARB_texture_rg or OpenGL ES 3.0 or GL_EXT_texture_rg.
|
|
*
|
|
* @since 5.2.1
|
|
*/
|
|
static bool supportsFormatRG();
|
|
|
|
protected:
|
|
QExplicitlySharedDataPointer<GLTexturePrivate> d_ptr;
|
|
GLTexture(GLTexturePrivate& dd);
|
|
|
|
private:
|
|
Q_DECLARE_PRIVATE(GLTexture)
|
|
};
|
|
|
|
} // namespace
|
|
|
|
/** @} */
|
|
|
|
#endif
|