Detailed Description

Functions to dim or brighten data.

The eye does not respond in a linear way to light. High speed PWM'd LEDs at 50% duty cycle appear far brighter then the "half as bright" you might expect.

If you want your midpoint brightness LEDs (128) to appear half as bright as "full" brightness (255), you have to apply a "dimming function".

Note: These are approximations of gamma correction with a gamma value of 2.0.

See also: Gamma Adjustment Functions

Functions
LIB8STATIC uint8_t	dim8_raw (uint8_t x)
	Adjust a scaling value for dimming.

LIB8STATIC uint8_t	dim8_video (uint8_t x)
	Adjust a scaling value for dimming for video (value will never go below 1)

LIB8STATIC uint8_t	dim8_lin (uint8_t x)
	Linear version of the dimming function that halves for values < 128.

LIB8STATIC uint8_t	brighten8_raw (uint8_t x)
	Brighten a value (inverse of dim8_raw())

LIB8STATIC uint8_t	brighten8_video (uint8_t x)
	Brighten a value (inverse of dim8_video())

LIB8STATIC uint8_t	brighten8_lin (uint8_t x)
	Brighten a value (inverse of dim8_lin())

Function Documentation

◆ brighten8_lin()

LIB8STATIC uint8_t brighten8_lin ( uint8_t x )

Brighten a value (inverse of dim8_lin())

Definition at line 719 of file scale8.h.

◆ brighten8_raw()

LIB8STATIC uint8_t brighten8_raw ( uint8_t x )

Brighten a value (inverse of dim8_raw())

Definition at line 707 of file scale8.h.

◆ brighten8_video()

LIB8STATIC uint8_t brighten8_video ( uint8_t x )

Brighten a value (inverse of dim8_video())

Definition at line 713 of file scale8.h.

◆ dim8_lin()

LIB8STATIC uint8_t dim8_lin ( uint8_t x )

Linear version of the dimming function that halves for values < 128.

Definition at line 696 of file scale8.h.

◆ dim8_raw()

LIB8STATIC uint8_t dim8_raw ( uint8_t x )

Adjust a scaling value for dimming.

See also: scale8()

Examples: NoisePlusPalette.ino.

Definition at line 689 of file scale8.h.

◆ dim8_video()

LIB8STATIC uint8_t dim8_video ( uint8_t x )

Adjust a scaling value for dimming for video (value will never go below 1)

See also: scale8_video()

Definition at line 693 of file scale8.h.