2.2.3.3 ColorBalanceEffect Object

The ColorBalanceEffect object specifies adjustments to the relative amounts of red, green, and blue in an image.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

CyanRed

MagentaGreen

YellowBlue

CyanRed (4 bytes): A signed integer that specifies a change in the amount of red in the image. This value MUST be in the range -100 through 100, with effects as follows:

Value

Meaning

-100 ≤ value < 0

As the value decreases, the amount of red in the image SHOULD decrease and the amount of cyan SHOULD increase.

0

A value of 0 specifies that the amounts of red and cyan MUST NOT change.

0 < value ≤ 100

As the value increases, the amount of red in the image SHOULD increase and the amount of cyan SHOULD decrease.

MagentaGreen (4 bytes): A signed integer that specifies a change in the amount of green in the image. This value MUST be in the range -100 through 100, with effects as follows:

Value

Meaning

-100 ≤ value < 0

As the value decreases, the amount of green in the image SHOULD decrease and the amount of magenta SHOULD increase.

0

A value of 0 specifies that the amounts of green and magenta MUST NOT change.

0 < value ≤ 100

As the value increases, the amount of green in the image SHOULD increase and the amount of magenta SHOULD decrease.

YellowBlue (4 bytes): A signed integer that specifies a change in the amount of blue in the image. This value MUST be in the range -100 through 100, with effects as follows:

Value

Meaning

-100 ≤ value < 0

As the value decreases, the amount of blue in the image SHOULD decrease and the amount of yellow SHOULD increase.

0

A value of 0 specifies that the amounts of blue and yellow MUST NOT change.

0 < value ≤ 100

As the value increases, the amount of blue in the image SHOULD increase and the amount of yellow SHOULD decrease.

Bitmap images are specified by EmfPlusBitmap objects (section 2.2.2.2).

See section 2.2.3 for the specification of additional image effects parameter objects.