Location:
gulutil.h
Link against: egul.lib
class ColorUtils;
Description
Provides static functions for manipulating colours.
Members
Defined in ColorUtils
:
ColorAdjust()
, CreateGradientBitmapL()
, CreateSystemColorListL()
, CreateSystemColorListL()
, EBitmapOrientationHorizontal
, EBitmapOrientationVertical
, GetRgbDerivedBorderColors()
, RgbDarkerColor()
, RgbLighterColor()
, RgbMidDarkerColor()
, TBitmapOrientation
, UpdateSystemColorListL()
See also:
static IMPORT_C TRgb ColorAdjust(TRgb aColor, TInt aPercentage);
Description
Brightens or darkens a 24-bit colour by a percentage.
If the percentage given is less than 100%, a darker colour will be returned. The algorithm brightens or darkens each of the
R, G and B channels equally.
Parameters
TRgb aColor |
Input colour.
|
TInt aPercentage |
Percentage by which to adjust the input colour.
|
|
Return value
TRgb
|
The adjusted colour.
|
|
static IMPORT_C void CreateGradientBitmapL(CFbsBitmap &aBitmap, const RWsSession &aWs, TInt aBreadth, TBitmapOrientation aOrientation,
TRgb aStartColor, TRgb aEndColor);
Description
Creates a CFbsBitmap
containing a colour gradient.
To create a gradient, the end colour aEndColor must be different to the start colour aStartingColor.
Parameters
CFbsBitmap &aBitmap |
Bitmap which on return contains the colour gradient.
|
const RWsSession &aWs |
Handle to a window server session.
|
TInt aBreadth |
The width or the height of the bitmap, depending on the orientation.
|
TBitmapOrientation aOrientation |
The bitmap's orientation (vertical or horizontal).
|
TRgb aStartColor |
The start color.
|
TRgb aEndColor |
The end color.
|
|
static IMPORT_C CColorList *CreateSystemColorListL(RFs &aFs);
Description
Parameters
Return value
static IMPORT_C CColorList *CreateSystemColorListL(RFs &aFs, const CColorList &aColorList);
Description
Parameters
Return value
static IMPORT_C void UpdateSystemColorListL(RFs &aFs, CColorList &aColorList);
Description
Parameters
static IMPORT_C void GetRgbDerivedBorderColors(TGulBorder::TColors &aBorderColors, TRgb aBackgroundColor, TDisplayMode aMode);
Description
Gets the colours to use for a control's border.
Lighter and darker tones in the border are derived from the specified TRgb
background colour using an algorithm operating on the RGB value of this color or a lookup table, depending on the display
mode aMode. It sets the values of the aBorderColors members iBack, iLight, iMidlight, iMid, and iDark.
Parameters
static IMPORT_C TRgb RgbDarkerColor(TRgb aRgb, TDisplayMode aMode);
Description
Creates a darker color.
Parameters
TRgb aRgb |
The RGB color.
|
TDisplayMode aMode |
The display mode, which indicates the screen output of the colour e.g. 256 colour display mode (8 bpp).
|
|
Return value
static IMPORT_C TRgb RgbMidDarkerColor(TRgb aRgb, TDisplayMode aMode);
Description
Creates a medium dark version of the colour.
This function darkens the colour 50% less than RgbDarkerColor()
.
Parameters
TRgb aRgb |
The Rgb color.
|
TDisplayMode aMode |
The display mode, which indicates the screen output of the colour e.g. 256 colour display mode (8 bpp).
|
|
Return value
TRgb
|
The medium dark colour.
|
|
static IMPORT_C TRgb RgbLighterColor(TRgb aRgb, TDisplayMode aMode);
Description
Creates a lighter colour.
Parameters
TRgb aRgb |
The Rgb colour.
|
TDisplayMode aMode |
The display mode, which indicates the screen output of the colour e.g. 256 colour display mode (8 bpp).
|
|
Return value
TBitmapOrientation
Description
The orientation of a bitmap.