display configuration parameters

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:
none
The display content is not video, UI, or photo.
video
The display content is video.
ui
The display content is UI.
photo
The display content is photo.
string
  • none
  • video
  • ui
  • photo
cursor The visibility of the cursor on the display:
auto
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.
on
The cursor will always remain visible on the display, regardless of cursor inactivity.
off
The cursor will always remain invisble on the display regardless of cursor activity.
string
  • auto(default)
  • on
  • off
cursor-shape

The configuration required to use a cursor shape. This parameter is specified in the following format: filename hotspot[0] hotspot[1] x1 y1 width height

The parameters for cursor-shape are defined as follows:
filename
A file name containing the cursor image. Only bitmap images are currently supported. The file is expected to be located in the directory /usr/share/icons. Cursor shapes must have a color depth of 32 bits per pixel. The WFD driver is required to do format conversion if 32 bits per pixel cannot be used for cursors.
hotspot[0], hotspot[1]
The x and y offsets respectively into the image that should align with the cursor position. The actual cursor rectangle will correspond to the cursor position with the hotspot offset applied as a reverse translation. This means clipping may be done on all sides of the image (top, left, right, bottom).
x1, y1, width, height
The definition of the rectangle within the framebuffer where this particular cursor shape will be displayed. If there are no regions, i.e., rects is NULL, a cursor shape is considered the default one and is displayed everywhere unless another cursor rectangle is defined prior to this one.
string  
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 sections, after which the display will enter an idle state. string or unsigned long integer
  • off
  • 0..ULONG_MAX
mirroring The mirror types are:
disabled
Mirroring is disabled.
normal
Mirroring is enabled, and the aspect ratio of the image is 1:1.
stretch
Mirroring is enabled, and the image should fill the display while not preserving the aspect ratio.
zoom
Mirroring is enabled, and the image should fill the display while preserving the aspect ratio. Image content may be clipped.
fill
Mirroring is enabled, and the image should fill the display while preserving the aspect ratio. Image may be shown with black bars where applicable.
string
  • disabled
  • normal
  • stretch
  • zoom
  • fill
priority The priority of the update thread (i.e., the thread that renders the framebuffer(s)). integer Default: 15
splash Indication as whether or not to post framebuffer on start-up. This parameter is considered only if the WFD driver supports it.
0
Indicates to post the framebuffer immediately (blank screen).
1
Indicates to not post the framebuffer until the application requests a post.
integer
  • 0(default)
  • 1
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. Thie 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