Schlüsselübergang
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Hinweis
[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]
Der Schlüsselübergang führt die Schlüsselerstellung basierend auf RGB-Wert, Alphawert, Farbton oder Helligkeit durch.
Die folgende Abbildung zeigt den Schlüsselübergang:
Klassen-ID (CLSID): {C5B19592-145E-11D3-9F04-006008039E37}
CLSID-Variablenname: CLSID_DxtKey
Anzeigename: "DxtKey"
Eigenschaften
| Eigenschaft | type | Gültiger Bereich | BESCHREIBUNG | Gilt für |
|---|---|---|---|---|
| Farbton | INT | 0–360 | Der Farbtonwert, für den die Taste festgelegt werden soll. | Farbton |
| Invertierung | BOOL | FALSE oder TRUE | Boolescher Wert, der angibt, ob der Standardvorgang des Schlüssels invertiert werden soll. Wenn FALSE, werden Pixel im überstehenden Bild standardmäßig transparent gemacht. Bei TRUE wird der Vorgang invertiert. | Chroma, Hue, Luminance, Nonred |
| KeyType | INT | Siehe Hinweise | Gibt den Schlüsseltyp an. Weitere Informationen finden Sie in den Hinweisen. | Alle |
| Luminance | INT | 0–100 | Der Luminanzwert, für den ein Schlüssel verwendet werden soll. | Luminance |
| RGB | DWORD | 0x0 – 0xFFFFFF | Die Farbe, für die die Taste verwendet werden soll. Der Wert ist eine hexadezimale Zahl mit dem Format 0xRRGGBB, wobei RR der rote Wert, GG der grüne Wert und BB der blaue Wert ist. (Reines Rot, Grün und Blau sind 0xFF0000, 0x00FF00 bzw. 0x0000FF.) | Chroma |
| Ähnlichkeit | INT | 0–100 | Der Bereich der Farbdaten, der transparent wird. Bei höheren Werten ist ein größerer Bereich ähnlicher Farben transparent. | Chroma, Nonred |
Bemerkungen
Der Typ des ausgeführten Schlüssels hängt vom Wert der KeyType-Eigenschaft ab, die einer der folgenden Sein muss:
| Wert | Enumeration | Beschreibung |
|---|---|---|
| 0 | DXTKEY_RGB | Chroma-Taste (Taste nach RGB-Wert). |
| 1 | DXTKEY_NONRED | Nicht gerissener Schlüssel. (Macht blaue und grüne Bereiche transparent.) |
| 2 | DXTKEY_LUMINANCE | Luminance-Taste. |
| 3 | DXTKEY_ALPHA | Schlüssel nach Alphawert. |
| 4 | DXTKEY_HUE | Taste by hue. |
Der Schlüsseltyp ist standardmäßig DXTKEY_ALPHA.