Files
frameworks_base/services/java/com/android/server/display/DisplayAdapter.java
Jeff Brown bd6e1500ae Add initial multi-display support.
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
2012-08-29 15:34:17 -07:00

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);
}
}