Split the DisplayManager into two parts. One part is bound to a Context and takes care of Display compatibility and caching Display objects on behalf of the Context. The other part is global and takes care of communicating with the DisplayManagerService, handling callbacks, and caching DisplayInfo objects on behalf of the process. Implemented support for enumerating Displays and getting callbacks when displays are added, removed or changed. Elaborated the roles of DisplayManagerService, DisplayAdapter, and DisplayDevice. We now support having multiple display adapters registered, each of which can register multiple display devices and configure them dynamically. Added an OverlayDisplayAdapter which is used to simulate secondary displays by means of overlay windows. Different configurations of overlays can be selected using a new setting in the Developer Settings panel. The overlays can be repositioned and resized by the user for convenience. At the moment, all displays are mirrors of display 0 and no display transformations are applied. This will be improved in future patches. Refactored the way that the window manager creates its threads. The OverlayDisplayAdapter needs to be able to use hardware acceleration so it must share the same UI thread as the Keyguard and window manager policy. We now handle this explicitly as part of starting up the system server. This puts us in a better position to consider how we might want to share (or not share) Loopers among components. Overlay displays are disabled when in safe mode or in only-core mode to reduce the number of dependencies started in these modes. Change-Id: Ic2a661d5448dde01b095ab150697cb6791d69bb5
112 lines
3.3 KiB
Java
112 lines
3.3 KiB
Java
/*
|
|
* Copyright (C) 2012 The Android Open Source 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 com.android.server.display;
|
|
|
|
import android.content.Context;
|
|
import android.os.Handler;
|
|
|
|
import java.io.PrintWriter;
|
|
|
|
/**
|
|
* A display adapter makes zero or more display devices available to the system
|
|
* and provides facilities for discovering when displays are connected or disconnected.
|
|
* <p>
|
|
* For now, all display adapters are registered in the system server but
|
|
* in principle it could be done from other processes.
|
|
* </p><p>
|
|
* Display devices are not thread-safe and must only be accessed
|
|
* on the display manager service's handler thread.
|
|
* </p>
|
|
*/
|
|
public class DisplayAdapter {
|
|
private final Context mContext;
|
|
private final String mName;
|
|
private final Handler mHandler;
|
|
private Listener mListener;
|
|
|
|
public static final int DISPLAY_DEVICE_EVENT_ADDED = 1;
|
|
public static final int DISPLAY_DEVICE_EVENT_CHANGED = 2;
|
|
public static final int DISPLAY_DEVICE_EVENT_REMOVED = 3;
|
|
|
|
public DisplayAdapter(Context context, String name) {
|
|
mContext = context;
|
|
mName = name;
|
|
mHandler = new Handler();
|
|
}
|
|
|
|
public final Context getContext() {
|
|
return mContext;
|
|
}
|
|
|
|
public final Handler getHandler() {
|
|
return mHandler;
|
|
}
|
|
|
|
/**
|
|
* Gets the display adapter name for debugging purposes.
|
|
*
|
|
* @return The display adapter name.
|
|
*/
|
|
public final String getName() {
|
|
return mName;
|
|
}
|
|
|
|
/**
|
|
* Registers the display adapter with the display manager.
|
|
*
|
|
* @param listener The listener for callbacks. The listener will
|
|
* be invoked on the display manager service's handler thread.
|
|
*/
|
|
public final void register(Listener listener) {
|
|
mListener = listener;
|
|
onRegister();
|
|
}
|
|
|
|
/**
|
|
* Dumps the local state of the display adapter.
|
|
*/
|
|
public void dump(PrintWriter pw) {
|
|
}
|
|
|
|
/**
|
|
* Called when the display adapter is registered.
|
|
*
|
|
* The display adapter should register any built-in display devices as soon as possible.
|
|
* The boot process will wait for the default display to be registered.
|
|
*
|
|
* Other display devices can be registered dynamically later.
|
|
*/
|
|
protected void onRegister() {
|
|
}
|
|
|
|
/**
|
|
* Sends a display device event to the display adapter listener asynchronously.
|
|
*/
|
|
protected void sendDisplayDeviceEvent(final DisplayDevice device, final int event) {
|
|
mHandler.post(new Runnable() {
|
|
@Override
|
|
public void run() {
|
|
mListener.onDisplayDeviceEvent(device, event);
|
|
}
|
|
});
|
|
}
|
|
|
|
public interface Listener {
|
|
public void onDisplayDeviceEvent(DisplayDevice device, int event);
|
|
}
|
|
}
|