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 |
|
| Bibliothèque |
|