Método ID2D1CommandSink1::SetPrimitiveBlend1 (d2d1_2.h)
Establece un nuevo modo de combinación primitiva.
Sintaxis
HRESULT SetPrimitiveBlend1(
D2D1_PRIMITIVE_BLEND primitiveBlend
);
Parámetros
primitiveBlend
Tipo: D2D1_PRIMITIVE_BLEND
La mezcla primitiva que se aplicará a los primitivos posteriores.
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
Modos de blend
Para la representación con alias (excepto para el modo MIN), el valor de salida O se calcula mediante la interpolación lineal del valor blend(S, D) con el valor de píxel de destino, en función de la cantidad que cubre el primitivo el píxel de destino.En la tabla siguiente se muestran los modos primitivos de mezcla para la mezcla suavizada y suavizada. Las ecuaciones enumeradas en la tabla usan estos elementos:
- O = Salida
- S = Origen
- SA = Source Alpha
- D = Destino
- DA = Destination Alpha
- C = Cobertura de píxeles
| Modo de mezcla primitiva | Combinación con alias | Mezcla antialiased | Descripción |
|---|---|---|---|
| D2D1_PRIMITIVE_BLEND_SOURCE_OVER | O = (S + (1 – SA) * D) * C + D * (1 – C) | O = S * C + D *(1 – SA *C) | Modo de combinación de origen a destino estándar. |
| D2D1_PRIMITIVE_BLEND_COPY | O = S * C + D * (1 – C) | O = S * C + D * (1 – C) | El origen se copia en el destino; se omiten los píxeles de destino. |
| D2D1_PRIMITIVE_BLEND_MIN | O = Min(S + 1-SA, D) | O = Min(S * C + 1 – SA *C, D) | Los valores de píxeles resultantes usan el mínimo de los valores de píxel de origen y destino. Disponible en Windows 8 y versiones posteriores. |
| D2D1_PRIMITIVE_BLEND_ADD | O = (S + D) * C + D * (1 – C) | O = S * C + D | Los valores de píxeles resultantes son la suma de los valores de píxeles de origen y destino. Disponible en Windows 8 y versiones posteriores. |
Ilustración de los modos de mezcla primitiva con opacidad y fondos variables.
La combinación primitiva se aplicará a todos los primitivos dibujados en el contexto, a menos que se invalide con el parámetro compositeMode en drawImage API.
La mezcla primitiva se aplica al interior de cualquier primitivo dibujado en el contexto. En el caso de DrawImage, esto estará implícito en el rectángulo de imagen, desplazamiento y transformación del mundo.
Si la mezcla primitiva es algo distinto de D2D1_PRIMITIVE_BLEND_OVER , la representación de ClearType se desactivará. Si la aplicación fuerza explícitamente la representación de ClearType en estos modos, el contexto de dibujo se colocará en un estado de error. D2DERR_WRONG_STATE se devolverán desde EndDraw o Flush.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | d2d1_2.h |