kmuCreateTwiddledTexture
Converts KAMUI Bit Map Format to Twiddled Format
Description:
This function converts a texture in KM_TEXTURE_BMP format (ABGR8888) in main memory into a texture in Twiddled/Twiddled Mipmap format. If TRUE is specified for bAutoMipMap, a mipmap is created automatically. If TRUE is specified for bDither, dither is effected.
Caution:
The contents of the input texture data are destroyed if mipmap or dither is specified.
Parameters:
pOutputTexture(output)
Address in main memory to which converted texture data is to be written
pInputTexture(input)
This parameter is a pointer indicating an input texture in KM_TEXTURE_BMP format.
bAutoMipMap(input)
This parameter specifies whether a mipmap is created automatically. If TRUE is specified, a mipmap is automatically created (the output is in KM_TEXTURE_TWIDDLED_MM format).
If FALSE is specified, a mipmap is not created (output is in KM_TEXTURE_TWIDDLED format).
bDither(input)
This parameter specifies whether dither is effected. If TRUE is specified, dither is effected.
USize(input)
This parameter specifies the number of texels per side of texture. Select one of the following:
KM_MAPSIZE_8 | 8x8 texels |
KM_MAPSIZE_16 | 16x16 texels |
KM_MAPSIZE_32 | 32x32 texels |
KM_MAPSIZE_64 | 64x64 texels |
KM_MAPSIZE_128 | 128x128 texels |
KM_MAPSIZE_256 | 256x256 texels |
KM_MAPSIZE_512 | 512x512 texels |
KM_MAPSIZE_1024 | 1024x1024 texels |
KM_TEXTURE_ARGB1555 | ARGB-1555 format |
KM_TEXTURE_RGB565 | RGB-565 format |
KM_TEXTURE_ARGB4444 | ARGB-4444 format |
Return values:
Value | Explanation |
---|---|
KMSTATUS_SUCCESS | Success |
KMSTATUS_INVALID_TEXTURE_TYPE | Invalid texture type specified. |
kmuCreateTwiddledTexture