Kamui2 Library - ユーティリティ関連関数

kmuCreateTwiddledTexture

Kamuiビットマップ形式からTwiddled形式への変換

書式

KMSTATUS kmuCreateTwiddledTexture( pOutputTexture, pInputTexture, bAutoMipMap, bDither, USize, nTextureType )
PKMDWORD pOutputTexture
PKMDWORD pInputTexture
KMBOOLEAN bAutoMipMap
KMBOOLEAN bDither
KMINT32 USize
KMTEXTURETYPE nTextureType

引数

pOutputTexture   (出力)変換後のテクスチャデータを書き込むメインメモリ上のアドレス
pInputTexture   (入力)KM_TEXTURE_BMP形式の入力テクスチャを示すポインタ
bAutoMipMap   (入力)自動的にMIPMAPを生成するかどうかのフラグ
bDither   (入力)ディザをかけるかどうかのフラグ
USize   (入力)テクスチャの一辺のテクセル数
nTextureType   (入力)変換後のテクスチャのピクセルフォーマット

戻り値

KMSTATUS_SUCCESS   成功
KMSTATUS_INVALID_TEXTURE_TYPE   無効なテクスチャタイプを指定した

解説

メインメモリ上のKM_TEXTURE_BMP形式(ABGR8888)のテクスチャを、Twiddled / Twiddled Mipmap 形式のテクスチャに変換します。

引数pOutputTextureは、変換後のテクスチャデータを書き込むメインメモリ上のアドレスです。

引数pInputTextureは、KM_TEXTURE_BMP形式の入力テクスチャを示すポインタです。

引数bAutoMipMapは、自動的にMIPMAPを生成するかどうかを指定します。 TRUEを指定した場合には自動的にMIPMAPを生成します(出力はKM_TEXTURE_TWIDDLED_MM形式になります)。 FALSEを指定した場合にはMIPMAP生成は行いません(出力はKM_TEXTURE_TWIDDLED形式になります)。

引数bDitherは、ディザをかけるかどうかを指定します。 TRUEを指定した場合はディザをかけます。

引数USizeには、テクスチャの一辺のテクセル数を指定します。 下記の中のいずれかを指定します。

 定義   意味 
 KM_MAPSIZE_8   8x8 テクセル 
 KM_MAPSIZE_16   16x16 テクセル 
 KM_MAPSIZE_32   32x32 テクセル 
 KM_MAPSIZE_64   64x64 テクセル 
 KM_MAPSIZE_128   128x128 テクセル 
 KM_MAPSIZE_256   256x256 テクセル 
 KM_MAPSIZE_512   512x512 テクセル 
 KM_MAPSIZE_1024   1024x1024 テクセル 

引数nTextureTypeには、変換後のテクスチャのピクセルフォーマットを指定します。 下記の中のいずれかを指定します。
 定義   意味 
 KM_TEXTURE_ARGB1555   ARGB-1555形式 
 KM_TEXTURE_RGB565   RGB-565形式 
 KM_TEXTURE_ARGB4444   ARGB-4444形式 


備考

ミップマップ、ディザの指定を行ったときは、入力テクスチャデータの内容は失われます。

kmuCreateTwiddledTexture
COPYRIGHT © NEC Corporation / © SEGA ENTERPRISES, LTD., 1998-2000