Compartir a través de

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

  • Artículo

Establece un búfer de vértices, un sombreador de vértices y opciones correspondientes para controlar el modo en que el contexto de Direct2D controla los vértices.

Sintaxis

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*

Si se borra el búfer de vértices, se usará el sombreador de vértices predeterminado y la asignación a los rectángulos de transformación.

vertexOptions

Tipo: D2D1_VERTEX_OPTIONS

Opciones que influyen en cómo interactuará el representador con el sombreador de vértices.

[in, optional] blendDescription

Tipo: const D2D1_BLEND_DESCRIPTION*

Cómo se combinarán los vértices con la textura de salida.

[in, optional] vertexRange

Tipo: const D2D1_VERTEX_RANGE*

Conjunto de vértices que se van a usar desde el búfer.

vertexShader

Tipo: GUID*

GUID del sombreador de vértices.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error HRESULT .

Comentarios

Los sombreadores de vértices asociados al búfer de vértices a través del GUID del sombreador de vértices deben haberse cargado a través del método ID2D1EffectContext::LoadVertexShader antes de realizar esta llamada.

Si pasa la opción de vértice D2D1_VERTEX_OPTIONS_DO_NOT_CLEAR, se produce un error en el método a menos que la descripción de la mezcla sea exactamente 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 }
        };

Si se produce un error en esta llamada, la instancia ID2D1Effect correspondiente se coloca en un estado de error y no se dibuja.

Si blendDescription es NULL, se usa un modo de combinación en primer plano.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d2d1effectauthor.h
Library D2d1.lib

Consulte también

ID2D1DrawInfo

ID2D1EffectContext::CreateVertexBuffer

ID2D1EffectContext::LoadVertexShader