Crazy Eddie's GUI System
0.8.4
|
Texture implementation for the OpenGLRenderer. More...
Public Member Functions | |
void | setOpenGLTexture (GLuint tex, const Sizef &size) |
set the openGL texture that this Texture is based on to the specified texture, with the specified size. | |
GLuint | getOpenGLTexture () const |
Return the internal OpenGL texture id used by this Texture object. | |
void | setTextureSize (const Sizef &sz) |
set the size of the internal texture. | |
void | grabTexture () |
Grab the texture to a local buffer. | |
void | restoreTexture () |
Restore the texture from the locally buffered copy previously create by a call to grabTexture. | |
const String & | getName () const |
Returns the name given to the texture when it was created. | |
const Sizef & | getSize () const |
Returns the current pixel size of the texture. | |
const Sizef & | getOriginalDataSize () const |
Returns the original pixel size of the data loaded into the texture. | |
const Vector2f & | getTexelScaling () const |
Returns pixel to texel scale values that should be used for converting pixel values to texture co-ords. | |
void | loadFromFile (const String &filename, const String &resourceGroup) |
Loads the specified image file into the texture. The texture is resized as required to hold the image. | |
void | loadFromMemory (const void *buffer, const Sizef &buffer_size, PixelFormat pixel_format) |
Loads (copies) an image in memory into the texture. The texture is resized as required to hold the image. | |
void | blitFromMemory (const void *sourceData, const Rectf &area) |
Performs an area memory blit to the texture. | |
void | blitToMemory (void *targetData) |
Performs a complete blit from the texture surface to memory. | |
bool | isPixelFormatSupported (const PixelFormat fmt) const |
Return whether the specified pixel format is supported by the system for the CEGUI::Texture implementation. | |
Protected Member Functions | |
OpenGLTexture (OpenGLRendererBase &owner, const String &name) | |
Basic constructor. | |
OpenGLTexture (OpenGLRendererBase &owner, const String &name, const String &filename, const String &resourceGroup) | |
Constructor that creates a Texture from an image file. | |
OpenGLTexture (OpenGLRendererBase &owner, const String &name, const Sizef &size) | |
Constructor that creates a Texture with a given size. | |
OpenGLTexture (OpenGLRendererBase &owner, const String &name, GLuint tex, const Sizef &size) | |
Constructor that wraps an existing GL texture. | |
virtual | ~OpenGLTexture () |
Destructor. | |
void | generateOpenGLTexture () |
generate the OpenGL texture and set some initial options. | |
void | updateCachedScaleValues () |
updates cached scale value used to map pixels to texture co-ords. | |
void | cleanupOpenGLTexture () |
clean up the GL texture, or the grab buffer if it had been grabbed | |
void | initInternalPixelFormatFields (const PixelFormat fmt) |
initialise the internal format flags for the given CEGUI::PixelFormat. | |
void | setTextureSize_impl (const Sizef &sz) |
internal texture resize function (does not reset format or other fields) | |
void | loadUncompressedTextureBuffer (const Rectf &dest_area, const GLvoid *buffer) const |
void | loadCompressedTextureBuffer (const Rectf &dest_area, const GLvoid *buffer) const |
GLsizei | getCompressedTextureSize (const Sizef &pixel_size) const |
Protected Attributes | |
GLuint | d_ogltexture |
The OpenGL texture we're wrapping. | |
Sizef | d_size |
Size of the texture. | |
uint8 * | d_grabBuffer |
cached image data for restoring the texture. | |
Sizef | d_dataSize |
original pixel of size data loaded into texture | |
Vector2f | d_texelScaling |
cached pixel to texel mapping scale values. | |
OpenGLRendererBase & | d_owner |
OpenGLRenderer that created and owns this OpenGLTexture. | |
const String | d_name |
The name given for this texture. | |
GLenum | d_format |
Texture format. | |
GLenum | d_subpixelFormat |
Texture subpixel format. | |
bool | d_isCompressed |
Whether Texture format is a compressed format. | |
Friends | |
Texture & | OpenGLRendererBase::createTexture (const String &) |
Texture & | OpenGLRendererBase::createTexture (const String &, const String &, const String &) |
Texture & | OpenGLRendererBase::createTexture (const String &, const Sizef &) |
Texture & | OpenGLRendererBase::createTexture (const String &, GLuint, const Sizef &) |
void | OpenGLRendererBase::destroyTexture (Texture &) |
void | OpenGLRendererBase::destroyTexture (const String &) |
Texture implementation for the OpenGLRenderer.
void CEGUI::OpenGLTexture::blitFromMemory | ( | const void * | sourceData, |
const Rectf & | area | ||
) | [virtual] |
Performs an area memory blit to the texture.
sourceData | input data, the size must match area described by the given Rect |
area | area where the blit will happen |
Implements CEGUI::Texture.
void CEGUI::OpenGLTexture::blitToMemory | ( | void * | targetData | ) | [virtual] |
Performs a complete blit from the texture surface to memory.
targetData | the buffer where the target is stored |
Implements CEGUI::Texture.
const String& CEGUI::OpenGLTexture::getName | ( | ) | const [virtual] |
Returns the name given to the texture when it was created.
Implements CEGUI::Texture.
GLuint CEGUI::OpenGLTexture::getOpenGLTexture | ( | ) | const |
Return the internal OpenGL texture id used by this Texture object.
const Sizef& CEGUI::OpenGLTexture::getOriginalDataSize | ( | ) | const [virtual] |
Returns the original pixel size of the data loaded into the texture.
Implements CEGUI::Texture.
const Sizef& CEGUI::OpenGLTexture::getSize | ( | ) | const [virtual] |
Returns the current pixel size of the texture.
Implements CEGUI::Texture.
const Vector2f& CEGUI::OpenGLTexture::getTexelScaling | ( | ) | const [virtual] |
Returns pixel to texel scale values that should be used for converting pixel values to texture co-ords.
Implements CEGUI::Texture.
void CEGUI::OpenGLTexture::grabTexture | ( | ) |
Grab the texture to a local buffer.
This will destroy the OpenGL texture, and restoreTexture must be called before using it again.
bool CEGUI::OpenGLTexture::isPixelFormatSupported | ( | const PixelFormat | fmt | ) | const [virtual] |
Return whether the specified pixel format is supported by the system for the CEGUI::Texture implementation.
The result of this call will vary according to the implementaion API and the capabilities of the hardware.
fmt | One of the PixelFormat enumerated values specifying the pixel format that is to be tested. |
Implements CEGUI::Texture.
void CEGUI::OpenGLTexture::loadFromFile | ( | const String & | filename, |
const String & | resourceGroup | ||
) | [virtual] |
Loads the specified image file into the texture. The texture is resized as required to hold the image.
filename | The filename of the image file that is to be loaded into the texture |
resourceGroup | Resource group identifier to be passed to the resource provider when loading the image file. |
Implements CEGUI::Texture.
void CEGUI::OpenGLTexture::loadFromMemory | ( | const void * | buffer, |
const Sizef & | buffer_size, | ||
PixelFormat | pixel_format | ||
) | [virtual] |
Loads (copies) an image in memory into the texture. The texture is resized as required to hold the image.
buffer | Pointer to the buffer containing the image data. |
buffer_size | Size of the buffer (in pixels as specified by pixelFormat) |
pixel_format | PixelFormat value describing the format contained in buffPtr. |
Implements CEGUI::Texture.
void CEGUI::OpenGLTexture::setTextureSize | ( | const Sizef & | sz | ) |
set the size of the internal texture.
sz | size for the internal texture, in pixels. |
RendererException | thrown if the hardware is unable to support a texture large enough to fulfill the requested size. |