Método ID3D10Device::OMSetBlendState (d3d10.h)

Artículo
08/22/2023

Establezca el estado de mezcla de la fase de fusión de salida.

Sintaxis

void OMSetBlendState(
  [in] ID3D10BlendState *pBlendState,
  [in] const FLOAT [4]  BlendFactor,
  [in] UINT             SampleMask
);

Parámetros

[in] pBlendState

Tipo: ID3D10BlendState*

Puntero a una interfaz de estado de mezcla (consulte ID3D10BlendState). Pasar NULL implica un estado de combinación predeterminado. Consulte los comentarios para obtener más información.

[in] BlendFactor

Tipo: const FLOAT

Matriz de factores de mezcla, uno para cada componente RGBA. Los factores de mezcla modulan los valores del sombreador de píxeles, el destino de representación o ambos. Si ha creado el objeto blend-state con D3D10_BLEND_BLEND_FACTOR o D3D10_BLEND_INV_BLEND_FACTOR, la fase de mezcla usa la matriz que no es NULL de factores de mezcla. Si no creó el objeto blend-state con D3D10_BLEND_BLEND_FACTOR o D3D10_BLEND_INV_BLEND_FACTOR, la fase de mezcla no usa la matriz no NULL de factores de mezcla; el tiempo de ejecución almacena los factores de mezcla y, posteriormente, puede llamar a ID3D11DeviceContext::OMGetBlendState para recuperar los factores de mezcla. Si pasa NULL, el tiempo de ejecución usa o almacena un factor de mezcla igual a { 1, 1, 1, 1 }.

[in] SampleMask

Tipo: UINT

Cobertura de ejemplo de 32 bits. El valor predeterminado es 0xffffffff. Vea Notas.

Valor devuelto

None

Observaciones

La fase de fusión de salida usa el estado de mezcla para determinar cómo combinar dos valores de píxelES RGB y dos valores alfa. Los dos valores de píxelES RGB y dos valores alfa son el valor de píxel RGB y el valor alfa que el sombreador de píxeles genera y el valor de píxel RGB y el valor alfa ya en el destino de representación de salida. La opción blend controla el origen de datos que la fase de fusión usa para modular los valores del sombreador de píxeles, el destino de representación o ambos. La operación de mezcla controla cómo la fase de mezcla combina matemáticamente estos valores modulados.

Para crear una interfaz de estado de mezcla, llame a ID3D10Device::CreateBlendState.

Pasar NULL para la interfaz de estado de mezcla indica al tiempo de ejecución para establecer un estado de combinación predeterminado. En la tabla siguiente se indican los parámetros de combinación predeterminados.

State	Valor predeterminado
AlphaToCoverageEnable	FALSE
BlendEnable	FALSE[8]
SrcBlend	D3D10_BLEND_ONE
DstBlend	D3D10_BLEND_ZERO
BlendOp	D3D10_BLEND_OP_ADD
SrcBlendAlpha	D3D10_BLEND_ONE
DstBlendAlpha	D3D10_BLEND_ZERO
BlendOpAlpha	D3D10_BLEND_OP_ADD
RenderTargetWriteMask[8]	D3D10_COLOR_WRITE_ENABLE_ALL[8]

Una máscara de ejemplo determina qué muestras se actualizan en todos los destinos de representación activos. La asignación de bits en una máscara de ejemplo a muestras en un destino de representación de varias muestras es responsabilidad de una aplicación individual. Siempre se aplica una máscara de ejemplo; es independiente de si el muestreo múltiple está habilitado y no depende de si una aplicación usa destinos de representación de varias muestras.

El método no contendrá una referencia a las interfaces pasadas. Por ese motivo, las aplicaciones deben tener cuidado de no liberar una interfaz actualmente en uso por parte del dispositivo.

Requisitos


Plataforma de destino	Windows
Encabezado	d3d10.h
Library	D3D10.lib

Consulte también

Id3D10Device (interfaz)