Método ID2D1DrawInfo::SetVertexProcessing (d2d1effectauthor.h)

  • Artigo

Define um buffer de vértice, um sombreador de vértice correspondente e opções para controlar como os vértices devem ser tratados pelo contexto Direct2D.

Sintaxe

HRESULT SetVertexProcessing(
  [in, optional] ID2D1VertexBuffer            *vertexBuffer,
                 D2D1_VERTEX_OPTIONS          vertexOptions,
  [in, optional] const D2D1_BLEND_DESCRIPTION *blendDescription,
  [in, optional] const D2D1_VERTEX_RANGE      *vertexRange,
                 const GUID                   *vertexShader
);

Parâmetros

[in, optional] vertexBuffer

Tipo: ID2D1VertexBuffer*

O buffer de vértice, se isso estiver limpo, o sombreador de vértice padrão e o mapeamento para os retângulos de transformação serão usados.

vertexOptions

Tipo: D2D1_VERTEX_OPTIONS

Opções que influenciam como o renderizador interagirá com o sombreador de vértice.

[in, optional] blendDescription

Tipo: const D2D1_BLEND_DESCRIPTION*

Como os vértices serão misturados com a textura de saída.

[in, optional] vertexRange

Tipo: const D2D1_VERTEX_RANGE*

O conjunto de vértices a serem usados do buffer.

vertexShader

Tipo: GUID*

O GUID do sombreador de vértice.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Se falhar, retornará um código de erro HRESULT .

Comentários

Os sombreadores de vértice associados ao buffer de vértice por meio do GUID do sombreador de vértice devem ter sido carregados por meio do método ID2D1EffectContext::LoadVertexShader antes que essa chamada seja feita.

Se você passar a opção de vértice D2D1_VERTEX_OPTIONS_DO_NOT_CLEAR, o método falhará, a menos que a descrição da combinação seja exatamente esta:

D2D1_BLEND_DESCRIPTION blendDesc = 
        {
            D2D1_BLEND_ONE,
            D2D1_BLEND_ZERO,
            D2D1_BLEND_OPERATION_ADD,

            D2D1_BLEND_ONE,
            D2D1_BLEND_ZERO,
            D2D1_BLEND_OPERATION_ADD,

            { 1.0f, 1.0f, 1.0f, 1.0f }
        };

Se essa chamada falhar, a instância ID2D1Effect correspondente será colocada em um estado de erro e não será desenhada.

Se blendDescription for NULL, um modo de combinação em primeiro plano será usado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1effectauthor.h
Biblioteca D2d1.lib

Confira também

ID2D1DrawInfo

ID2D1EffectContext::CreateVertexBuffer

ID2D1EffectContext::LoadVertexShader