TextureImage::Map

TextureImage::Map
virtual bool Map(ImageData* pdata, unsigned mipLevel, unsigned levelCount);
Description

Map maps texture contents to user memory and enables the mipmap levels to be accessible in the system memory. 

TextureImage mapping should only be allowed in single-threaded rendering environments, in which case ImageUse_MapLocal is set. Such mapping may, for example, be possible on PSP. Note that if mapping is necessary on threaded platforms, Image::Create will create RawImage with an attached texture instead. 

Parameters
Parameters 
Description 
ImageData* pdata 
The destination image that receives the texture data. 
unsigned mipLevel 
An unsigned integer specifying which mip level should be used. For single data plane images with mipmaps, the top level is 0. 
unsigned levelCount 
An unsigned integer specifying which levels should be mapped (0 means all levels). 
Return Value

Returns true if the texture contents are mapped; false otherwise.