ID3DXSprite::Begin, méthode

  • Article

Prépare un appareil pour dessiner des sprites.

Syntaxe

HRESULT Begin(
  [in] DWORD Flags
);

Paramètres

Indicateurs [in]

Type : DWORD

Combinaison de zéro ou plusieurs indicateurs qui décrivent les options de rendu sprite. Pour cette méthode, les indicateurs valides sont les suivants :

  • D3DXSPRITE_ALPHABLEND
  • D3DXSPRITE__BILLBOARD
  • D3DXSPRITE_DONOTMODIFY_RENDERSTATE
  • D3DXSPRITE_DONOTSAVESTATE
  • D3DXSPRITE_OBJECTSPACE
  • D3DXSPRITE__SORT_DEPTH_BACKTOFRONT
  • D3DXSPRITE__SORT_DEPTH_FRONTTOBACK
  • D3DXSPRITE__SORT_TEXTURE

Pour obtenir une description des indicateurs et pour plus d’informations sur la façon de contrôler la capture d’état de l’appareil et les transformations d’affichage des appareils, consultez D3DXSPRITE.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est S_OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

Cette méthode doit être appelée à partir d’un IDirect3DDevice9::BeginScene . . . Séquence IDirect3DDevice9::EndScene . ID3DXSprite::Begin ne peut pas être utilisé comme substitut de IDirect3DDevice9::BeginScene ou ID3DXRenderToSurface::BeginScene.

Cette méthode définit les états suivants sur l’appareil.

États de rendu :

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

 

États de l’étape de texture :

Identificateur d’étape Type (D3DTEXTURESTAGESTATETYPE) Valeur
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

 

États de l’échantillonneur :

Index d’étape de l’échantillonneur Type (D3DSAMPLERSTATETYPE) Valeur
0 D3DSAMP_ADDRESSU D3DTADDRESS_CLAMP
0 D3DSAMP_ADDRESSV D3DTADDRESS_CLAMP
0 D3DSAMP_MAGFILTER D3DTEXF_ANISOTROPIC si TextureFilterCaps inclut D3DPTFILTERCAPS_MAGFANISOTROPIC ; sinon, D3DTEXF_LINEAR
0 D3DSAMP_MAXMIPLEVEL 0
0 D3DSAMP_MAXANISOTROPY MaxAnisotropy
0 D3DSAMP_MINFILTER D3DTEXF_ANISOTROPIC si TextureFilterCaps inclut D3DPTFILTERCAPS_MINFANISOTROPIC ; sinon, D3DTEXF_LINEAR
0 D3DSAMP_MIPFILTER D3DTEXF_LINEAR si TextureFilterCaps inclut D3DPTFILTERCAPS_MIPFLINEAR ; sinon, D3DTEXF_POINT
0 D3DSAMP_MIPMAPLODBIAS 0
0 D3DSAMP_SRGBTEXTURE 0

 

Notes

Cette méthode désactive les N correctifs.

 

Spécifications

Condition requise Valeur
En-tête
D3dx9core.h
Bibliothèque
D3dx9.lib

Voir aussi

ID3DXSprite

D3DXSPRITE