kwin/libkwineffects/kwingltexture.h
Fredrik Höglund 450be6a378 Add a levels parameter to the GLTexture ctor
Prior to this commit we didn't know if mipmaps were going to be used
when we created the GL texture, which meant that we couldn't tell the
driver whether to allocate storage for mipmaps or not.

This resulted in one of two things happening depending on the driver;
either it would allocate storage for mipmaps that in most cases would
never be used, or it wouldn't and would later be forced to reallocate
the texture when mipmaps were added.

By adding this parameter we can now explicitly tell the driver how
many mipmap levels will be used.

The parameter is only added to the non-image constructor for now. The
image constructor is changed to only allocate a single level, which
matches how textures created from images are used in kwin. This may
need to be revisited in the future.
2014-12-14 18:33:52 +01:00

120 lines
3.2 KiB
C++

/********************************************************************
KWin - the KDE window manager
This file is part of the KDE project.
Copyright (C) 2006-2007 Rivo Laks <rivolaks@hot.ee>
Copyright (C) 2010, 2011 Martin Gräßlin <mgraesslin@kde.org>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*********************************************************************/
#ifndef KWIN_GLTEXTURE_H
#define KWIN_GLTEXTURE_H
#include <kwinglutils_export.h>
#include <QSize>
#include <QRegion>
#include <QSharedPointer>
#include <QExplicitlySharedDataPointer>
#include <QtGui/QMatrix4x4>
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(int width, int height, int levels = 1);
explicit GLTexture(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);
/**
* 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(QRegion region, const QRect& rect, bool hardwareClipping = false);
GLuint texture() const;
GLenum target() const;
GLenum filter() const;
/** @short
* Make the texture fully transparent
* Warning: this clobbers the current framebuffer binding except on fglrx
*/
void clear();
bool isDirty() const;
void setFilter(GLenum filter);
void setWrapMode(GLenum mode);
void setDirty();
void generateMipmaps();
static bool framebufferObjectSupported();
protected:
QExplicitlySharedDataPointer<GLTexturePrivate> d_ptr;
GLTexture(GLTexturePrivate& dd);
private:
Q_DECLARE_PRIVATE(GLTexture)
};
} // namespace
/** @} */
#endif