Constructor.

Destructor.

Adds animated texture group. Use this method to inform texture manager that when texture is loaded, it's allowed to use previous state of the group. Each texture id should belong at most to one group. This method should be called before using these texture ids to load textures.

Informs the texture manager that time has progressed. The manager will update any animated textures.

Appends a texture to the texture manager's list of managed textures. Ownership of the texture is transferred to the manager; when the manager is destroyed, the texture will be destroyed, too.

Second-phase constructor.

Returns the blank texture. This can be used as a dummy texture if no real texture is available.

Returns the blank texture. This can be used as a dummy texture if no real texture is available. Will generate the blank texture if the texture is not yet available.

Cancels the scheduled or ongoing loading of a texture. If the texture is found from load queue it is immediately removed from the queue. If the removed texture was being loaded at the time this method is called the loading is cancelled and restarted from the next unloaded texture.

Check the existence of a texture.

Check the existence of a texture.

Clears texture changed flags.

Creates animation state.

Creates a texture by calling the ProvideBitmapL method of the passed MHuiBitmapProvider .

If a texture with the given id is already created or loaded the previously existing texture is returned. If texture with the given id has been unloaded with UnloadTexture() method then the id is reused by loading a new texture on the id.

If EHuiTextureFlagAllowDirectBitmapUsage flag is used, the provided bitmaps should be in the preferred format. That can be found using CHuiDisplay::GetPreferredTextureFormats(). Also the bitmaps shall not be compressed or have duplicated handle.

Creates a texture from the given CFbsBitmap and its mask bitmap. This is a synchronous method call and will result in consequent call of TextureLoadingCompleted of all observers if the texture creation was successful. As filename cannot be acquired for created textures the user provided string will be used. Note that the filename has to be unique for all textures. Textures are identified by their filename and if a texture with existing filename is loaded / created then already loaded / created texture will be returned instead of creating a new texture.

Define (register) a texture resource (filename/path) for a texture id. Enables calling the LoadTextureL only with an id. This resource will then be loaded when LoadTextureL is called with the id.

Cancel active object operation.

Unloads a texture having given index in the texture array (iTextures).

Enables (or disables) texture autosize calculations.

Sets a flag if texture memory usage calculation should be done and printed.

Determines the environment the manager belongs to.

Estimated mem usage for textures assuming that textures which have pixel content are using given amount of memory per pixel.

Finds animation state owned by aGroupId.

Finds group id by texture id.

Returns the file server session that should be used by the manager.

Called when an image has finished loading. Handles uploading of the loaded bitmap to the texture.

Called when a sub-image has been loaded (before calling ImageLoadingCompleteL ). This method checks if we need to continue loading.

Returns the current image path. LoadTexture() Call to load textures from this location.

Returns true if the given texture is still in the load queue.

Returns true if the given texture is still in the load queue.

Checks if a texture exists, has content and is not found from the texture load queue.

Mainly meant for file-based textures to check if the texture is ready to be used.

Note that textures may have some temporary placeholder content already before they have been fully loaded!

For CreateTextureL -based textures it is recommended to use CHuiTexture::HasContent() directly.

LoadTextureL() CreateTextureL() CHuiTexture::HasContent()

Checks if a texture exists, has content and is not found from the texture load queue.

Mainly meant for file-based textures to check if the texture is ready to be used.

Note that textures may have some temporary placeholder content already before they have been fully loaded!

For CreateTextureL -based textures it is recommended to use CHuiTexture::HasContent() directly.

LoadTextureL() CreateTextureL() CHuiTexture::HasContent()

Checks if a texture exists, has content and is not found from the texture load queue.

Mainly meant for file-based textures to check when the texture is ready to be used.

Note that textures may have some temporary placeholder content already before they have been fully loaded!

For CreateTextureL -based textures it is recommended to use CHuiTexture::HasContent() directly.

LoadTextureL() CreateTextureL() CHuiTexture::HasContent()

Returns the number of images waiting to be loaded.

Loads an image and makes it a texture. The bitmap files are searched in the path specified with SetImagePathL. The format of the loaded image must be supported by the system (Series 60) codecs.

LoadTextureL is an asynchronous method, which returns an empty texture which is loaded and filled in the background. Register an MHuiTextureLoadingCompletedObserver instance to the iLoadedObservers array, whose TextureLoadingCompleted() method will be called when textures finish loading. The same observer is also called if an error occurs during the loading process. The other method is to check if an image has been loaded with TextureManagers IsLoaded() .

If a texture with the given id or filename is already loaded the previously loaded texture is returned. If texture with the given id has been unloaded with UnloadTexture() method then the id is reused by loading a new texture on the id.

Loads an image based on pre-registered id and file name.

DefineFileName()LoadTextureL is an asynchronous method, which returns an empty texture which is loaded and filled in the background. Register an MHuiTextureLoadingCompletedObserver instance to the iLoadedObservers array, whose TextureLoadingCompleted() method will be called when textures finish loading. The same observer is also called if an error occurs during the loading process. The other method is to check if an image has been loaded with TextureManagers IsLoaded() .

If a texture with the given id or filename is already loaded the previously loaded texture is returned. If texture with the given id has been unloaded with UnloadTexture() method then the id is reused by loading a new texture on the id.

SetImagePathL() To set the image search path. Set to "" to use absolute image filenames. iLoadObservers MHuiTextureLoadingCompletedObserver::TextureLoadingCompleted() IsLoaded()

Loads an image and makes it a texture. The bitmap files are searched in the path specified with SetImagePathL. The format of the loaded image must be supported by the system (Series 60) codecs.

LoadTextureL is an asynchronous method, which returns an empty texture which is loaded and filled in the background. Register an MHuiTextureLoadingCompletedObserver instance to the iLoadedObservers array, whose TextureLoadingCompleted() method will be called when textures finish loading. The same observer is also called if an error occurs during the loading process. The other method is to check if an image has been loaded with TextureManagers IsLoaded() .

If a texture with the given id or filename is already loaded the previously loaded texture is returned. If texture with the given id has been unloaded with UnloadTexture() method then the id is reused by loading a new texture on the id.

Permanent registration entry for textures.

Checks if animation state is needed.

Releases and restores skin dependent textures. Usually called after system skin has been changed.

Helper method that notifies observers of texture manager state change. iStateObservers

Helper method that notifies observers of texture load completion. iLoadObservers

Cleans up the topmost load queue entry and removes it from the load queue. Deletes the decoder, but not the loaded texture entry.

Prepends the image path to the beginning of the file name, if necessary.

Processes animated frame.

Returns a reference to the texture processor.

Releases texture manager resources. Releases all textures. Called when the render plugin is released.

While the release operation is in progress, it is not possible to delete CHuiTexture instances or create new ones. After the release has been completed, textures can again be deleted and created.

Removes animated texture group.

Removes animation state.

Removes a texture from management. The texture's ownership is transferred to the caller.

Restores texture manager resources. Restores the content of all textures released in Release() . Called when render plugin restored.

While the restore operation is in progress, it is not possible to delete CHuiTexture instances or create new ones. After the restore has been completed, textures can again be deleted and created.

Handles a leave occurring in the request completion event handler RunL() .

Called when image loading (decoding) operation is complete.

Sets a flag that indicates that there are changed textures.

Sets the path where bitmaps are loaded from. If drive is not included, tries to resolver that using CCoeEnv

LoadTexture() Call to load textures from this location.

Sets the texture processor of the manager. Ownership of the processor is given to the manager.

Iterates through the managed textures to find aTexture, and then assigns it a new ID of aId.

Starts loading next images from the load queue. If scheduling a queue entry fails for some reason, the entry is discarded and the next queue entry is processed.

Returns the state of the texture manager.

Retuns a texture having given id. Will return a blank texture if the id was not found. With this method there is a danger of editing the blank texture instead of the real texture you intended to edit.

Retuns a texture having given id. Will return a default blank texture if the id was not found.

Returns a texture entry.

Returns the number of texture entries.

Returns a texture associated with the given id. Will leave if no associated texture exists. If the texture is defined using the DefineFileNameL but the texture data is not yet loaded then this method call will result in LoadTextureL call.

Provides expandability, helps keeping the binary compatibility. Since virtual table is now exported and this class is dll derivable and the implementation is more difficult to change, hence this method, which can provide additional extension APIs.

Unloads a texture from memory.

Unloads a texture from memory.

This method releases the texture id and image name for reusing. LoadTexture().

Update texture flags if needed.

Update the texture content by calling the ProvideBitmapL method for the existing provider. Also a new provider can be given as a parameter. The texture must exist prior calling this method.

If EHuiTextureFlagAllowDirectBitmapUsage flag is used, the provided bitmaps should be in the preferred format. That can be found using CHuiDisplay::GetPreferredTextureFormats(). Also the bitmaps shall not be compressed or have duplicated handle.

States of a CHuiTextureManager object.

Array of animated texture group items.

Animated textures.

Animation state that does not belong to any group. Own.

Array of animation states. Own.

Bitmap for loading asynchronously into.

Empty texture that is returned if an invalid image is specified.

To do texture memory usage calculation and print it as info messages

Environment.

Open file server session for image loading.

Counter for generating new font identifiers.

Flag to optimize changed texture lookup

Path where image files are loaded from.

Observers that are notified loaded textures of the manager. Applications may directly add and remove their own observers using this public property.

Queue of loading tasks.

This variable tells whether there has been a valid texture in the load queue that we have started to load in the current texture load loop. This variable indicates that we have started to load at least one texture during the load loop.

Mask bitmap for loading alpha channels.

Texture processor instance.

State of the release/restore process.

State of the texture manager.

Observers that are notified of changes in the state of the manager. Applications may directly add and remove their own observers using this public property.

Observers that are notified when toolkit notices a change in texture auto size e.g. it is now being drawn as different size than before. Observers are notified possibly between every frame, they should handle notifications as quickly as possible.

Flag to tell wheter texture autosizing is enabled

Registry of all textures within this toolkit. Accessed by texture ids (iId) or texture filenames (iFileName). Members may be NULL if a texture is not loaded.