ID3DXSprite::Begin-Methode
Bereitet ein Gerät für das Zeichnen von Sprites vor.
Syntax
HRESULT Begin(
[in] DWORD Flags
);
Parameter
-
Flaggen [in]
-
Typ: DWORD
Kombination von null oder mehr Flags, die Sprite-Renderingoptionen beschreiben. Für diese Methode gelten die folgenden Flags:
- D3DXSPRITE_ALPHABLEND
- D3DXSPRITE__BILLBOARD
- D3DXSPRITE_DONOTMODIFY_RENDERSTATE
- D3DXSPRITE_DONOTSAVESTATE
- D3DXSPRITE_OBJECTSPACE
- D3DXSPRITE__SORT_DEPTH_BACKTOFRONT
- D3DXSPRITE__SORT_DEPTH_FRONTTOBACK
- D3DXSPRITE__SORT_TEXTURE
Eine Beschreibung der Flags und Informationen zum Steuern der Gerätestatuserfassung und Geräteansichtstransformationen finden Sie unter D3DXSPRITE.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Bemerkungen
Diese Methode muss aus einem IDirect3DDevice9::BeginScene aufgerufen werden. . . IDirect3DDevice9::EndScene-Sequenz . ID3DXSprite::Begin kann nicht als Ersatz für IDirect3DDevice9::BeginScene oder ID3DXRenderToSurface::BeginScene verwendet werden.
Diese Methode legt die folgenden Zustände auf dem Gerät fest.
Renderzustände:
| Type (D3DRENDERSTATETYPE) | Wert |
|---|---|
| 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 |
Texturstufenzustände:
| Phasenbezeichner | Type (D3DTEXTURESTAGESTATETYPE) | Wert |
|---|---|---|
| 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 |
Samplerstatus:
| Index der Samplerphase | Typ (D3DSAMPLERSTATETYPE) | Wert |
|---|---|---|
| 0 | D3DSAMP_ADDRESSU | D3DTADDRESS_CLAMP |
| 0 | D3DSAMP_ADDRESSV | D3DTADDRESS_CLAMP |
| 0 | D3DSAMP_MAGFILTER | D3DTEXF_ANISOTROPIC, wenn TextureFilterCaps D3DPTFILTERCAPS_MAGFANISOTROPIC enthält; Andernfalls D3DTEXF_LINEAR |
| 0 | D3DSAMP_MAXMIPLEVEL | 0 |
| 0 | D3DSAMP_MAXANISOTROPY | MaxAnisotropie |
| 0 | D3DSAMP_MINFILTER | D3DTEXF_ANISOTROPIC, wenn TextureFilterCaps D3DPTFILTERCAPS_MINFANISOTROPIC enthält; Andernfalls D3DTEXF_LINEAR |
| 0 | D3DSAMP_MIPFILTER | D3DTEXF_LINEAR, ob TextureFilterCaps D3DPTFILTERCAPS_MIPFLINEAR enthält; andernfalls D3DTEXF_POINT |
| 0 | D3DSAMP_MIPMAPLODBIAS | 0 |
| 0 | D3DSAMP_SRGBTEXTURE | 0 |
Hinweis
Diese Methode deaktiviert N-Patches.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch