Microsoft DirectX 8.1 (C++)

Key Transition

The Key transition performs keying based on RGB value, alpha value, hue, or luminance.

The following image shows the key transition:

Key transition

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

CLSID Variable Name: CLSID_DxtKey

Properties

Property Type Valid range Description Applies To
Hue int 0–360 The hue value on which to key. Hue
Invert BOOL FALSE or TRUE Boolean value indicating whether to invert the default operation of the key. If FALSE, pixels in the overlying image are made transparent in the default manner. If TRUE, the operation inverts. Chroma, Hue, Luminance, Nonred
KeyType int See Remarks Specifies the type of key. For more information, see Remarks. All
Luminance int 0–100 The luminance value on which to key. Luminance
RGB DWORD 0x0 – 0xFFFFFF The color on which to key. The value is a hexadecimal number with the format 0xRRGGBB, where RR is the red value, GG is the green value, and BB is the blue value. (Pure red, green, and blue are 0xFF0000, 0x00FF00, and 0x0000FF, respectively.) Chroma, Hue
Similarity int 0–100 The range of color data that becomes transparent. At higher values, a wider range of similar colors is transparent. Chroma, Nonred

Remarks

The type of key that is performed depends on the value of the KeyType property, which must be one of the following:

Value Enumeration Description
0 DXTKEY_RGB Chroma key (key by RGB value).
1 DXTKEY_NONRED Nonred key. (Makes blue and green areas transparent.)
2 DXTKEY_LUMINANCE Luminance key.
3 DXTKEY_ALPHA Key by alpha value.
4 DXTKEY_HUE Key by hue.

The key type defaults to DXTKEY_ALPHA.