mirror of https://github.com/mosra/magnum.git
Vladimír Vondruš
15 years ago
5 changed files with 301 additions and 232 deletions
@ -0,0 +1,48 @@ |
|||||||
|
/*
|
||||||
|
Copyright © 2010, 2011 Vladimír Vondruš <mosra@centrum.cz> |
||||||
|
|
||||||
|
This file is part of Magnum. |
||||||
|
|
||||||
|
Magnum is free software: you can redistribute it and/or modify |
||||||
|
it under the terms of the GNU Lesser General Public License version 3 |
||||||
|
only, as published by the Free Software Foundation. |
||||||
|
|
||||||
|
Magnum 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 Lesser General Public License version 3 for more details. |
||||||
|
*/ |
||||||
|
|
||||||
|
#include "AbstractTexture.h" |
||||||
|
|
||||||
|
namespace Magnum { |
||||||
|
|
||||||
|
/* Check correctness of binary OR in setMinificationFilter(). If nobody fucks
|
||||||
|
anything up, this assert should produce the same results on all dimensions, |
||||||
|
thus testing only on AbstractTexture. */ |
||||||
|
static_assert(((AbstractTexture::NearestNeighborFilter|AbstractTexture::BaseMipLevel) == GL_NEAREST) && |
||||||
|
((AbstractTexture::NearestNeighborFilter|AbstractTexture::NearestMipLevel) == GL_NEAREST_MIPMAP_NEAREST) && |
||||||
|
((AbstractTexture::NearestNeighborFilter|AbstractTexture::LinearMipInterpolation) == GL_NEAREST_MIPMAP_LINEAR) && |
||||||
|
((AbstractTexture::LinearFilter|AbstractTexture::BaseMipLevel) == GL_LINEAR) && |
||||||
|
((AbstractTexture::LinearFilter|AbstractTexture::NearestMipLevel) == GL_LINEAR_MIPMAP_NEAREST) && |
||||||
|
((AbstractTexture::LinearFilter|AbstractTexture::LinearMipInterpolation) == GL_LINEAR_MIPMAP_LINEAR), |
||||||
|
"Unsupported constants for GL texture filtering"); |
||||||
|
|
||||||
|
void AbstractTexture::setMinificationFilter(Filter filter, Mipmap mipmap) { |
||||||
|
/* Only base mip level is supported on rectangle textures */ |
||||||
|
if(target == GL_TEXTURE_RECTANGLE) mipmap = BaseMipLevel; |
||||||
|
|
||||||
|
bind(); |
||||||
|
glTexParameteri(target, GL_TEXTURE_MIN_FILTER, filter|mipmap); |
||||||
|
unbind(); |
||||||
|
} |
||||||
|
|
||||||
|
void AbstractTexture::generateMipmap() { |
||||||
|
if(target == GL_TEXTURE_RECTANGLE) return; |
||||||
|
|
||||||
|
bind(); |
||||||
|
glGenerateMipmap(target); |
||||||
|
unbind(); |
||||||
|
} |
||||||
|
|
||||||
|
} |
||||||
@ -0,0 +1,249 @@ |
|||||||
|
#ifndef Magnum_AbstractTexture_h |
||||||
|
#define Magnum_AbstractTexture_h |
||||||
|
/*
|
||||||
|
Copyright © 2010, 2011 Vladimír Vondruš <mosra@centrum.cz> |
||||||
|
|
||||||
|
This file is part of Magnum. |
||||||
|
|
||||||
|
Magnum is free software: you can redistribute it and/or modify |
||||||
|
it under the terms of the GNU Lesser General Public License version 3 |
||||||
|
only, as published by the Free Software Foundation. |
||||||
|
|
||||||
|
Magnum 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 Lesser General Public License version 3 for more details. |
||||||
|
*/ |
||||||
|
|
||||||
|
/** @file
|
||||||
|
* @brief Class Magnum::AbstractTexture |
||||||
|
*/ |
||||||
|
|
||||||
|
#include "Magnum.h" |
||||||
|
#include "TypeTraits.h" |
||||||
|
|
||||||
|
namespace Magnum { |
||||||
|
|
||||||
|
/**
|
||||||
|
@brief Non-templated base for Texture |
||||||
|
|
||||||
|
See Texture documentation for more information. |
||||||
|
*/ |
||||||
|
class AbstractTexture { |
||||||
|
public: |
||||||
|
/** @brief Texture filtering */ |
||||||
|
enum Filter { |
||||||
|
/**
|
||||||
|
* Nearest neighbor filtering |
||||||
|
*/ |
||||||
|
NearestNeighborFilter = GL_NEAREST, |
||||||
|
|
||||||
|
/**
|
||||||
|
* Linear filtering |
||||||
|
*/ |
||||||
|
LinearFilter = GL_LINEAR |
||||||
|
}; |
||||||
|
|
||||||
|
/** @brief Mip level selection */ |
||||||
|
enum Mipmap { |
||||||
|
/**
|
||||||
|
* Select base mip level |
||||||
|
*/ |
||||||
|
BaseMipLevel = GL_NEAREST & ~GL_NEAREST, |
||||||
|
|
||||||
|
/**
|
||||||
|
* Select nearest mip level. Unavailable on rectangle textures. |
||||||
|
*/ |
||||||
|
NearestMipLevel = GL_NEAREST_MIPMAP_NEAREST & ~GL_NEAREST, |
||||||
|
|
||||||
|
/**
|
||||||
|
* Linear interpolation of nearest mip levels. Unavailable on |
||||||
|
* rectangle textures. |
||||||
|
*/ |
||||||
|
LinearMipInterpolation = GL_NEAREST_MIPMAP_LINEAR & ~GL_NEAREST |
||||||
|
}; |
||||||
|
|
||||||
|
/** @brief Texture wrapping on the edge */ |
||||||
|
enum Wrapping { |
||||||
|
/**
|
||||||
|
* Repeat texture. Unavailable on rectangle textures. |
||||||
|
*/ |
||||||
|
Repeat = GL_REPEAT, |
||||||
|
|
||||||
|
/**
|
||||||
|
* Repeat mirrored texture. Unavailable on rectangle textures. |
||||||
|
*/ |
||||||
|
MirroredRepeat = GL_MIRRORED_REPEAT, |
||||||
|
|
||||||
|
/**
|
||||||
|
* Clamp to edge. Coordinates out of the range will be clamped to |
||||||
|
* first / last column / row in given direction. |
||||||
|
*/ |
||||||
|
ClampToEdge = GL_CLAMP_TO_EDGE, |
||||||
|
|
||||||
|
/**
|
||||||
|
* Clamp to border color. Coordinates out of range will be clamped |
||||||
|
* to border color (set with setBorderColor()). |
||||||
|
*/ |
||||||
|
ClampToBorder = GL_CLAMP_TO_BORDER |
||||||
|
}; |
||||||
|
|
||||||
|
/** @brief Internal format */ |
||||||
|
enum InternalFormat { |
||||||
|
CompressedRed = GL_COMPRESSED_RED, |
||||||
|
CompressedRedGreen = GL_COMPRESSED_RG, |
||||||
|
CompressedRGB = GL_COMPRESSED_RGB, |
||||||
|
CompressedRGBA = GL_COMPRESSED_RGBA |
||||||
|
}; |
||||||
|
|
||||||
|
/** @brief Color format */ |
||||||
|
enum ColorFormat { |
||||||
|
Red = GL_RED, |
||||||
|
RedGreen = GL_RG, |
||||||
|
RGB = GL_RGB, |
||||||
|
RGBA = GL_RGBA, |
||||||
|
BGR = GL_BGR, |
||||||
|
BGRA = GL_BGRA |
||||||
|
}; |
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Constructor |
||||||
|
* @param target Target, e.g. @c GL_TEXTURE_2D. |
||||||
|
* |
||||||
|
* Creates one OpenGL texture. |
||||||
|
*/ |
||||||
|
inline AbstractTexture(GLenum target): target(target) { |
||||||
|
glGenTextures(1, &texture); |
||||||
|
} |
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Destructor |
||||||
|
* |
||||||
|
* Deletes assigned OpenGL texture. |
||||||
|
*/ |
||||||
|
inline virtual ~AbstractTexture() { |
||||||
|
glDeleteTextures(1, &texture); |
||||||
|
} |
||||||
|
|
||||||
|
/** @brief Bind texture for usage / rendering */ |
||||||
|
inline void bind() const { |
||||||
|
glBindTexture(target, texture); |
||||||
|
} |
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Unbind texture |
||||||
|
* |
||||||
|
* @note Unbinds any texture from given dimension, not only this |
||||||
|
* particular one. |
||||||
|
*/ |
||||||
|
inline void unbind() const { |
||||||
|
glBindTexture(target, 0); |
||||||
|
} |
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Set minification filter |
||||||
|
* @param filter Filter |
||||||
|
* @param mipmap Mipmap filtering. If set to anything else than |
||||||
|
* BaseMipLevel, make sure textures for all mip levels are set or |
||||||
|
* call generateMipmap(). |
||||||
|
* |
||||||
|
* Sets filter used when the object pixel size is smaller than the |
||||||
|
* texture size. For rectangle textures only some modes are supported, |
||||||
|
* see @ref AbstractTexture::Filter "Filter" and |
||||||
|
* @ref AbstractTexture::Mipmap "Mipmap" documentation for more |
||||||
|
* information. |
||||||
|
* @attention This and setMagnificationFilter() must be called after |
||||||
|
* creating the texture, otherwise it will be unusable. |
||||||
|
*/ |
||||||
|
void setMinificationFilter(Filter filter, Mipmap mipmap = BaseMipLevel); |
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Set magnification filter |
||||||
|
* @param filter Filter |
||||||
|
* |
||||||
|
* Sets filter used when the object pixel size is larger than largest |
||||||
|
* texture size. |
||||||
|
* @attention This and setMinificationFilter() must be called after |
||||||
|
* creating the texture, otherwise it will be unusable. |
||||||
|
*/ |
||||||
|
inline void setMagnificationFilter(Filter filter) { |
||||||
|
bind(); |
||||||
|
glTexParameteri(target, GL_TEXTURE_MAG_FILTER, filter); |
||||||
|
unbind(); |
||||||
|
} |
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Set border color |
||||||
|
* |
||||||
|
* Border color when @ref AbstractTexture::Wrapping "wrapping" is set |
||||||
|
* to @c ClampToBorder. |
||||||
|
*/ |
||||||
|
inline void setBorderColor(const Vector4& color) { |
||||||
|
bind(); |
||||||
|
glTexParameterfv(target, GL_TEXTURE_BORDER_COLOR, color.data()); |
||||||
|
unbind(); |
||||||
|
} |
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Generate mipmap |
||||||
|
* |
||||||
|
* Does nothing on rectangle textures. |
||||||
|
* @see setMinificationFilter() |
||||||
|
*/ |
||||||
|
void generateMipmap(); |
||||||
|
|
||||||
|
protected: |
||||||
|
const GLenum target; /**< @brief Texture target */ |
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Helper for setting texture data |
||||||
|
* |
||||||
|
* Workaround for partial template specialization. |
||||||
|
*/ |
||||||
|
template<class T, size_t textureDimensions> struct DataHelper { |
||||||
|
#ifdef DOXYGEN_GENERATING_OUTPUT |
||||||
|
/**
|
||||||
|
* @brief Set texture data |
||||||
|
* @param target Target, such as @c GL_TEXTURE_RECTANGLE |
||||||
|
* @param mipLevel Mip level |
||||||
|
* @param internalFormat Internal texture format. One value from |
||||||
|
* @ref AbstractTexture::InternalFormat "InternalFormat" or |
||||||
|
* @ref AbstractTexture::ColorFormat "ColorFormat" enum. |
||||||
|
* @param dimensions %Texture dimensions |
||||||
|
* @param colorFormat Color format of passed data. Data size |
||||||
|
* per color channel is detected from format of passed data |
||||||
|
* array. |
||||||
|
* @param data %Texture data |
||||||
|
* |
||||||
|
* Calls @c glTexImage1D, @c glTexImage2D, @c glTexImage3D depending |
||||||
|
* on dimension count. |
||||||
|
*/ |
||||||
|
inline void operator()(GLenum target, GLint mipLevel, int internalFormat, const Math::Vector<GLsizei, textureDimensions>& dimensions, ColorFormat colorFormat, const T* data); |
||||||
|
#endif |
||||||
|
}; |
||||||
|
|
||||||
|
#ifndef DOXYGEN_GENERATING_OUTPUT |
||||||
|
template<class T> struct DataHelper<T, 1> { |
||||||
|
inline void operator()(GLenum target, GLint mipLevel, int internalFormat, const Math::Vector<GLsizei, 1>& dimensions, ColorFormat colorFormat, const T* data) { |
||||||
|
glTexImage1D(target, mipLevel, internalFormat, dimensions.at(0), 0, colorFormat, TypeTraits<T>::glType(), data); |
||||||
|
} |
||||||
|
}; |
||||||
|
template<class T> struct DataHelper<T, 2> { |
||||||
|
inline void operator()(GLenum target, GLint mipLevel, int internalFormat, const Math::Vector<GLsizei, 2>& dimensions, ColorFormat colorFormat, const T* data) { |
||||||
|
glTexImage2D(target, mipLevel, internalFormat, dimensions.at(0), dimensions.at(1), 0, colorFormat, TypeTraits<T>::glType(), data); |
||||||
|
} |
||||||
|
}; |
||||||
|
template<class T> struct DataHelper<T, 3> { |
||||||
|
inline void operator()(GLenum target, GLint mipLevel, int internalFormat, const Math::Vector<GLsizei, 3>& dimensions, ColorFormat colorFormat, const T* data) { |
||||||
|
glTexImage3D(target, mipLevel, internalFormat, dimensions.at(0), dimensions.at(1), dimensions.at(2), 0, colorFormat, TypeTraits<T>::glType(), data); |
||||||
|
} |
||||||
|
}; |
||||||
|
#endif |
||||||
|
|
||||||
|
private: |
||||||
|
GLuint texture; |
||||||
|
}; |
||||||
|
|
||||||
|
} |
||||||
|
|
||||||
|
#endif |
||||||
Loading…
Reference in new issue