Platform SDK: DirectX

D3DCOLORVALUE

The D3DCOLORVALUE structure describes color values for the D3DMATERIAL7 structure.

typedef struct _D3DCOLORVALUE { 
    union { 
        D3DVALUE r; 
        D3DVALUE dvR; 
    }; 
    union { 
        D3DVALUE g; 
        D3DVALUE dvG; 
    }; 
    union { 
        D3DVALUE b; 
        D3DVALUE dvB; 
    }; 
    union { 
        D3DVALUE a; 
        D3DVALUE dvA; 
    }; 
} D3DCOLORVALUE; 

Members

dvR, dvG, dvB, and dvA
Values of the D3DVALUE type specifying the red, green, blue, and alpha components of a color. These values generally are in the range from 0 through 1, with 0 being black.

Remarks

You can set the members of this structure to values outside the range of 0 through 1 to implement some unusual effects. Values greater than 1 produce strong lights that tend to wash out a scene. Negative values produce dark lights, which actually remove light from a scene. For more information, see Colored Lights.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX 5.0 or later.
  Header: Declared in d3dtypes.h.