Actions

GFL Colors

From XnView Wiki

Revision as of 13:52, 24 September 2009 by WikiSysop (talk | contribs) (Created page with 'gflBrigthness The gflBrigthness function increase or decrease the brightness of a picture. GFL_ERROR gflBrigthness( GFL_BITMAP * src, GFL_BITMAP ** dst, GFL_INT32 b…')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

gflBrigthness

The gflBrigthness function increase or decrease the brightness of a picture.


GFL_ERROR gflBrigthness(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 GFL_INT32 brightness

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. brightness An integer between -255 and 255.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS

gflContrast

The gflContrast function increase or decrease the contrast of a picture.


GFL_ERROR gflContrast(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 GFL_INT32 contrast

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. contrast An integer between -127 and 127.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflGamma, gflLogCorrection, gflNormalize, gflEqualize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS

gflGamma

The gflGamma function increase or decrease the gamma of a picture.


GFL_ERROR gflGamma(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 double gamma

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. gamma A number between 0.01 and 5.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflLogCorrection, gflNormalize, gflEqualize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS


gflAdjust

The gflAdjust function allows to adjust brightness, contrast & gamma of a picture.


GFL_ERROR gflAdjust(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 GFL_INT32 brightness,  
 GFL_INT32 contrast,  
 double gamma

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. brightness An integer between -255 and 255. contrast An integer between -127 and 127. gamma A number between 0.01 and 5.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualize, gflEqualizeOnLuminance, gflAdjustHLS,

gflAdjustHLS

The gflAdjustHLS function allows to adjust the hue, lightness & saturation of a picture.


GFL_ERROR gflAdjustHLS(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 GFL_INT32 h_increment,  
 GFL_INT32 l_increment,  
 GFL_INT32 s_increment

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. h_increment An interger between -100 and 100 to add to the hue value. l_increment An interger between -100 and 100 to add to the lightness value. s_increment An interger between -100 and 100 to add to the saturation value.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualize, gflEqualizeOnLuminance, gflAdjust,

gflNegative

The gflNegative function applies the negative of a picture.


GFL_ERROR gflNegative(

 GFL_BITMAP * src,  
 GFL_BITMAP * dst

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS

gflLogCorrection

The gflLogCorrection function applies a logarithmic correction on a picture.


GFL_ERROR gflLogCorrection(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflNormalize, gflEqualize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS

gflNormalize

The gflNormalize function applies a normalisation of the pixels values.


GFL_ERROR gflNormalize(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflEqualize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS

gflEqualize

The gflEqualize function applies an equalization of the pixels.


GFL_ERROR gflEqualize(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS

gflEqualizeOnLuminance

The gflEqualizeOnLuminance function applies an equalization of the pixels (based on the luminance).


GFL_ERROR gflEqualizeOnLuminance(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualize, gflBalance, gflAdjust, gflAdjustHLS

gflBalance

The gflBalance function applies a color balance of a picture.


GFL_ERROR gflBalance(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 const GFL_COLOR * color

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. color Pointer to a GFL_COLOR structure.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualize gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS

gflSwapColors

The gflSwapColors function allows to swap component.


GFL_ERROR gflSwapColors(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 GFL_SWAPCOLORS_MODE mode

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. mode GFL_SWAPCOLORS_RBG 0 GFL_SWAPCOLORS_BGR 1 GFL_SWAPCOLORS_BRG 2 GFL_SWAPCOLORS_GRB 3 GFL_SWAPCOLORS_GBR 4


Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


gflSepia

The gflSepia function converts a picture in sepia.


GFL_ERROR gflSepia(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 GFL_INT32 percent

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. percent An integer between 0 and 100. 0 => greyscale, 100 => maximum sepia

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflSepiaExt

gflSepiaEx

The gflSepiaEx function converts a picture in sepia.


GFL_ERROR gflSepiaEx(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst,  
 GFL_INT32 percent,  
 const GFL_COLOR * color

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance. percent An integer between 0 and 100. 0 => greyscale, 100 => maximum sepia color Pointer to a GFL_COLOR structure. This color is used as a reference.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflSepia

gflAutomaticLevels

The gflAutomaticLevels function applies an automatic equalisation of levels.


GFL_ERROR gflAutomaticLevels(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS, gflAutomaticContrast

gflAutomaticContrast

The gflAutomaticContrast function adjusts the contrast of picture.


GFL_ERROR gflAutomaticContrast(

 GFL_BITMAP * src,  
 GFL_BITMAP ** dst

);

Parameters

src Pointer to a GFL_BITMAP structure. dst Address of a pointer to a GFL_BITMAP structure. NULL if on the same instance.

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.


See also

gflNegative, gflBrigthness, gflContrast, gflGamma, gflLogCorrection, gflNormalize, gflEqualizeOnLuminance, gflBalance, gflAdjust, gflAdjustHLS gflAutomaticLevels