Address ANAPIC feedback

Also adds recommended combination for FRONT_BUFFER as
that was feedback from implementers

Fixes: 217752219
Test: N/A doc only change
Change-Id: I086597d14cc7d9d1a0b620b73297aaa3e6288773
This commit is contained in:
John Reck 2022-02-03 20:38:26 -05:00
parent 7b7e4616c3
commit cd883bc17a
2 changed files with 10 additions and 2 deletions

View file

@ -29,8 +29,8 @@ interface IAllocator {
* @param descriptor Properties of the buffers to allocate. This must be
* obtained from IMapper::createDescriptor().
* @param count The number of buffers to allocate.
* @return An AllocationResult containing the result of an error, or
* an AllocationError status
* @return An AllocationResult containing the result of the allocation
* @throws AllocationError on failure
*/
AllocationResult allocate(in byte[] descriptor, in int count);
}

View file

@ -125,6 +125,14 @@ enum BufferUsage {
* presents from SF (such as for panel self-refresh), but for any given
* present the buffer must be composited from even if it otherwise appears
* to be the same as a previous composition.
*
* If the GPU & HWC supports EGL_SINGLE_BUFFER, then it is recommended that
* FRONT_BUFFER usage is supported for the same formats as supported by
* EGL_SINGLE_BUFFER. In particular, it is recommended that the following
* combination is supported when possible:
* Format = RGBA_8888
* Usage = FRONT_BUFFER | GPU_RENDER_TARGET | COMPOSER_OVERLAY
*
*/
FRONT_BUFFER = 1L << 32,