Kamui2 Library - 描画パラメータ設定(Kamui1互換用)関数

kmChangeContextTextureAddress

TextureAddressの変更

書式

KMSTATUS kmChangeContextTextureAddress( pVertexBuffDesc, nParam, pTextureSurfaceDesc )
PKMVERTEXBUFFDESC pVertexBuffDesc,
KMINT32 nParam,
PKMSURFACEDESC pTextureSurfaceDesc

引数

pVertexBuffDesc   (入力/出力)KMVERTEXBUFFDESCへのポインタ
nParam   (入力)書き換えるパラメータ
pTextureSurfaceDesc   (入力)KMSURFACEDESCへのポインタ

戻り値

KMSTATUS_SUCCESS   成功

解説

kmSetVertexRenderState()関数、kmSetStripHead()関数でpVertexBuffDesc->pGlobalParamに登録したレンダリングパラメータのTextureAddressを変更します。

この関数では、TextureAddress以外は変更しないので下記のメンバに変更がない場合使用可能です。

上記のメンバに変更がある場合は、kmChangeContextTextureAddress()関数は使用せず、 kmChangeContextTextureSurface()関数を使用してください。 対応するVertexTypeは以下のようになります。
 VertexType   対応状況 
 VertexType00    × 
 VertexType01    × 
 VertexType02    × 
 VertexType03    ○ 
 VertexType04    ○ 
 VertexType05    ○ 
 VertexType06   ○ 
 VertexType07   ○ 
 VertexType08   ○ 
 VertexType09   × 
 VertexType10   × 
 VertexType11   ◎ 
 VertexType12   ◎ 
 VertexType13   ◎ 
 VertexType14   ◎ 
 VertexType15   × 
 VertexType16   ○ 
 VertexType17   × 


◎:KM_IMAGE_PARAM1 / KM_IMAGE_PARAM2 設定可能
○:KM_IMAGE_PARAM1のみ設定可能

引数nParamには、次の書き換えるパラメータを設定します。
 定義   意味 
 KM_IMAGE_PARAM1   1パラメータ 
 KM_IMAGE_PARAM2   2パラメータ 


備考

この関数は、kmStartVertexStrip()関数でストリップを開始する前に pVertexBuffDesc->pGlobalParam の一部を変更します。事前に同一パス内において、pVertexBuffDesc->pGlobalParamへレンダリングパラメータを登録していない場合の動作は保証しません。

参照

kmChangeContextTextureSurface()
 TextureSurfaceの変更
kmSetStripHead()
 レンダリングパラメータ(KMSTRIPHEAD)の登録
kmSetVertexRenderState()
 レンダリングパラメータ(KMVERTEXCONTEXT)の登録(通常時)
kmStartVertexStrip()
 頂点データストリップの開始

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