Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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