Pyrogenesis
trunk
|
Represents a texture object. More...
#include <TextureManager.h>
Public Member Functions | |
~CTexture () | |
size_t | GetWidth () const |
Returns the width (in pixels) of the current texture. More... | |
size_t | GetHeight () const |
Returns the height (in pixels) of the current texture. More... | |
bool | HasAlpha () const |
Returns whether the current texture has an alpha channel. More... | |
u32 | GetBaseColor () const |
Returns the ARGB value of the lowest mipmap level (i.e. More... | |
size_t | GetUploadedSize () const |
Returns total number of bytes uploaded for this texture. More... | |
void | Bind (size_t unit=0) |
Bind the texture to the given GL texture unit. More... | |
Handle | GetHandle () |
Returns a ogl_tex handle, for later binding. More... | |
bool | TryLoad () |
Attempt to load the texture data quickly, as with Bind(). More... | |
bool | IsLoaded () |
Returns whether the texture data is currently loaded. More... | |
void | Prefetch () |
Activate the prefetching optimisation for this texture. More... | |
Private Types | |
enum | { UNLOADED, PREFETCH_NEEDS_LOADING, PREFETCH_NEEDS_CONVERTING, PREFETCH_IS_CONVERTING, HIGH_NEEDS_CONVERTING, HIGH_IS_CONVERTING, LOADED } |
Private Member Functions | |
CTexture (Handle handle, const CTextureProperties &props, CTextureManagerImpl *textureManager) | |
NONCOPYABLE (CTexture) | |
void | SetHandle (Handle handle, bool takeOwnership=false) |
Replace the Handle stored by this object. More... | |
Private Attributes | |
const CTextureProperties | m_Properties |
Handle | m_Handle |
u32 | m_BaseColor |
enum CTexture:: { ... } | m_State |
CTextureManagerImpl * | m_TextureManager |
std::weak_ptr< CTexture > | m_Self |
Friends | |
class | CTextureManagerImpl |
struct | TextureCacheCmp |
struct | TPequal_to |
struct | TPhash |
Represents a texture object.
The texture data may or may not have been loaded yet. Before it has been loaded, all operations will act on a default 1x1-pixel grey texture instead.
|
private |
|
explicitprivate |
CTexture::~CTexture | ( | ) |
void CTexture::Bind | ( | size_t | unit = 0 | ) |
Bind the texture to the given GL texture unit.
If the texture data hasn't been loaded yet, this may wait a short while to load it. If loading takes too long then it will return sooner and the data will be loaded in a background thread, so this does not guarantee the texture really will be loaded.
u32 CTexture::GetBaseColor | ( | ) | const |
Returns the ARGB value of the lowest mipmap level (i.e.
the average of the whole texture). Returns 0 if the texture has no mipmaps.
Handle CTexture::GetHandle | ( | ) |
Returns a ogl_tex handle, for later binding.
See comments from Bind().
size_t CTexture::GetHeight | ( | ) | const |
Returns the height (in pixels) of the current texture.
size_t CTexture::GetUploadedSize | ( | ) | const |
Returns total number of bytes uploaded for this texture.
size_t CTexture::GetWidth | ( | ) | const |
Returns the width (in pixels) of the current texture.
bool CTexture::HasAlpha | ( | ) | const |
Returns whether the current texture has an alpha channel.
bool CTexture::IsLoaded | ( | ) |
Returns whether the texture data is currently loaded.
|
private |
void CTexture::Prefetch | ( | ) |
Activate the prefetching optimisation for this texture.
Use this if it is likely the texture will be needed in the near future. It will be loaded in the background so that it is likely to be ready when it is used by Bind().
|
private |
Replace the Handle stored by this object.
If takeOwnership is true, it will not increment the Handle's reference count.
bool CTexture::TryLoad | ( | ) |
Attempt to load the texture data quickly, as with Bind().
Returns whether the texture data is currently loaded.
|
friend |
|
friend |
|
friend |
|
friend |
|
private |
|
private |
|
private |
|
private |
enum { ... } CTexture::m_State |
|
private |