##### 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