ID3DXSprite :: Begin, méthode

Prépare un appareil pour le dessin des sprites.

Syntaxe

HRESULT Begin(
  [in] DWORD Flags
);

Paramètres

Indicateurs [ dans]

Type : DWORD

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

  • D3DXSPRITE _ ALPHABLEND
  • _ _ Panneau D3DXSPRITE
  • D3DXSPRITE _ DONOTMODIFY _ RENDERSTATE
  • D3DXSPRITE _ DONOTSAVESTATE
  • D3DXSPRITE _ OBJECTSPACE
  • D3DXSPRITE _ _ profondeur de tri _ _ BACKTOFRONT
  • D3DXSPRITE _ _ profondeur de tri _ _ FRONTTOBACK
  • _ _ Texture de tri D3DXSPRITE _

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

Valeur retournée

Type : HRESULT

Si la méthode est réussie, 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 _ sera déplacé, E _ OUTOFMEMORY.

Remarques

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 pour 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 _ plus
D3DRS _ ALPHAREF 0x00
D3DRS _ ALPHATESTENABLE AlphaCmpCaps
D3DRS _ BLENDOP D3DBLENDOP _ Ajouter
_Découpage D3DRS TRUE
D3DRS _ CLIPPLANEENABLE FALSE
D3DRS _ COLORWRITEENABLE D3DCOLORWRITEENABLE _ alpha | D3DCOLORWRITEENABLE _ bleu | D3DCOLORWRITEENABLE _ vert | D3DCOLORWRITEENABLE _ rouge
D3DRS _ CULLMODE D3DCULL _ aucun
D3DRS _ DESTBLEND D3DBLEND _ INVSRCALPHA
D3DRS _ DIFFUSEMATERIALSOURCE D3DMCS _ COLOR1
D3DRS _ ENABLEADAPTIVETESSELLATION FALSE
D3DRS _ FillMode D3DFILL _ Solid
D3DRS _ FOGENABLE FALSE
D3DRS _ INDEXEDVERTEXBLENDENABLE FALSE
_Éclairage D3DRS 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

États des étapes de texture :

Identificateur de l’étape Type (D3DTEXTURESTAGESTATETYPE) Valeur
0 D3DTSS _ ALPHAARG1 _Texture D3DTA
0 D3DTSS _ ALPHAARG2 _Diffusion D3DTA
0 D3DTSS _ ALPHAOP _Modulation D3DTOP
0 D3DTSS _ COLORARG1 _Texture D3DTA
0 D3DTSS _ COLORARG2 _Diffusion D3DTA
0 D3DTSS _ COLOROP _Modulation D3DTOP
0 D3DTSS _ TEXCOORDINDEX 0
0 D3DTSS _ TEXTURETRANSFORMFLAGS Désactivation de D3DTTFF _
1 D3DTSS _ ALPHAOP Désactivation de D3DTOP _
1 D3DTSS _ COLOROP Désactivation de D3DTOP _

États de l’échantillonneur :

Index d’étape de l’échantillonneur Type (D3DSAMPLERSTATETYPE) Valeur
0 _Adresse D3DSAMP D3DTADDRESS _ clamp
0 D3DSAMP _ ADDRESSV D3DTADDRESS _ clamp
0 D3DSAMP _ MAGFILTER D3DTEXF _ anisotrope si TextureFilterCaps comprend D3DPTFILTERCAPS _ MAGFANISOTROPIC ; sinon, D3DTEXF _ linéaire
0 D3DSAMP _ MAXMIPLEVEL 0
0 D3DSAMP _ MAXANISOTROPY MaxAnisotropy
0 D3DSAMP _ MINFILTER D3DTEXF _ anisotrope si TextureFilterCaps comprend D3DPTFILTERCAPS _ MINFANISOTROPIC ; sinon, D3DTEXF _ linéaire
0 D3DSAMP _ MIPFILTER D3DTEXF _ Linear si TextureFilterCaps comprend D3DPTFILTERCAPS _ MIPFLINEAR ; sinon D3DTEXF _ point
0 D3DSAMP _ MIPMAPLODBIAS 0
0 D3DSAMP _ SRGBTEXTURE 0

Notes

Cette méthode désactive N-patchs.

Configuration requise

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

Voir aussi

ID3DXSprite

D3DXSPRITE