Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

COLORADJUSTMENT structure

The COLORADJUSTMENT structure defines the color adjustment values used by the StretchBlt and StretchDIBits functions when the stretch mode is HALFTONE. You can set the color adjustment values by calling the SetColorAdjustment function.

Syntax


typedef struct tagCOLORADJUSTMENT {
  WORD  caSize;
  WORD  caFlags;
  WORD  caIlluminantIndex;
  WORD  caRedGamma;
  WORD  caGreenGamma;
  WORD  caBlueGamma;
  WORD  caReferenceBlack;
  WORD  caReferenceWhite;
  SHORT caContrast;
  SHORT caBrightness;
  SHORT caColorfulness;
  SHORT caRedGreenTint;
} COLORADJUSTMENT, *PCOLORADJUSTMENT;

Members

caSize

The size, in bytes, of the structure.

caFlags

Specifies how the output image should be prepared. This member may be set to NULL or any combination of the following values.

ValueMeaning
CA_NEGATIVESpecifies that the negative of the original image should be displayed.
CA_LOG_FILTERSpecifies that a logarithmic function should be applied to the final density of the output colors. This will increase the color contrast when the luminance is low.

 

caIlluminantIndex

The type of standard light source under which the image is viewed. This member may be set to one of the following values.

ValueMeaning
ILLUMINANT_DEVICE_DEFAULTDevice's default. Standard used by output devices.
ILLUMINANT_ATungsten lamp.
ILLUMINANT_BNoon sunlight.
ILLUMINANT_CNTSC daylight.
ILLUMINANT_D50Normal print.
ILLUMINANT_D55Bond paper print.
ILLUMINANT_D65Standard daylight. Standard for CRTs and pictures.
ILLUMINANT_D75Northern daylight.
ILLUMINANT_F2Cool white lamp.
ILLUMINANT_TUNGSTENSame as ILLUMINANT_A.
ILLUMINANT_DAYLIGHTSame as ILLUMINANT_C.
ILLUMINANT_FLUORESCENTSame as ILLUMINANT_F2.
ILLUMINANT_NTSCSame as ILLUMINANT_C.

 

caRedGamma

Specifies the nth power gamma-correction value for the red primary of the source colors. The value must be in the range from 2500 to 65,000. A value of 10,000 means no gamma correction.

caGreenGamma

Specifies the nth power gamma-correction value for the green primary of the source colors. The value must be in the range from 2500 to 65,000. A value of 10,000 means no gamma correction.

caBlueGamma

Specifies the nth power gamma-correction value for the blue primary of the source colors. The value must be in the range from 2500 to 65,000. A value of 10,000 means no gamma correction.

caReferenceBlack

The black reference for the source colors. Any colors that are darker than this are treated as black. The value must be in the range from 0 to 4000.

caReferenceWhite

The white reference for the source colors. Any colors that are lighter than this are treated as white. The value must be in the range from 6000 to 10,000.

caContrast

The amount of contrast to be applied to the source object. The value must be in the range from -100 to 100. A value of 0 means no contrast adjustment.

caBrightness

The amount of brightness to be applied to the source object. The value must be in the range from -100 to 100. A value of 0 means no brightness adjustment.

caColorfulness

The amount of colorfulness to be applied to the source object. The value must be in the range from -100 to 100. A value of 0 means no colorfulness adjustment.

caRedGreenTint

The amount of red or green tint adjustment to be applied to the source object. The value must be in the range from -100 to 100. Positive numbers adjust toward red and negative numbers adjust toward green. Zero means no tint adjustment.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

See also

Bitmaps Overview
Bitmap Structures
GetColorAdjustment
SetColorAdjustment
SetStretchBltMode
StretchBlt
StretchDIBits

 

 

Show: