スプライトを描画するためのデバイスを準備します。
構文
HRESULT Begin(
[in] DWORD Flags
);
パラメーター
-
Flags [in]
-
種類: DWORD
スプライト レンダリング オプションを記述する 0 個以上のフラグの組み合わせ。 このメソッドの有効なフラグは次のとおりです。
- D3DXSPRITE_ALPHABLEND
- D3DXSPRITE__BILLBOARD
- D3DXSPRITE_DONOTMODIFY_RENDERSTATE
- D3DXSPRITE_DONOTSAVESTATE
- D3DXSPRITE_OBJECTSPACE
- D3DXSPRITE__SORT_DEPTH_BACKTOFRONT
- D3DXSPRITE__SORT_DEPTH_FRONTTOBACK
- D3DXSPRITE__SORT_TEXTURE
フラグの説明と、デバイス状態キャプチャとデバイス ビュー変換を制御する方法については、「 D3DXSPRITE」を参照してください。
戻り値
種類: HRESULT
メソッドが成功した場合、戻り値は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 パッチを無効にします。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|
こちらもご覧ください