chromeos_brightness.h

// Copyright (c) 2010 The Chromium OS Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROMEOS_BRIGHTNESS_H_
#define CHROMEOS_BRIGHTNESS_H_

namespace chromeos {

// Signature of function invoked to handle brightness changes.  Arguments are
// the object passed to MonitorBrightness(), the current brightness level
// (between 0 and 100, inclusive), and whether the change was user-initiated
// (i.e. caused by the brightness keys) or not.
typedef void (*BrightnessMonitorFunctionV2)(void*, int, bool);
typedef void (*BrightnessMonitorFunction)(void*, int);  // DEPRECATED

class OpaqueBrightnessConnection;
typedef OpaqueBrightnessConnection* BrightnessConnection;

// Decrease the screen brightness by a small amount.
// If |allow_off| is true, the brightness may be reduced to zero
// and the backlight turned off. Otherwise the brightness will never be
// decreased to zero.
extern void (*DecreaseScreenBrightness)(bool allow_off);

// Increase the screen brightness by a small amount.
extern void (*IncreaseScreenBrightness)(void);

// Register a handler that will be called when the screen brightness changes.
extern BrightnessConnection (*MonitorBrightnessV2)(
    BrightnessMonitorFunctionV2 monitor_function,
    void* object);
// DEPRECATED
extern BrightnessConnection (*MonitorBrightness)(
    BrightnessMonitorFunction monitor_function,
    void* object);

// Unregister the handler.  Takes the BrightnessConnection returned by
// MonitorBrightnessV2().
extern void (*DisconnectBrightness)(BrightnessConnection connection);

}  // namespace chromeos

#endif  // CHROMEOS_BRIGHTNESS_H_