Method GetBrighterColor

Namespace

Terminal.Gui.Drawing

Assembly

Terminal.Gui.dll

GetBrighterColor(double, bool?)

Returns a "highlighted" version of this color — visually more prominent against the given background context.

public Color GetBrighterColor(double brightenAmount = 0.2, bool? isDarkBackground = null)

Parameters

brightenAmount double

The percent amount to adjust the lightness by. The default is 20%.

isDarkBackground bool?

If true, brightens (increases lightness) for visibility on dark backgrounds. If false, darkens (decreases lightness) for visibility on light backgrounds. If null, auto-detects based on this color's own lightness (default/backward-compatible behavior).

Returns

Color

Remarks

The algorithm works in HSL color space and adjusts the lightness channel. When isDarkBackground is provided, the direction is explicit. When null, direction is auto-detected from this color's own lightness:

<ul><li>Dark backgrounds (or dark colors when auto-detecting): lightness is increased.</li><li>Light backgrounds (or light colors when auto-detecting): lightness is decreased.</li><li>
            If the adjustment resulted in a color too close to the original, a larger adjustment is
            made.
        </li></ul>