键转换

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意

[已弃用。 此 API 可能会从 Windows 的未来版本中删除。]

 

键转换基于 RGB 值、alpha 值、色调或亮度执行键。

下图显示了关键转换：

类 ID (CLSID) ：{C5B19592-145E-11D3-9F04-006008039E37}

CLSID 变量名称：CLSID_DxtKey

友好名称：“DxtKey”

属性

属性	类型	有效范围	说明	应用于
色调	int	0–360	要对其进行键的色调值。	色调
Invert	BOOL	FALSE 或 TRUE	指示是否反转键的默认操作的布尔值。 如果 为 FALSE，则覆盖图像中的像素以默认方式变为透明。 如果 为 TRUE，则操作反转。	色度、色调、亮度、非红色
KeyType	int	请参阅备注	指定密钥的类型。 有关详细信息，请参阅“备注”。	全部
亮度	int	0–100	要对其进行键的亮度值。	亮度
RGB	DWORD	0x0 – 0xFFFFFF	要对其键的颜色。 该值是格式为 0xRRGGBB 的十六进制数，其中 RR 为红色值， GG 为绿色值， BB 为蓝色值。 (纯红色、绿色和蓝色分别为0xFF0000、0x00FF00和0x0000FF。)	色度
相似度	int	0–100	变为透明的颜色数据的范围。 在较高的值下，更广的相似颜色范围是透明的。	色度，非红

 

备注

执行的键类型取决于 KeyType 属性的值，该值必须是下列值之一：

值	枚举	描述
0	DXTKEY_RGB	按 RGB 值) (键的色度键。
1	DXTKEY_NONRED	非已中断的键。 (使蓝色和绿色区域透明。)
2	DXTKEY_LUMINANCE	亮度键。
3	DXTKEY_ALPHA	按 alpha 值的键。
4	DXTKEY_HUE	按色调键。

 

键类型默认为 DXTKEY_ALPHA。