Método ID3DXSprite::Begin

  • Artigo

Prepara um dispositivo para sprites de desenho.

Sintaxe

HRESULT Begin(
  [in] DWORD Flags
);

Parâmetros

Sinalizadores [in]

Tipo: DWORD

Combinação de zero ou mais sinalizadores que descrevem as opções de renderização de sprite. Para esse método, os sinalizadores válidos são:

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

Para obter uma descrição dos sinalizadores e para obter informações sobre como controlar a captura de estado do dispositivo e as transformações de exibição do dispositivo, consulte D3DXSPRITE.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA E_OUTOFMEMORY.

Comentários

Esse método deve ser chamado de dentro de um IDirect3DDevice9::BeginScene . . . Sequência IDirect3DDevice9::EndScene . ID3DXSprite::Begin não pode ser usado como um substituto para IDirect3DDevice9::BeginScene ou ID3DXRenderToSurface::BeginScene.

Esse método definirá os seguintes estados no dispositivo.

Renderizar Estados:

Tipo (D3DRENDERSTATETYPE) Valor
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

 

Estados de estágio de textura:

Identificador de estágio Tipo (D3DTEXTURESTAGESTATETYPE) Valor
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

 

Estados do sampler:

Índice de estágio do sampler Tipo (D3DSAMPLERSTATETYPE) Valor
0 D3DSAMP_ADDRESSU D3DTADDRESS_CLAMP
0 D3DSAMP_ADDRESSV D3DTADDRESS_CLAMP
0 D3DSAMP_MAGFILTER D3DTEXF_ANISOTROPIC se TextureFilterCaps incluir D3DPTFILTERCAPS_MAGFANISOTROPIC; caso contrário, D3DTEXF_LINEAR
0 D3DSAMP_MAXMIPLEVEL 0
0 D3DSAMP_MAXANISOTROPY MaxAnisotropy
0 D3DSAMP_MINFILTER D3DTEXF_ANISOTROPIC se TextureFilterCaps incluir D3DPTFILTERCAPS_MINFANISOTROPIC; caso contrário, D3DTEXF_LINEAR
0 D3DSAMP_MIPFILTER D3DTEXF_LINEAR se TextureFilterCaps incluir D3DPTFILTERCAPS_MIPFLINEAR; caso contrário, D3DTEXF_POINT
0 D3DSAMP_MIPMAPLODBIAS 0
0 D3DSAMP_SRGBTEXTURE 0

 

Observação

Esse método desabilita N-patches.

 

Requisitos

Requisito Valor
parâmetro
D3dx9core.h
Biblioteca
D3dx9.lib

Confira também

ID3DXSprite

D3DXSPRITE