blob: add7b4816239b3984456454fc3bb0a42fa2c4eba [file] [log] [blame]
// Copyright 2019 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
library fuchsia.ui.brightness;
using zx;
/// A normalized relative brightness adjustment in the range
/// 0.0 (off/minimum) to 1.0 (maximum).
alias brightness = float32;
/// Control provides an interface to manage the brightness component.
protocol Control {
/// Turns the auto-brightness mode on.
/// SetManualBrightness will turn it off.
/// Requests the current auto-brightness mode.
/// This call implements the Hanging Get protocol.
WatchAutoBrightness() -> (struct {
enabled bool;
/// Turns auto-brightness mode off.
/// Used by e.g. Settings to set manual brightness using a slider
/// Value is in the range 0.0 to 1.0 representing min to max and
/// will be clamped if out of range.
SetManualBrightness(struct {
value brightness;
/// Set manual brightness specifying the duration over which the
/// target brightness will be set.
SetManualBrightnessSmooth(struct {
value brightness;
duration zx.duration;
/// Gets the current brightness in the range 0.0 to 1.0.
/// This result is valid for both manual and auto-brightness modes
/// and is typically used to show the current brightness on a slider.
/// This call implements the Hanging Get protocol.
WatchCurrentBrightness() -> (struct {
value brightness;
/// Sets the brightness adjustment.
/// This will change the brightness curve by the factor of the adjustment.
/// The adjustment is in the range of -1.0 to 1.0.
SetAutoBrightnessAdjustment(struct {
adjustment float32;
/// Gets the current auto brightness adjustment.
/// This call implements the Hanging Get protocol.
WatchAutoBrightnessAdjustment() -> (struct {
adjustment float32;
/// Sets the brightness curve as a set of points.
/// This will override the built-in brightness curve.
/// The default brightness curve will be used if the table is empty.
/// The connection will be closed if table errors are detected.
SetBrightnessTable(struct {
table BrightnessTable;
/// Gets the maximum supported backlight brightness in nits, if known.
GetMaxAbsoluteBrightness() -> (struct {
max_brightness float64;
}) error zx.status;
/// A tuple representing a point on the auto-brightness curve
/// Ambient_lux and nits must be positive values.
type BrightnessPoint = struct {
ambient_lux float32;
display_nits float32;
/// A set of points defining the auto-brightness curve.
/// The ambient_lux values must be monotonically increasing.
type BrightnessTable = struct {
points vector<BrightnessPoint>:50;