virtual bool Map(ImageData* pdata, unsigned mipLevel, unsigned levelCount);
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 |
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). |
Returns true if the texture contents are mapped; false otherwise.