ID3DXSprite::Begin メソッド

スプライトを描画するためのデバイスを準備します。

構文

HRESULT Begin(
  [in] DWORD Flags
);

Flags [in]

種類: DWORD

スプライトレンダリングオプションを記述する 0 個以上のフラグの組み合わせ。このメソッドの有効なフラグは次のとおりです。

フラグの説明と、デバイス状態キャプチャとデバイスビュー変換を制御する方法については、「 D3DXSPRITE」を参照してください。

メソッドが成功した場合、戻り値はS_OK。メソッドが失敗した場合、戻り値は、D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、D3DXERR_INVALIDDATA、E_OUTOFMEMORYのいずれかになります。

このメソッドは、 IDirect3DDevice9::BeginScene 内から呼び出す必要があります。 . . IDirect3DDevice9::EndScene シーケンス。 ID3DXSprite::Begin は、 IDirect3DDevice9::BeginScene または ID3DXRenderToSurface::BeginScene の代わりに使用できません。

このメソッドは、デバイスで次の状態を設定します。

レンダリングの状態:

型 (D3DRENDERSTATETYPE)	値
D3DRS_ALPHABLENDENABLE	true
D3DRS_ALPHAFUNC	D3DCMP_GREATER
D3DRS_ALPHAREF	0x00
D3DRS_ALPHATESTENABLE	AlphaCmpCaps
D3DRS_BLENDOP	D3DBLENDOP_ADD
D3DRS_CLIPPING	true
D3DRS_CLIPPLANEENABLE	FALSE
D3DRS_COLORWRITEENABLE	D3DCOLORWRITEENABLE_ALPHA \|D3DCOLORWRITEENABLE_BLUE \|D3DCOLORWRITEENABLE_GREEN \|D3DCOLORWRITEENABLE_RED
D3DRS_CULLMODE	D3DCULL_NONE
D3DRS_DESTBLEND	D3DBLEND_INVSRCALPHA
D3DRS_DIFFUSEMATERIALSOURCE	D3DMCS_COLOR1
D3DRS_ENABLEADAPTIVETESSELLATION	FALSE
D3DRS_FILLMODE	D3DFILL_SOLID
D3DRS_FOGENABLE	FALSE
D3DRS_INDEXEDVERTEXBLENDENABLE	FALSE
D3DRS_LIGHTING	FALSE
D3DRS_RANGEFOGENABLE	FALSE
D3DRS_SEPARATEALPHABLENDENABLE	FALSE
D3DRS_SHADEMODE	D3DSHADE_GOURAUD
D3DRS_SPECULARENABLE	FALSE
D3DRS_SRCBLEND	D3DBLEND_SRCALPHA
D3DRS_SRGBWRITEENABLE	FALSE
D3DRS_STENCILENABLE	FALSE
D3DRS_VERTEXBLEND	FALSE
D3DRS_WRAP0	0

テクスチャステージの状態:

ステージ識別子	Type (D3DTEXTURESTAGESTATETYPE)	値
0	D3DTSS_ALPHAARG1	D3DTA_TEXTURE
0	D3DTSS_ALPHAARG2	D3DTA_DIFFUSE
0	D3DTSS_ALPHAOP	D3DTOP_MODULATE
0	D3DTSS_COLORARG1	D3DTA_TEXTURE
0	D3DTSS_COLORARG2	D3DTA_DIFFUSE
0	D3DTSS_COLOROP	D3DTOP_MODULATE
0	D3DTSS_TEXCOORDINDEX	0
0	D3DTSS_TEXTURETRANSFORMFLAGS	D3DTTFF_DISABLE
1	D3DTSS_ALPHAOP	D3DTOP_DISABLE
1	D3DTSS_COLOROP	D3DTOP_DISABLE

サンプラーの状態:

サンプラーステージインデックス	型 (D3DSAMPLERSTATETYPE)	値
0	D3DSAMP_ADDRESSU	D3DTADDRESS_CLAMP
0	D3DSAMP_ADDRESSV	D3DTADDRESS_CLAMP
0	D3DSAMP_MAGFILTER	TextureFilterCaps にD3DPTFILTERCAPS_MAGFANISOTROPICが含まれているかどうかをD3DTEXF_ANISOTROPICします。それ以外の場合D3DTEXF_LINEAR
0	D3DSAMP_MAXMIPLEVEL	0
0	D3DSAMP_MAXANISOTROPY	MaxAnisotropy
0	D3DSAMP_MINFILTER	TextureFilterCaps にD3DPTFILTERCAPS_MINFANISOTROPICが含まれているかどうかをD3DTEXF_ANISOTROPICします。それ以外の場合D3DTEXF_LINEAR
0	D3DSAMP_MIPFILTER	TextureFilterCaps にD3DPTFILTERCAPS_MIPFLINEARが含まれているかどうかをD3DTEXF_LINEARします。それ以外の場合D3DTEXF_POINT
0	D3DSAMP_MIPMAPLODBIAS	0
0	D3DSAMP_SRGBTEXTURE	0

注意

このメソッドは、N パッチを無効にします。

要件	値
ヘッダー	D3dx9core.h
ライブラリ	D3dx9.lib