LEVELCOLORINFO

Delphi Syntax:

LEVELCOLORINFO= Packed Record
   uMinInput: L_UINT;
   uMaxInput: L_UINT;
   uMinOutput: L_UINT;
   uMaxOutput: L_UINT;
   uGamma: L_UINT;
end;

C++ Builder Syntax:

struct LEVELCOLORINFO
{
   L_UINT uMinInput;
   L_UINT uMaxInput;
   L_UINT uMinOutput;
   L_UINT uMaxOutput;
   L_UINT uGamma;
};

The LEVELCOLORINFO record (structure) contains color-leveling information for a specific color channel. It is used mainly in the ColorLevel and AutoColorLevel methods.

Member

Description

uMinInput

Value that specifies the image’s shadows to be mapped. Valid values range from 0 to 255 for 8-bit, 0 to 4095 for 12-bit and 0 to 65535 for 16-bit images. Any value greater than or equal to this will be considered a shadow and will be remapped to the value in uMinOutput.

uMaxInput

Value that specifies the image’s highlights to be mapped. Valid values range from 0 to 255 for 8-bit, 0 to 4095 for 12-bit and 0 to 65535 for 16-bit images. Any value greater than or equal to this will be considered a highlight and will be remapped to the value in uMaxOutput.

uMinOutput

Value that specifies the value to which the shadows will be mapped. Valid values range from 0 to 255 for 8-bit, 0 to 4095 for 12-bit and 0 to 65535 for 16-bit images.

uMaxOutput

Value that specifies the value to which the highlights will be mapped. Valid values range from 0 to 255 for 8-bit, 0 to 4095 for 12-bit and 0 to 65535 for 16-bit images.

uGamma

Value that represents the gamma value. This value is used to modify the midtones of the image. The value in this member is a 100 times the actual value. Therefore, if uGamma = 167 then the actual gamma value is 1.67. Likewise, if you want to use a gamma of 1.75, set this member to 175. The default value is DEFAULT_GAMMA, which is 100 (actual gamma value of 1.00), which does not change the gamma value of the image.

Comments

The value of the uMaxInput member must be greater than the value of the uMinInputValue member by at least 2.

If uMinOutput > uMaxOutput then the image’s shadows and highlights will be inverted for the given channel.