Quick Reference > Data Types > Structures Used with Input and Output Functions > BALANCING

BALANCING

typedef struct tagBALANCING 
{ 
   L_UINT uStructSize; 
   L_DOUBLE toRed; 
   L_DOUBLE toGreen; 
   L_DOUBLE toBlue; 
} BALANCING, *pBALANCING;

The BALANCING structure provides color balancing information to the L_BalanceColors function.

Member	Description
uStructSize	Size of this structure in bytes, for versioning. Use sizeof() macro to calculate this value.
toRed	Value that represents the percentage of the red color value that should be distributed to the red component. Possible values are 0.0 to 1.0.
toGreen	Value that represents the percentage of the green color value that should be distributed to the green component. Possible values are 0.0 to 1.0.
toBlue	Value that represents the percentage of the blue color value that should be distributed to the blue component. Possible values are 0.0 to 1.0.

Comments

If a BALANCING structure used to redistribute the red value of a pixel contains the following values:

toRed = 0.50

toGreen = 0.50

toBlue = 0.0

then 50% of the current red value of the pixel will be added to the new red value for the pixel and 50% of the current red value of the pixel will be added to the new green value for the pixel. For a more detailed description of how this works, refer to L_BalanceColors.