Переход к ключу
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Примечание
[Не рекомендуется. Этот API может быть удален из будущих выпусков Windows.]
Переход клавиш выполняет ключ на основе значения RGB, альфа-значения, оттенка или яркости.
На следующем рисунке показан переход между ключами:
Идентификатор класса (CLSID): {C5B19592-145E-11D3-9F04-006008039E37}
Имя переменной CLSID: CLSID_DxtKey
Понятное имя: "DxtKey"
Свойства
| Свойство | Тип | Допустимый диапазон | Описание | Применение |
|---|---|---|---|---|
| Оттенок | INT | 0–360 | Значение оттенка, для которого выполняется ключ. | Оттенок |
| Invert | BOOL | FALSE или TRUE | Логическое значение, указывающее, следует ли инвертировать операцию ключа по умолчанию. Если значение РАВНО FALSE, пиксели на изображении по умолчанию становятся прозрачными. Если значение РАВНО TRUE, операция инвертирует. | Chroma, Hue, Luminance, Nonred |
| KeyType | INT | См. примечания | Указывает тип ключа. Дополнительные сведения см. в подразделе "Примечания". | Все |
| Luminance | INT | 0–100 | Значение яркости, для которого выполняется ключ. | Luminance |
| RGB | DWORD | 0x0 — 0xFFFFFF | Цвет, для которого выполняется нажатие клавиши. Значение представляет собой шестнадцатеричное число в формате 0xRRGGBB, где RR — красное значение, GG — зеленое значение, а BB — синее значение. (Чистые красные, зеленые и синие 0xFF0000, 0x00FF00 и 0x0000FF соответственно.) | Цветность |
| Сходство | INT | 0–100 | Диапазон цветовых данных, который становится прозрачным. При более высоких значениях более широкий диапазон похожих цветов прозрачен. | Chroma, Nonred |
Комментарии
Тип выполняемого ключа зависит от значения свойства KeyType , которое должно иметь одно из следующих значений:
| Значение | Перечисление | Описание |
|---|---|---|
| 0 | DXTKEY_RGB | Chroma key (key by RGB value). |
| 1 | DXTKEY_NONRED | Невредимый ключ. (Делает синие и зеленые области прозрачными.) |
| 2 | DXTKEY_LUMINANCE | Клавиша яркости. |
| 3 | DXTKEY_ALPHA | Ключ по альфа-значению. |
| 4 | DXTKEY_HUE | Ключ по оттенку. |
Тип ключа по умолчанию — DXTKEY_ALPHA.