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