зеркало из https://github.com/mozilla/pjs.git
204 строки
6.7 KiB
C++
204 строки
6.7 KiB
C++
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* vim: set sw=2 ts=8 et ft=cpp : */
|
|
/* ***** BEGIN LICENSE BLOCK *****
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
* the License. You may obtain a copy of the License at:
|
|
* http://www.mozilla.org/MPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
* for the specific language governing rights and limitations under the
|
|
* License.
|
|
*
|
|
* The Original Code is Mozilla Code.
|
|
*
|
|
* The Initial Developer of the Original Code is
|
|
* The Mozilla Foundation
|
|
* Portions created by the Initial Developer are Copyright (C) 2011
|
|
* the Initial Developer. All Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
* Chris Jones <jones.chris.g@gmail.com>
|
|
*
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
* either the GNU General Public License Version 2 or later (the "GPL"), or
|
|
* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
* use your version of this file under the terms of the MPL, indicate your
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
* the provisions above, a recipient may use your version of this file under
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
*
|
|
* ***** END LICENSE BLOCK ***** */
|
|
|
|
#ifndef mozilla_Hal_h
|
|
#define mozilla_Hal_h 1
|
|
|
|
#include "mozilla/hal_sandbox/PHal.h"
|
|
#include "base/basictypes.h"
|
|
#include "mozilla/Types.h"
|
|
#include "nsTArray.h"
|
|
#include "prlog.h"
|
|
#include "mozilla/dom/battery/Types.h"
|
|
#include "mozilla/dom/network/Types.h"
|
|
|
|
/*
|
|
* Hal.h contains the public Hal API.
|
|
*
|
|
* By default, this file defines its functions in the hal namespace, but if
|
|
* MOZ_HAL_NAMESPACE is defined, we'll define our functions in that namespace.
|
|
*
|
|
* This is used by HalImpl.h and HalSandbox.h, which define copies of all the
|
|
* functions here in the hal_impl and hal_sandbox namespaces.
|
|
*/
|
|
|
|
class nsIDOMWindow;
|
|
|
|
#ifndef MOZ_HAL_NAMESPACE
|
|
# define MOZ_HAL_NAMESPACE hal
|
|
# define MOZ_DEFINED_HAL_NAMESPACE 1
|
|
#endif
|
|
|
|
namespace mozilla {
|
|
|
|
namespace hal {
|
|
|
|
class WindowIdentifier;
|
|
|
|
extern PRLogModuleInfo *sHalLog;
|
|
#define HAL_LOG(msg) PR_LOG(mozilla::hal::sHalLog, PR_LOG_DEBUG, msg)
|
|
|
|
} // namespace hal
|
|
|
|
namespace MOZ_HAL_NAMESPACE {
|
|
|
|
/**
|
|
* Turn the default vibrator device on/off per the pattern specified
|
|
* by |pattern|. Each element in the pattern is the number of
|
|
* milliseconds to turn the vibrator on or off. The first element in
|
|
* |pattern| is an "on" element, the next is "off", and so on.
|
|
*
|
|
* If |pattern| is empty, any in-progress vibration is canceled.
|
|
*
|
|
* Only an active window within an active tab may call Vibrate; calls
|
|
* from inactive windows and windows on inactive tabs do nothing.
|
|
*
|
|
* If you're calling hal::Vibrate from the outside world, pass an
|
|
* nsIDOMWindow* in place of the WindowIdentifier parameter.
|
|
* The method with WindowIdentifier will be called automatically.
|
|
*/
|
|
void Vibrate(const nsTArray<uint32>& pattern,
|
|
nsIDOMWindow* aWindow);
|
|
void Vibrate(const nsTArray<uint32>& pattern,
|
|
const hal::WindowIdentifier &id);
|
|
|
|
/**
|
|
* Cancel a vibration started by the content window identified by
|
|
* WindowIdentifier.
|
|
*
|
|
* If the window was the last window to start a vibration, the
|
|
* cancellation request will go through even if the window is not
|
|
* active.
|
|
*
|
|
* As with hal::Vibrate(), if you're calling hal::CancelVibrate from the outside
|
|
* world, pass an nsIDOMWindow*. The method with WindowIdentifier will be called
|
|
* automatically.
|
|
*/
|
|
void CancelVibrate(nsIDOMWindow* aWindow);
|
|
void CancelVibrate(const hal::WindowIdentifier &id);
|
|
|
|
/**
|
|
* Inform the battery backend there is a new battery observer.
|
|
* @param aBatteryObserver The observer that should be added.
|
|
*/
|
|
void RegisterBatteryObserver(BatteryObserver* aBatteryObserver);
|
|
|
|
/**
|
|
* Inform the battery backend a battery observer unregistered.
|
|
* @param aBatteryObserver The observer that should be removed.
|
|
*/
|
|
void UnregisterBatteryObserver(BatteryObserver* aBatteryObserver);
|
|
|
|
/**
|
|
* Returns the current battery information.
|
|
*/
|
|
void GetCurrentBatteryInformation(hal::BatteryInformation* aBatteryInfo);
|
|
|
|
/**
|
|
* Notify of a change in the battery state.
|
|
* @param aBatteryInfo The new battery information.
|
|
*/
|
|
void NotifyBatteryChange(const hal::BatteryInformation& aBatteryInfo);
|
|
|
|
/**
|
|
* Determine whether the device's screen is currently enabled.
|
|
*/
|
|
bool GetScreenEnabled();
|
|
|
|
/**
|
|
* Enable or disable the device's screen.
|
|
*
|
|
* Note that it may take a few seconds for the screen to turn on or off.
|
|
*/
|
|
void SetScreenEnabled(bool enabled);
|
|
|
|
/**
|
|
* Get the brightness of the device's screen's backlight, on a scale from 0
|
|
* (very dim) to 1 (full blast).
|
|
*
|
|
* If the display is currently disabled, this returns the brightness the
|
|
* backlight will have when the display is re-enabled.
|
|
*/
|
|
double GetScreenBrightness();
|
|
|
|
/**
|
|
* Set the brightness of the device's screen's backlight, on a scale from 0
|
|
* (very dimm) to 1 (full blast). Values larger than 1 are treated like 1, and
|
|
* values smaller than 0 are treated like 0.
|
|
*
|
|
* Note that we may reduce the resolution of the given brightness value before
|
|
* sending it to the screen. Therefore if you call SetScreenBrightness(x)
|
|
* followed by GetScreenBrightness(), the value returned by
|
|
* GetScreenBrightness() may not be exactly x.
|
|
*/
|
|
void SetScreenBrightness(double brightness);
|
|
|
|
/**
|
|
* Inform the network backend there is a new network observer.
|
|
* @param aNetworkObserver The observer that should be added.
|
|
*/
|
|
void RegisterNetworkObserver(NetworkObserver* aNetworkObserver);
|
|
|
|
/**
|
|
* Inform the network backend a network observer unregistered.
|
|
* @param aNetworkObserver The observer that should be removed.
|
|
*/
|
|
void UnregisterNetworkObserver(NetworkObserver* aNetworkObserver);
|
|
|
|
/**
|
|
* Returns the current network information.
|
|
*/
|
|
void GetCurrentNetworkInformation(hal::NetworkInformation* aNetworkInfo);
|
|
|
|
/**
|
|
* Notify of a change in the network state.
|
|
* @param aNetworkInfo The new network information.
|
|
*/
|
|
void NotifyNetworkChange(const hal::NetworkInformation& aNetworkInfo);
|
|
|
|
} // namespace MOZ_HAL_NAMESPACE
|
|
} // namespace mozilla
|
|
|
|
#ifdef MOZ_DEFINED_HAL_NAMESPACE
|
|
# undef MOZ_DEFINED_HAL_NAMESPACE
|
|
# undef MOZ_HAL_NAMESPACE
|
|
#endif
|
|
|
|
#endif // mozilla_Hal_h
|