Kamui2 Library - テクスチャ制御関数

kmGetTexture

テクスチャメモリ上のテクスチャの読み出し

書式

KMSTATUS kmGetTexture( pTexture, pSurfaceDesc )
PKMDWORD pTexture
PKMSURFACEDESC pSurfaceDesc

引数

pTexture   (出力)メインメモリ上の保存する領域を示すポインタ
pSurfaceDesc   (入力)テクスチャサーフェスディスクプリタへのポインタ

戻り値

KMSTATUS_SUCCESS   読み出し成功
KMSTATUS_INVALID_ADDRESS   指定されたテクスチャサーフェスは確保されていない

解説

指定したテクスチャメモリ上のテクスチャを、メインメモリ上に読み出します。

出力されるのは、Kamuiテクスチャフォーマットのテクスチャピクセルデータ部分のみです。 ヘッダは付加されません。 また、pSurfaceDescにフレームバッファのSurfaceDescを指定すると、 指定されたフレームバッファの内容をメインメモリ上に読み出すことができます。

引数 pTextureは、テクスチャを保存するメインメモリ上の領域を示すポインタです。 32バイトアラインした32の倍数のバイト数を確保してください。

引数 pSurfaceDescは、保持しているテクスチャのサーフェスディスクプリタ KMSURFACEDESC 型の構造体へのポインタです。

メインメモリ側のテクスチャデータの先頭アドレスが32Byteアライメントしていて、 かつサイズが32Byteの倍数である場合、テクスチャメモリへの転送にDMAを使用し、 高速な転送が可能となります。


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