Add NUM_DISPLAY_TYPES query and refine display list semantics

Change-Id: I740859bfa2b126edcdf06f7b2c8208770bc864f9
This commit is contained in:
Jesse Hall
2012-08-22 11:42:57 -07:00
parent f4e4624ef7
commit 43b51d9fdd
2 changed files with 38 additions and 4 deletions

View File

@@ -342,8 +342,16 @@ typedef struct hwc_composer_device_1 {
* handles have been updated. Typically this happens (but is not limited to)
* when a window is added, removed, resized or moved.
*
* The numDisplays parameter will always be greater than zero, displays
* will be non-NULL, and the array entries will be non-NULL.
* For HWC 1.0, numDisplays will always be one, and displays[0] will be
* non-NULL.
*
* For HWC 1.1, numDisplays will always be HWC_NUM_DISPLAY_TYPES. Entries
* for unsupported or disabled/disconnected display types will be NULL.
*
* For HWC 1.2 and later, numDisplays will be HWC_NUM_DISPLAY_TYPES or more.
* The extra entries correspond to enabled virtual displays, and will be
* non-NULL. In HWC 1.2, support for one virtual display is required, and
* no more than one will be used. Future HWC versions might require more.
*
* returns: 0 on success. An negative error code on error. If an error is
* returned, SurfaceFlinger will assume that none of the layer will be
@@ -368,8 +376,16 @@ typedef struct hwc_composer_device_1 {
* been handled by SurfaceFlinger with OpenGL ES. In this case, (*set)()
* behaves just like eglSwapBuffers().
*
* The numDisplays parameter will always be greater than zero, displays
* will be non-NULL, and the array entries will be non-NULL.
* For HWC 1.0, numDisplays will always be one, and displays[0] will be
* non-NULL.
*
* For HWC 1.1, numDisplays will always be HWC_NUM_DISPLAY_TYPES. Entries
* for unsupported or disabled/disconnected display types will be NULL.
*
* For HWC 1.2 and later, numDisplays will be HWC_NUM_DISPLAY_TYPES or more.
* The extra entries correspond to enabled virtual displays, and will be
* non-NULL. In HWC 1.2, support for one virtual display is required, and
* no more than one will be used. Future HWC versions might require more.
*
* IMPORTANT NOTE: there is an implicit layer containing opaque black
* pixels behind all the layers in the list. It is the responsibility of

View File

@@ -139,6 +139,12 @@ enum {
* returns the vsync period in nanosecond
*/
HWC_VSYNC_PERIOD = 1,
/*
* availability: HWC_DEVICE_API_VERSION_1_1
* returns a mask of supported display types
*/
HWC_DISPLAY_TYPES_SUPPORTED = 2,
};
/* Allowed events for hwc_methods::eventControl() */
@@ -146,6 +152,18 @@ enum {
HWC_EVENT_VSYNC = 0
};
/* Display types and associated mask bits. */
enum {
HWC_DISPLAY_PRIMARY = 0,
HWC_DISPLAY_EXTERNAL = 1, // HDMI, DP, etc.
HWC_NUM_DISPLAY_TYPES
};
enum {
HWC_DISPLAY_PRIMARY_BIT = 1 << HWC_DISPLAY_PRIMARY,
HWC_DISPLAY_EXTERNAL_BIT = 1 << HWC_DISPLAY_EXTERNAL,
};
/*****************************************************************************/
__END_DECLS