ID3DXSprite::Begin, méthode
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 |
|
| Bibliothèque |
|
Voir aussi