GFL Colors
From XnView Wiki
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