Color Manipulation Methods

Color Manipulation Methods

applyOpacity()

Applies the specified opacity percentage to the color, returning a new Color instance.

This is an absolute setter: passing 50 means "set opacity to exactly 50%", regardless of the current opacity.

Signature

applyOpacity(opacity: Percent): Color

Parameters

Returns

• Color: A new Color instance with the modified opacity. If the original color has no alpha channel, it is added. If it already has one, it is replaced.

Example

applyDarkness()

Darkens the color by subtracting the given percentage points from the current lightness in HSL space.

This is a relative adjustment: passing 20 means "reduce lightness by 20 percentage points" from its current value.

Signature

applyDarkness(percent: Percent): Color

Parameters

Returns

• Color: A new darkened Color instance. Reduces lightness in HSL space, clamping to 0% if the result would be negative. The original alpha (opacity) is preserved.

Example

applyBrightness()

Lightens the color by adding the given percentage points to the current lightness in HSL space.

This is a relative adjustment: passing 30 means "increase lightness by 30 percentage points" from its current value.

Signature

applyBrightness(percent: Percent): Color

Parameters

Returns

• Color: A new lightened Color instance. Increases lightness in HSL space, clamping to 100% if the result exceeds it. The original alpha (opacity) is preserved.

Example

applyDullness()

Desaturates the color by subtracting the given percentage points from the current saturation in HSL space.

This is a relative adjustment: passing 50 means "reduce saturation by 50 percentage points" from its current value.

Signature

applyDullness(percent: Percent): Color

Parameters

Returns

• Color: A new desaturated Color instance. Reduces saturation in HSL space, clamping to 0% if the result would be negative. The original alpha (opacity) is preserved.

Example

applyWhiteShade()

Softens the color toward white by proportionally reducing saturation and increasing lightness.

This is a proportional blend: passing 40 means "move 40% of the remaining distance toward pure white". Unlike applyBrightness or applyDullness, the effect scales relative to the current distance from white, producing a natural pastel/tint effect.

Signature

applyWhiteShade(percent: Percent): Color

Parameters

Returns

• Color: A new softened Color instance. Internally reduces saturation and increases lightness proportionally. The original alpha (opacity) is preserved.

Example

blendWith()

Blends the current color with another color by a given weight.

Signature

blendWith(other: ColorType | CSSColor, weight?: number): Color

Parameters

Returns

• Color: A new blended Color instance. A weight of 0 returns the original color, 1 returns the other color, and 0.5 is an equal mix.

Example