14ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown/* 24ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Copyright (C) 2014 The Android Open Source Project 34ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 44ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Licensed under the Apache License, Version 2.0 (the "License"); 54ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * you may not use this file except in compliance with the License. 64ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * You may obtain a copy of the License at 74ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 84ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * http://www.apache.org/licenses/LICENSE-2.0 94ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 104ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Unless required by applicable law or agreed to in writing, software 114ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * distributed under the License is distributed on an "AS IS" BASIS, 124ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 134ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * See the License for the specific language governing permissions and 144ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * limitations under the License. 154ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 164ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 174ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brownpackage android.hardware.display; 184ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 19ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brownimport android.hardware.SensorManager; 20ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brownimport android.os.Handler; 21ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brownimport android.os.PowerManager; 22970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brownimport android.view.Display; 234ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brownimport android.view.DisplayInfo; 244ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 254ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown/** 264ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Display manager local system service interface. 274ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 284ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @hide Only for use within the system server. 294ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 304ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brownpublic abstract class DisplayManagerInternal { 314ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown /** 32ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * Called by the power manager to initialize power management facilities. 33ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown */ 34ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public abstract void initPowerManagement(DisplayPowerCallbacks callbacks, 35ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown Handler handler, SensorManager sensorManager); 36ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 37ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown /** 38ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * Called by the power manager to request a new power state. 39ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * <p> 40ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * The display power controller makes a copy of the provided object and then 41ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * begins adjusting the power state to match what was requested. 42ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * </p> 43ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * 44ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * @param request The requested power state. 45ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * @param waitForNegativeProximity If true, issues a request to wait for 46ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * negative proximity before turning the screen back on, assuming the screen 47ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * was turned off by the proximity sensor. 48ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * @return True if display is ready, false if there are important changes that must 49ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * be made asynchronously (such as turning the screen on), in which case the caller 50ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * should grab a wake lock, watch for {@link DisplayPowerCallbacks#onStateChanged()} 51ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * then try the request again later until the state converges. 52ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown */ 53ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public abstract boolean requestPowerState(DisplayPowerRequest request, 54ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown boolean waitForNegativeProximity); 55ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 56ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown /** 57ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * Returns true if the proximity sensor screen-off function is available. 58ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown */ 59ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public abstract boolean isProximitySensorAvailable(); 60ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 61ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown /** 624ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Returns information about the specified logical display. 634ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 644ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @param displayId The logical display id. 654ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @return The logical display info, or null if the display does not exist. The 664ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * returned object must be treated as immutable. 674ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 684ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown public abstract DisplayInfo getDisplayInfo(int displayId); 694ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 704ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown /** 714ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Registers a display transaction listener to provide the client a chance to 724ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * update its surfaces within the same transaction as any display layout updates. 734ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 744ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @param listener The listener to register. 754ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 764ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown public abstract void registerDisplayTransactionListener(DisplayTransactionListener listener); 774ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 784ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown /** 794ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Unregisters a display transaction listener to provide the client a chance to 804ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * update its surfaces within the same transaction as any display layout updates. 814ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 824ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @param listener The listener to unregister. 834ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 844ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown public abstract void unregisterDisplayTransactionListener(DisplayTransactionListener listener); 854ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 864ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown /** 874ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Overrides the display information of a particular logical display. 884ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * This is used by the window manager to control the size and characteristics 894ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * of the default display. It is expected to apply the requested change 904ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * to the display information synchronously so that applications will immediately 914ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * observe the new state. 924ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 934ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * NOTE: This method must be the only entry point by which the window manager 944ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * influences the logical configuration of displays. 954ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 964ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @param displayId The logical display id. 974ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @param info The new data to be stored. 984ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 994ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown public abstract void setDisplayInfoOverrideFromWindowManager( 1004ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown int displayId, DisplayInfo info); 1014ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 1024ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown /** 1034ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Called by the window manager to perform traversals while holding a 1044ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * surface flinger transaction. 1054ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 1064ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown public abstract void performTraversalInTransactionFromWindowManager(); 1074ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 1084ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown /** 1093f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * Tells the display manager about properties of the display that depend on the windows on it. 1103f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * This includes whether there is interesting unique content on the specified logical display, 1113f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * and whether the one of the windows has a preferred refresh rate. 1124ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * <p> 1134ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * If the display has unique content, then the display manager arranges for it 1144ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * to be presented on a physical display if appropriate. Otherwise, the display manager 1154ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * may choose to make the physical display mirror some other logical display. 1164ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * </p> 1174ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * 1183f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * <p> 1193f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * If one of the windows on the display has a preferred refresh rate that's supported by the 1203f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * display, then the display manager will request its use. 1213f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * </p> 1223f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * 1234ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @param displayId The logical display id to update. 1243f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * @param hasContent True if the logical display has content. This is used to control automatic 1253f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * mirroring. 1263f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * @param requestedRefreshRate The preferred refresh rate for the top-most visible window that 1273f145a2f958320766ae9240c7a57debc20d578aaMichael Wright * has a preference. 128b3b9eb3cfc5b3b3609a5d01258315798b38a5cf9P.Y. Laligand * @param requestedModeId The preferred mode id for the top-most visible window that has a 129b3b9eb3cfc5b3b3609a5d01258315798b38a5cf9P.Y. Laligand * preference. 1304ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * @param inTraversal True if called from WindowManagerService during a window traversal 1314ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * prior to call to performTraversalInTransactionFromWindowManager. 1324ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 1333f145a2f958320766ae9240c7a57debc20d578aaMichael Wright public abstract void setDisplayProperties(int displayId, boolean hasContent, 134b3b9eb3cfc5b3b3609a5d01258315798b38a5cf9P.Y. Laligand float requestedRefreshRate, int requestedModeId, boolean inTraversal); 1354ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown 1364ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown /** 137d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * Applies an offset to the contents of a display, for example to avoid burn-in. 138d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * <p> 139d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * TODO: Technically this should be associated with a physical rather than logical 140d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * display but this is good enough for now. 141d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * </p> 142d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * 143d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * @param displayId The logical display id to update. 144d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * @param x The X offset by which to shift the contents of the display. 145d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski * @param y The Y offset by which to shift the contents of the display. 146d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski */ 147d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski public abstract void setDisplayOffsets(int displayId, int x, int y); 148d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski 149d2e8640c2c1972d4f2e92d48660fa9e17d9291c4Filip Gruszczynski /** 150ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * Describes the requested power state of the display. 151ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * 152ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * This object is intended to describe the general characteristics of the 153ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * power state, such as whether the screen should be on or off and the current 154ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * brightness controls leaving the DisplayPowerController to manage the 155ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * details of how the transitions between states should occur. The goal is for 156ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * the PowerManagerService to focus on the global power state and not 157ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * have to micro-manage screen off animations, auto-brightness and other effects. 158ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown */ 159ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public static final class DisplayPowerRequest { 160970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown // Policy: Turn screen off as if the user pressed the power button 161970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown // including playing a screen off animation if applicable. 162970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public static final int POLICY_OFF = 0; 163970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown // Policy: Enable dozing and always-on display functionality. 164970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public static final int POLICY_DOZE = 1; 165970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown // Policy: Make the screen dim when the user activity timeout is 166970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown // about to expire. 167970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public static final int POLICY_DIM = 2; 168970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown // Policy: Make the screen bright as usual. 169970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public static final int POLICY_BRIGHT = 3; 170970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown 171970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown // The basic overall policy to apply: off, doze, dim or bright. 172970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public int policy; 173ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 174ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // If true, the proximity sensor overrides the screen state when an object is 175ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // nearby, turning it off temporarily until the object is moved away. 176ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public boolean useProximitySensor; 177ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 178ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // The desired screen brightness in the range 0 (minimum / off) to 255 (brightest). 179ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // The display power controller may choose to clamp the brightness. 180ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // When auto-brightness is enabled, this field should specify a nominal default 181ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // value to use while waiting for the light sensor to report enough data. 182ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public int screenBrightness; 183ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 184ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // The screen auto-brightness adjustment factor in the range -1 (dimmer) to 1 (brighter). 185ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public float screenAutoBrightnessAdjustment; 186ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 187a576b4d3be8687f0a65fc5777424955d551604e4Jeff Brown // Set to true if screenBrightness and screenAutoBrightnessAdjustment were both 188a576b4d3be8687f0a65fc5777424955d551604e4Jeff Brown // set by the user as opposed to being programmatically controlled by apps. 189a576b4d3be8687f0a65fc5777424955d551604e4Jeff Brown public boolean brightnessSetByUser; 190a576b4d3be8687f0a65fc5777424955d551604e4Jeff Brown 191ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // If true, enables automatic brightness control. 192ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public boolean useAutoBrightness; 193ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 194e333e674a758c39885d4d9779a1aad387fb0e6aaJeff Brown // If true, scales the brightness to half of desired. 195f974cc870635227ae13201480fb2f019d153af22Ruchi Kandoi public boolean lowPowerMode; 196f974cc870635227ae13201480fb2f019d153af22Ruchi Kandoi 197e333e674a758c39885d4d9779a1aad387fb0e6aaJeff Brown // If true, applies a brightness boost. 198e333e674a758c39885d4d9779a1aad387fb0e6aaJeff Brown public boolean boostScreenBrightness; 199e333e674a758c39885d4d9779a1aad387fb0e6aaJeff Brown 200ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // If true, prevents the screen from completely turning on if it is currently off. 201ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // The display does not enter a "ready" state if this flag is true and screen on is 202ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // blocked. The window manager policy blocks screen on while it prepares the keyguard to 203ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // prevent the user from seeing intermediate updates. 204ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // 205ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // Technically, we may not block the screen itself from turning on (because that introduces 206ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // extra unnecessary latency) but we do prevent content on screen from becoming 207ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown // visible to the user. 208ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public boolean blockScreenOn; 209ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 210970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown // Overrides the policy for adjusting screen brightness and state while dozing. 211970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public int dozeScreenBrightness; 212970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public int dozeScreenState; 213970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown 214ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public DisplayPowerRequest() { 215970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown policy = POLICY_BRIGHT; 216ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown useProximitySensor = false; 217ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown screenBrightness = PowerManager.BRIGHTNESS_ON; 218ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown screenAutoBrightnessAdjustment = 0.0f; 219ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown useAutoBrightness = false; 220ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown blockScreenOn = false; 221970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown dozeScreenBrightness = PowerManager.BRIGHTNESS_DEFAULT; 222970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown dozeScreenState = Display.STATE_UNKNOWN; 223ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 224ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 225ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public DisplayPowerRequest(DisplayPowerRequest other) { 226ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown copyFrom(other); 227ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 228ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 229970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public boolean isBrightOrDim() { 230970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown return policy == POLICY_BRIGHT || policy == POLICY_DIM; 231ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 232ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 233ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public void copyFrom(DisplayPowerRequest other) { 234970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown policy = other.policy; 235ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown useProximitySensor = other.useProximitySensor; 236ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown screenBrightness = other.screenBrightness; 237ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown screenAutoBrightnessAdjustment = other.screenAutoBrightnessAdjustment; 238a576b4d3be8687f0a65fc5777424955d551604e4Jeff Brown brightnessSetByUser = other.brightnessSetByUser; 239ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown useAutoBrightness = other.useAutoBrightness; 240ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown blockScreenOn = other.blockScreenOn; 241f974cc870635227ae13201480fb2f019d153af22Ruchi Kandoi lowPowerMode = other.lowPowerMode; 242e333e674a758c39885d4d9779a1aad387fb0e6aaJeff Brown boostScreenBrightness = other.boostScreenBrightness; 243970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown dozeScreenBrightness = other.dozeScreenBrightness; 244970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown dozeScreenState = other.dozeScreenState; 245ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 246ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 247ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown @Override 248ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public boolean equals(Object o) { 249ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown return o instanceof DisplayPowerRequest 250ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown && equals((DisplayPowerRequest)o); 251ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 252ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 253ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public boolean equals(DisplayPowerRequest other) { 254ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown return other != null 255970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown && policy == other.policy 256ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown && useProximitySensor == other.useProximitySensor 257ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown && screenBrightness == other.screenBrightness 258ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown && screenAutoBrightnessAdjustment == other.screenAutoBrightnessAdjustment 259a576b4d3be8687f0a65fc5777424955d551604e4Jeff Brown && brightnessSetByUser == other.brightnessSetByUser 260ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown && useAutoBrightness == other.useAutoBrightness 261f974cc870635227ae13201480fb2f019d153af22Ruchi Kandoi && blockScreenOn == other.blockScreenOn 262970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown && lowPowerMode == other.lowPowerMode 263e333e674a758c39885d4d9779a1aad387fb0e6aaJeff Brown && boostScreenBrightness == other.boostScreenBrightness 264970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown && dozeScreenBrightness == other.dozeScreenBrightness 265970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown && dozeScreenState == other.dozeScreenState; 266ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 267ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 268ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown @Override 269ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public int hashCode() { 270ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown return 0; // don't care 271ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 272ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 273ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown @Override 274ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public String toString() { 275970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown return "policy=" + policyToString(policy) 276ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown + ", useProximitySensor=" + useProximitySensor 277ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown + ", screenBrightness=" + screenBrightness 278ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown + ", screenAutoBrightnessAdjustment=" + screenAutoBrightnessAdjustment 279a576b4d3be8687f0a65fc5777424955d551604e4Jeff Brown + ", brightnessSetByUser=" + brightnessSetByUser 280ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown + ", useAutoBrightness=" + useAutoBrightness 281f974cc870635227ae13201480fb2f019d153af22Ruchi Kandoi + ", blockScreenOn=" + blockScreenOn 282970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown + ", lowPowerMode=" + lowPowerMode 283e333e674a758c39885d4d9779a1aad387fb0e6aaJeff Brown + ", boostScreenBrightness=" + boostScreenBrightness 284970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown + ", dozeScreenBrightness=" + dozeScreenBrightness 285970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown + ", dozeScreenState=" + Display.stateToString(dozeScreenState); 286970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown } 287970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown 288970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown public static String policyToString(int policy) { 289970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown switch (policy) { 290970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown case POLICY_OFF: 291970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown return "OFF"; 292970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown case POLICY_DOZE: 293970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown return "DOZE"; 294970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown case POLICY_DIM: 295970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown return "DIM"; 296970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown case POLICY_BRIGHT: 297970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown return "BRIGHT"; 298970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown default: 299970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown return Integer.toString(policy); 300970d4132ea28e748c1010be39450a98bbf7466f3Jeff Brown } 301ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 302ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 303ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 304ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown /** 305ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown * Asynchronous callbacks from the power controller to the power manager service. 306ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown */ 307ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown public interface DisplayPowerCallbacks { 308ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown void onStateChanged(); 309ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown void onProximityPositive(); 310ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown void onProximityNegative(); 311037c33eae74bee2774897d969d48947f9abe254fJeff Brown void onDisplayStateChange(int state); // one of the Display state constants 312ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 313ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown void acquireSuspendBlocker(); 314ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown void releaseSuspendBlocker(); 315ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown } 316ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown 317ad9ef191f50767d8d5b6f0fbd4b59bb1400dcd25Jeff Brown /** 3184ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * Called within a Surface transaction whenever the size or orientation of a 3194ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * display may have changed. Provides an opportunity for the client to 3204ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown * update the position of its surfaces as part of the same transaction. 3214ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown */ 3224ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown public interface DisplayTransactionListener { 3234ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown void onDisplayTransaction(); 3244ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown } 3254ccb823a9f62e57f9d221f83a97e82967e79a9e5Jeff Brown} 326