Método IMixerPinConfig::SetColorKey (mpconfig.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El SetColorKey método establece la clave de color que usa una secuencia de vídeo.
Sintaxis
HRESULT SetColorKey(
[in] COLORKEY *pColorKey
);
Parámetros
[in] pColorKey
Puntero a una estructura COLORKEY .
Valor devuelto
Devuelve un valor de HRESULT.
Comentarios
El término clave de color tiene significados diferentes en función de la secuencia a la que se hace referencia. La clave de color de la secuencia principal hace referencia a la clave de color de destino que usa la superficie de superposición. La clave de color de la secuencia secundaria hace referencia a la clave de color de origen utilizada, cuando se quita de una superficie fuera de la pantalla a la superficie principal.
Las aplicaciones deben establecer la clave de color del pin principal en un color oscuro (algún color que, en toda probabilidad, no estará presente en el escritorio). Los filtros de mezclador de superposición intentarán elegir un color oscuro, pero si la aplicación sabe que el color especificado forma parte de algún otro contenido, la aplicación debe cambiarlo.
Se puede usar el establecimiento de la clave de color en la secuencia secundaria para que la secuencia sea transparente y habilite imágenes no entrelazulares. Por ejemplo, si la secuencia secundaria es texto con subtítulos, el descodificador de texto con subtítulos debe pintar un color sólido en el fondo y, a continuación, establecer la clave de color en el pin correspondiente a ese color. Esto garantiza que todos los píxeles se transfieran excepto los especificados por la clave de color. Si es posible, las aplicaciones deben establecer la clave de color de la secuencia secundaria en la misma que la de la secuencia principal para ofrecer una ligera ventaja de rendimiento.
Al establecer este valor en la secuencia principal, se establece la clave de color de destino que usa la superficie de superposición. De forma predeterminada, la clave de color de destino se usa como clave de color para todas las secuencias transparentes (secundarias).
Los argumentos válidos para el parámetro pColorKey incluyen CK_INDEX cuando el modo de presentación de vídeo se establece en 256 colores y CK_RGB cuando el modo de presentación de vídeo se establece en una profundidad de color superior, como hi-color, 24 bits o 32 bits. La marca CK_RGB debe especificarse junto con el CK_INDEX. Si se establece CK_INDEX marca, el índice se usará como índice de paleta en modo de color 256. Pero debes proporcionar un COLORREF con un color verdadero válido para que, si el modo de presentación cambia sobre la marcha, DirectShow puede cambiar al uso del color verdadero especificado. Esto se debe a que se puede asignar un número de colores verdaderos a un único índice de paleta, pero pasar del índice de la paleta a un color verdadero no es uno a uno.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mpconfig.h |
| Library | Strmiids.lib |