ID3DXSprite::Begin-Methode

Artikel
06/13/2023

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	D3dx9core.h
Bibliothek	D3dx9.lib

Siehe auch

ID3DXSprite
D3DXSPRITE

Freigeben über