Crazy Eddie's GUI System  0.8.5
CEGUI::DirectFBTexture Class Reference

Implementation of CEGUI::Texture interface using DirectFB. More...

+ Inheritance diagram for CEGUI::DirectFBTexture:
+ Collaboration diagram for CEGUI::DirectFBTexture:

Public Member Functions

IDirectFBSurface * getDirectFBSurface () const
 Return a pointer to the IDirectFBSurface this texture represents.
 
const StringgetName () const
 Returns the name given to the texture when it was created. More...
 
const SizefgetSize () const
 Returns the current pixel size of the texture. More...
 
const SizefgetOriginalDataSize () const
 Returns the original pixel size of the data loaded into the texture. More...
 
const Vector2fgetTexelScaling () const
 Returns pixel to texel scale values that should be used for converting pixel values to texture co-ords. More...
 
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. More...
 
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. More...
 
void blitFromMemory (const void *sourceData, const Rectf &area)
 Performs an area memory blit to the texture. More...
 
void blitToMemory (void *targetData)
 Performs a complete blit from the texture surface to memory. More...
 
bool isPixelFormatSupported (const PixelFormat fmt) const
 Return whether the specified pixel format is supported by the system for the CEGUI::Texture implementation. More...
 
- Public Member Functions inherited from CEGUI::Texture
virtual ~Texture ()
 Destructor for Texture base class.
 

Protected Member Functions

 DirectFBTexture (IDirectFB &directfb, const String &name)
 Basic constructor.
 
 DirectFBTexture (IDirectFB &directfb, const String &name, const String &filename, const String &resourceGroup)
 Construct texture from file.
 
 DirectFBTexture (IDirectFB &directfb, const String &name, const Sizef &size)
 Construct texture with given size.
 
 ~DirectFBTexture ()
 Destructor.
 
void cleanupDirectFBTexture ()
 clean up the internal texture.
 
void updateCachedScaleValues ()
 updates cached scale value used to map pixels to texture co-ords.
 

Protected Attributes

IDirectFB & d_directfb
 DirectFB interface we were given when constructed.
 
IDirectFBSurface * d_texture
 surface representing the texture.
 
Sizef d_size
 Size of the texture.
 
Sizef d_dataSize
 original pixel of size data loaded into texture
 
Vector2f d_texelScaling
 cached pixel to texel mapping scale values.
 
const String d_name
 The name given for this texture.
 

Friends

TextureDirectFBRenderer::createTexture (const String &)
 
TextureDirectFBRenderer::createTexture (const String &, const String &, const String &)
 
TextureDirectFBRenderer::createTexture (const String &, const Sizef &)
 
void DirectFBRenderer::destroyTexture (const String &)
 

Additional Inherited Members

- Public Types inherited from CEGUI::Texture
enum  PixelFormat {
  PF_RGB, PF_RGBA, PF_RGBA_4444, PF_RGB_565,
  PF_PVRTC2, PF_PVRTC4, PF_RGB_DXT1, PF_RGBA_DXT1,
  PF_RGBA_DXT3, PF_RGBA_DXT5
}
 Enumerated type containing the supported pixel formats that can be passed to loadFromMemory. More...
 

Detailed Description

Implementation of CEGUI::Texture interface using DirectFB.

Member Function Documentation

void CEGUI::DirectFBTexture::blitFromMemory ( const void *  sourceData,
const Rectf area 
)
virtual

Performs an area memory blit to the texture.

Parameters
sourceDatainput data, the size must match area described by the given Rect
areaarea where the blit will happen
Note
The pixel format must match current Texture's pixel format!

Implements CEGUI::Texture.

void CEGUI::DirectFBTexture::blitToMemory ( void *  targetData)
virtual

Performs a complete blit from the texture surface to memory.

Parameters
targetDatathe buffer where the target is stored
Note
You have to (correctly) preallocate the target buffer!

Implements CEGUI::Texture.

const String& CEGUI::DirectFBTexture::getName ( ) const
virtual

Returns the name given to the texture when it was created.

Returns
Reference to a String object that holds the name of the texture.

Implements CEGUI::Texture.

const Sizef& CEGUI::DirectFBTexture::getOriginalDataSize ( ) const
virtual

Returns the original pixel size of the data loaded into the texture.

Returns
reference to a Size object that describes the original size, in pixels, of the data loaded into the texture.

Implements CEGUI::Texture.

const Sizef& CEGUI::DirectFBTexture::getSize ( ) const
virtual

Returns the current pixel size of the texture.

Returns
Reference to a Size object that describes the size of the texture in pixels.

Implements CEGUI::Texture.

const Vector2f& CEGUI::DirectFBTexture::getTexelScaling ( ) const
virtual

Returns pixel to texel scale values that should be used for converting pixel values to texture co-ords.

Returns
Reference to a Vector2 object that describes the scaling values required to accurately map pixel positions to texture co-ordinates.

Implements CEGUI::Texture.

bool CEGUI::DirectFBTexture::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.

Note
Whether the CEGUI system as a whole will make use of support for any given pixel format will depend upon that format being recognised and supported by both the renderer module implementation and the ImageCodec module that is used to load texture data.
Parameters
fmtOne of the PixelFormat enumerated values specifying the pixel format that is to be tested.
Returns
  • true if the specified PixelFormat is supported.
  • false if the specified PixelFormat is not supported.

Implements CEGUI::Texture.

void CEGUI::DirectFBTexture::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.

Parameters
filenameThe filename of the image file that is to be loaded into the texture
resourceGroupResource group identifier to be passed to the resource provider when loading the image file.
Returns
Nothing.

Implements CEGUI::Texture.

void CEGUI::DirectFBTexture::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.

Parameters
bufferPointer to the buffer containing the image data.
buffer_sizeSize of the buffer (in pixels as specified by pixelFormat)
pixel_formatPixelFormat value describing the format contained in buffPtr.
Returns
Nothing.

Implements CEGUI::Texture.