setBrightness

setBrightness is a function or API used to adjust the brightness level of a display or user interface. In software, it can refer to either a system-wide brightness control or a per-application or per-window brightness setting. The exact effect depends on the platform and scope of the call; some implementations modify the hardware display brightness, while others apply a brightness adjustment overlay on the application's content.

Parameters and ranges: Most setBrightness calls accept a numeric value representing brightness. Common ranges include 0.0 to 1.0 (or 0 to 100 percent). Some APIs expose discrete levels or accept percentage values. Some environments also offer an automatic or adaptive mode that adjusts brightness in response to ambient light, which can be controlled separately or disabled by setBrightness.

Behavior: When applied at the system level, brightness affects all content and hardware display output. When applied at the application level, it changes only the targeted window or view. Some platforms may ignore brightness requests if the app is running in a restricted context or if the user has locked accessibility features.

Return value and errors: Typical implementations return a success flag or status, or are void and may throw an exception if the value is out of range or the feature is unsupported. Many environments require appropriate permissions to modify system brightness.

See also: getBrightness, ambient light sensor, display settings, accessibility.