Convert to new override syntax
[AGL/meta-agl.git] / meta-agl-core / recipes-graphics / wayland / Readme.weston-ini-conf
1 ##Generate a weston.ini file:
2
3 To modify any of the default sections (core, shell), add a
4 do_configure() function to your bbappend, using machine (e.g. h3ulcb)
5 overrides (i.e. use the MACHINE name where "machine" is used below):
6
7 '''
8 do_configure:machine() {
9     echo repaint-window=34 >> ${WORKDIR}/core.cfg
10
11     echo transition-duration=300 >> ${WORKDIR}/ivishell.cfg
12     echo cursor-theme=default >> ${WORKDIR}/ivishell.cfg
13 }
14 '''
15 or:
16 '''
17 do_configure:machine() {
18     sed -i -e 's/drm-backend/fbdev-backend/' ${WORKDIR}/core.cfg
19 }
20 '''
21
22 To add new non-display sections, just list them in SRC_URI and WESTON_FRAGMENTS:
23 '''
24 FILESEXTRAPATHS:prepend:machine := "${THISDIR}/${PN}:"
25
26 SRC_URI:append:machine = " file://foo.cfg"
27 WESTON_FRAGMENTS:append:machine = " foo"
28
29 '''
30
31 To change the display, for example from the default assumption of an
32 HDMI-1-A connected screen that needs to be rotated 270 degrees to one
33 that is rotated 90 degrees, redefine the WESTON_DISPLAYS variable:
34
35 '''
36 WESTON_DISPLAYS:machine = "hdmi-a-1-90"
37 '''
38
39 Note that the weston-ini-conf recipe automatically generates a landscape
40 orientation version of weston.ini by replacing 90/270 degree rotation
41 fragments for HDMI-A-1 and the virtual output into 180 and 0 degrees,
42 respectively.  This landscape configuration can be used in an image by
43 pulling in weston-ini-conf-landscape instead of weston-ini-conf.