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

kmChangeContextTextureSurface

TextureSurfaceの変更

書式

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

引数

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

戻り値

KMSTATUS_SUCCESS   成功

解説

kmSetVertexRenderState()関数/kmSetStripHead()関数でpVertexBuffDesc->pGlobalParamに登録したレンダリングパラメータのTextureSurfaceを変更します。 対応する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へレンダリングパラメータを登録していない場合の動作は保証しません。 また、この関数の実行でPaletteBank情報は初期化されますので、必要であれば kmChangeContextPaletteBank()関数でPaletteBank情報を設定してください。

参照

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

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