Hardware: Add AdaptiveBacklight support

Patchset 2: Fix javadoc
Patchset 3: Rename to AdaptiveBacklight
Patchset 4: Fix typo in javadoc comment

Change-Id: I50190833da67d7f574d42d48a52eb5c610b4966e
Signed-off-by: Jorge Ruesga <jorge@ruesga.com>

1 files changed, 49 insertions, 0 deletions

diff --git a/src/org/cyanogenmod/hardware/AdaptiveBacklight.java b/src/org/cyanogenmod/hardware/AdaptiveBacklight.java
new file mode 100644
index 0000000..fb52566
--- /dev/null
+++ b/src/org/cyanogenmod/hardware/AdaptiveBacklight.java
@@ -0,0 +1,49 @@
+/*
+ * Copyright (C) 2013 The CyanogenMod Project
+ *
+ * Licensed under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.cyanogenmod.hardware;
+
+/**
+ * Adaptive backlight support (this refers to technologies like NVIDIA SmartDimmer,
+ * QCOM CABL or Samsung CABC).
+ */
+public class AdaptiveBacklight {
+
+    /**
+     * Whether device supports an adaptive backlight technology.
+     *
+     * @return boolean Supported devices must return always true
+     */
+    public static boolean isSupported() { return false; }
+
+    /**
+     * This method return the current activation status of the adaptive backlight technology.
+     *
+     * @return boolean Must be false when adaptive backlight is not supported or not activated, or
+     * the operation failed while reading the status; true in any other case.
+     */
+    public static boolean isEnabled() { return false; }
+
+    /**
+     * This method allows to setup adaptive backlight technology status.
+     *
+     * @param status The new adaptive backlight status
+     * @return boolean Must be false if adaptive backlight is not supported or the operation
+     * failed; true in any other case.
+     */
+    public static boolean setEnabled(boolean status) { return false; }
+
+}