Package: android.hardware.configstore@1.0

ISurfaceFlingerConfigs

interface ISurfaceFlingerConfigs

Methods

vsyncEventPhaseOffsetNs

vsyncEventPhaseOffsetNs ()
generates (OptionalInt64 value)

The following two methods define(respectively):

- The phase offset between hardware vsync and when apps are woken up by the Choreographer callback - The phase offset between hardware vsync and when SurfaceFlinger wakes up to consume input

Their values may be tuned to trade off between display pipeline latency(both overall latency and the lengths of the app -->SF and SF -->display phases)and frame delivery jitter(which typically manifests as "jank" or "jerkiness" while interacting with the device). The default values must produce a relatively low amount of jitter at the expense of roughly two frames of app -->display latency, and unless significant testing is performed to avoid increased display jitter(both manual investigation using systrace[1]and automated testing using dumpsys gfxinfo[2]are recommended), they should not be modified.

[1]https ://developer.android.com/studio/profile/systrace.html[2]https ://developer.android.com/training/testing/performance.html

Details
Generates
value

useContextPriority

useContextPriority ()
generates (OptionalBool value)

Instruct the Render Engine to use EGL_IMG_context_priority hint if availabe.

Details
Generates
value

hasWideColorDisplay

hasWideColorDisplay ()
generates (OptionalBool value)

hasWideColorDisplay indicates that the device has or can support a wide-color display, e.g.color space greater than sRGB.Typical display may have same color primaries as DCI-P3.Indicate support for this feature by setting TARGET_HAS_WIDE_COLOR_DISPLAY to true in BoardConfig.mk This also means that the device is color managed.A color managed device will use the appropriate display mode depending on the content on the screen.Default is sRGB.

Details
Generates
value

hasHDRDisplay

hasHDRDisplay ()
generates (OptionalBool value)

hwHdrDisplay indicates that the device has or can support an HDR(High Dynamic Range)display.Typically an HDR display is also wide-color.Indicate support for this feature by setting TARGET_HAS_HDR_DISPLAY to true in BoardConfig.mk

Details
Generates
value

presentTimeOffsetFromVSyncNs

presentTimeOffsetFromVSyncNs ()
generates (OptionalInt64 value)

Specify the offset in nanoseconds to add to vsync time when timestamping present fences.

Details
Generates
value

useHwcForRGBtoYUV

useHwcForRGBtoYUV ()
generates (OptionalBool value)

Some hardware can do RGB->YUV conversion more efficiently in hardware controlled by HWC than in hardware controlled by the video encoder.This instruct VirtualDisplaySurface to use HWC for such conversion on GL composition.

Details
Generates
value

maxVirtualDisplaySize

maxVirtualDisplaySize ()
generates (OptionalUInt64 value)

Maximum dimension supported by HWC for virtual display.Must be equals to min(max_width, max_height).

Details
Generates
value

hasSyncFramework

hasSyncFramework ()
generates (OptionalBool value)

Indicates if Sync framework is available.Sync framework provides fence mechanism which significantly reduces buffer processing latency.

Details
Generates
value

useVrFlinger

useVrFlinger ()
generates (OptionalBool value)

Return true if surface flinger should use vr flinger for compatible vr apps, false otherwise.Devices that will never be running vr apps should return false to avoid extra resource usage.Daydream ready devices must return true for full vr support.

Details
Generates
value

maxFrameBufferAcquiredBuffers

maxFrameBufferAcquiredBuffers ()
generates (OptionalInt64 value)

Controls the number of buffers SurfaceFlinger will allocate for use in FramebufferSurface.

Details
Generates
value

startGraphicsAllocatorService

startGraphicsAllocatorService ()
generates (OptionalBool value)

Returns true if surface flinger should start hardware.graphics.allocator@2.0::IAllocator service.

Details
Generates
value