Configuration parameters for display

The following are valid parameters that can be configured under the display section:

Parameter Description Type Possible Value(s)
background The background color of the display. Use RGB color code (HEX value) to identify the color. (e.g., blue = 0xff) unsigned long integer (hex)
  • 0x00 (default: black)
cbabc Content-based automatic brightness control; specifies the content type of the display string
The display content is not video, UI, or photo.
The display content is video.
The display content is UI.
The display content is photo.
cursor The visibility of the cursor on the display string
auto (default)
The cursor will remain visible on the display until there is 10 seconds of cursor inactivity. After that, the cursor will be made invisible on the display.
The cursor will always remain visible on the display, regardless of cursor inactivity.
The cursor will always remain invisble on the display regardless of cursor activity.
formats The pixel format(s) supported by the display. This parameter can be configured with multiple values. string
  • byte
  • rgba4444
  • rgbx4444
  • rgba5551
  • rgbx5111
  • rgb565
  • rgb888
  • rgba8888
  • rgbx8888
  • yvu9
  • yuv420
  • nv12
  • yv12
  • uyvy
  • yuy2
  • v422
  • ayuv
gamma The gamma value of the WFD driver. The range for this gamma value is specific to the driver. unsigned long integer 0..255
idle-timeout The amount of time (in seconds) after which the display will enter an idle state. string or unsigned long integer
  • off
  • 0..ULONG_MAX
mirroring The mirror types string
Mirroring is disabled.
Mirroring is enabled, and the aspect ratio of the image is 1:1.
Mirroring is enabled, and the image should fill the display while not preserving the aspect ratio.
Mirroring is enabled, and the image should fill the display while preserving the aspect ratio. Image content may be clipped.
Mirroring is enabled, and the image should fill the display while preserving the aspect ratio. Image may be shown with black bars where applicable.
priority The priority of the update thread (i.e., the thread that renders the framebuffer(s)). integer Default: 15
rotation The clockwise rotation of a display. Display rotation is absolute. long integer
  • 0
  • 90
  • 180
  • 270
rotation-mode Your preference of display rotation mode. If the mode of rotation specified isn`t supported by your display controller, the default is to use blitter rotation. string
Rotated blits with pipeline rotation where possible
Generic modes can resize
No rotation is supported
Port rotation, framebuffer resizes
Pipeline rotation, framebuffer resizes
splash Indicates whether or not to post framebuffer on start-up. This parameter is considered only if the WFD driver supports it. integer
Indicates to post the framebuffer immediately (blank screen).
Indicates to not post the framebuffer until the application requests a post.
stack-size The stack size (in units of 1024 bytes) that Screen is to use for its threads. stack-size must be configured appropriately for blitters/compositors that are using Mesa (e.g, gles2blt). The default stack size of 4 * 1024 bytes is insufficient for these types of blitters/compositors. integer 2048
touch-adjustments The x and y adjustments to be added to all touch events. This configuration must be in the form: x-adjustment,y-adjustment unsigned long integer  
video-mode The initial resolution and refresh rate for the display port. This configuration must be one that is reported by the WFD driver. If you set this to values that aren't supported, then the resolution and refresh rate will default to the first mode specified by the driver. The resolution and refresh rate must be in the form of: widthxheight @[i]refresh For example, video-mode = 1280x720@60. If i is indicated, then interlacing is set. unsigned long integer  
protection-enable Content protection for the window(s) on the display. Typcially this is set only if the application is interested in HDCP (High-Bandwidth Digital Content Protection). string
  • true
  • false