原文出自於 http://manpages.ubuntu.com/manpages/wily/man5/weston.ini.5.html
<NAME>
weston.ini 為weston的配置檔案(target目錄中存放於/etc/下)
為Wayland合成器(compositor)的參考
<INTRODUCTION>
Weston從它代入的命令參數(command line parameters)以及現在描述的這個weston.ini文件去獲得配置
<DESCRIPTION>
為了weston的結構安排(setup), Weston使用了被稱為weston,ini的配置檔案
weston.ini配置文件會當server被啟動後, 從下列位置之一去搜尋
$XDG_CONFIG_HOME/weston.ini (若 $XDG_CONFIG_HOME 被設置)
$HOME/.config/weston.ini (若 $HOME 被設置)
weston/weston.ini in each
$XDG_CONFIG_DIR (若 $XDG_CONFIG_DIRS 被設置)
/etc/xdg/weston/weston.ini (若 $XDG_CONFIG_DIRS 沒有被設置)
<current dir>/weston.ini (若沒有變數被設置)
其中環境變數 $HOME為使用者的家目錄, 而 $XDG_CONFIG_HOME為使用者特定配置(configuration)目錄
而 $XDG_CONFIG_DIRS為一個冒號':' 劃定的配置基礎目錄之列表, 例如/etc/xdg-foo:/etc/xdg.
weston.ini 文件由許多段落(sections)組成，可能以任何順序出現，或者省略使用默認配置值
每個段落須為以下形式：
[SectionHeader]
Key1=Value1
Key2=Value2
...
空格很重要
而註釋行會被忽略：#comment
段落(sections)的檔頭如下:
core The core modules and options 核心模組與選項
libinput Input device configuration 輸入裝置的配置
shell Desktop customization 桌面的客製化
launcher Add launcher to the panel 將啟動器加到面板
screensaver Screensaver selection 螢幕保護選擇
output Output configuration 輸出配置
input-method Onscreen keyboard input 螢幕鍵盤輸入
keyboard Keyboard layouts 鍵盤layout
terminal Terminal application options 終端應用程式的控制選項
xwayland XWayland options
screen-share Screen sharing options 螢幕分享的控制選項
可能的Value 的類型為字串, 有號與無號之32-bit整數, 以及boolean.
字串們不能被引用, 不支持任何escape序列, 並且運行到行的結尾.
整數可以以十進制（例如123），八進制（例如0173）和十六進制（例如0x7b）的形式給出。
boolean只能為“true”或“false”。
<CORE SECTION>
core段落是被用於選擇啟動合成器模組(startup compositor modules)以及一般選項
1. shell=desktop-shell.so
闡明一個要去載入的shell(為string). 這個可以被使用去載入你自己實現的shell或有著Weston的一個shell(如同默認)
在/usr/lib/i386-linux-gnu/weston目錄中可用的shells有:
desktop-shell.so
2. modules=xwayland.so,cms-colord.so
闡明要去載入的模組(為string). 在 /usr/lib/i386-linux-gnu/weston 目錄中可用的模組有:
xwayland.so
cms-colord.so
screen-share.so
3. backend=headless-backend.so
覆寫默認的backend. 在 /usr/lib/i386-linux-gnu/weston 目錄中可用的backend模組們有:
drm-backend.so
fbdev-backend.so
headless-backend.so
rdp-backend.so
rpi-backend.so
wayland-backend.so
x11-backend.so
4. repaint-window=N
設置重繪視窗的合適長度, 單位為milliseconds. 重繪視窗被用來去控制並降低終端的輸出延遲.
若視窗比輸出刷新週期還要長, 那麼當之前舊的重繪完成之後, 重繪將會立即完成, 不處理在之間的終端請求.
若重繪視窗太短, 則合成器可能會遺漏目標垂直空白(target vertical blank), 增加輸出延遲.
默認值為7 milliseconds. 允許範圍從-10到1000 milliseconds.
使用了負值將會強迫合成一直遺漏螢幕垂直空白(target vblank)
5. gbm-format=format
設定GBM格式, 為了GBM backend之framebuffer而使用.
可為 xrgb8888, xrgb2101010, rgb565. 默認為xrgb8888 .
6. idle-time=seconds
設定weston的閒置timeout(以秒為單位).
這個閒置timeout時間之後，Weston將進入“非活動(inactive)”模式，屏幕將褪色為黑色。
注意, 在淡出之後, 螢幕保護可能也會這此刻開始(當然前提是如果在下面的SCREENSAVER 段落為enabled)
但當前的閒置時間選項與螢幕保護無關.
若value為0則為disable timeout.
重要: 這個選項也可以通過Weston的"-i"的command line去設定, 並且優先於當前的.ini之選項.
意思就是說如果.ini和command line都有定義超時timeout時間, 將會使用command line.
另一方面，如果沒有設置值，則默認空閒超時將設置為300秒
<LIBINPUT SECTION>
這個libinput 段落被用來: 當使用libinput 輸入裝置backend(using the libinput input device backend)時, 去配置輸入裝置
可用的配置有:
enable_tap=true
設為enable tap以在touch板之裝置上去點擊
<SHELL SECTION>
此shell 段落被用來去客製化合成器. 一些按鍵(Keys)可能不被經由不同的shell plugins去處理.
在此段落裡可顯示的條目有:
1. client=file
為shell 終端可去執行而設定路徑. 若無指定則啟動(launch) weston-desktop-shell (為字串)
2. background-image=file
為背景影像檔案設定路徑(為字串)
3. background-type=tile
確定如何繪製背景圖像(為字符).
可為 scale, scale-crop or tile (默認). Scale意指縮放至恰好符合輸出, 而不保留比例.
Scale-crop保留寬高比，縮放背景圖像，足夠大以覆蓋輸出，並將其居中. 如果長寬比與輸出不匹配，則圖像從左右，或從上下裁剪
Tile重複背景圖像以填充輸出
4. background-color=0xAARRGGBB
設置背景（無號整數）的顏色。 十六進制數字成組按照alpha，紅色，綠色和藍色順序排列
5. panel-color=0xAARRGGBB
設置面板的顏色（無號整數）。 十六進制數字成組按順序透明，紅色，綠色和藍色
例如:
0xffff0000 Red
0xff00ff00 Green
0xff0000ff Blue
0x00ffffff Fully transparent (??不懂, 透明度不是在第一個嗎= =?)
6. panel-location=top
設定面板的位置(字串). 可為 top, none.
7. locking=true
使用螢幕鎖定(為boolean)
8. animation=zoom
用來設定於打開新視窗的效果(字串). 可為zoom, fade, none. 若為默認則無動畫被使用
9. close-animation=fade
用來設定於關閉視窗的效果(字串). 可為fade, none.若為默認則使用fade動畫效果
10. startup-animation=fade
用來設定打開新視窗的效果(字串). 可為fade, none. 若為默認則使用fade動畫效果
11. focus-animation=dim-layer
用來設定聚焦(focused)與不具焦之視窗之效果. 可為dim-layer, none. 若為默認則無動畫被使用.
12. binding-modifier=ctrl
設定於一般綁定(bindings)的維護鍵(modifier key), 例如移動曲面(moving surfaces), 調整大小(resizing), 旋轉(rotating), 切換(switching), 關閉(closing)以及設定視窗透明度, 控制背光(backlight)以及縮放桌面(zooming desktop).
可能的values有: ctrl, alt, super(默認)
13. num-workspaces=6
定義工作空間(workspaces)的數目(為無號整數).
使用者可經由使用binding+F1, F2按鍵們去切換工作空間.
如果這個鍵沒被設定, 則回到一個工作空間(one workspace).
14. cursor-theme=theme
設置游標主題(字串)
15. cursor-size=24
設置游標尺寸(無號整數)
16. lockscreen-icon=path
設置鎖住螢幕圖示(icon)影像的路徑(字串). (tablet shell only)
17. lockscreen=path
設置鎖住螢幕背景影像的路徑(字串). (tablet shell only)
18. homescreen=path
設置家螢幕(home screen)背景影像的路徑(字串). (tablet shell only)
<LAUNCHER SECTION>
可以有多個啟動器(launcher)段落(section)，每個啟動器一個
1. icon=icon
設定圖示(icon)影像的路徑(字串). svg影像目前不支援.
2. path=program
設定程序(program)的路徑, 此程序經由在這個啟動器上點擊以去執行.(字串)
有可能會傳遞參數與環境變數給此程序. 例如:
path=GDK_BACKEND=wayland gnome-terminal --full-screen
<SCREENSAVER SECTION>
screensaver 段落被用來去選擇並排程一個螢幕保護.
此screensaver 段落為可選, 如同所有在這裏面被闡明的條目也都是可選的
1. path=/usr/libexec/weston-screensaver
這指示了編輯器去使用在提供路徑上的被選擇之螢幕保護終端(字串).
如果這一行被遺漏或為註解, 那麼在weston(http://manpages.ubuntu.com/manpages/wily/man1/weston.1.html)裡的螢幕保護即為disabled.
2. duration=600
直到螢幕保護消失之前的時間(單位為秒), 以可節省電量.
<OUTPUT SECTION>
此段落可以為多個, 每一個相對應於一個輸出. 它目前只被drm與x11 backends認可.
1. name=name
設定一個輸出的名稱(字串). backend使用了名稱去識別輸出. 所有X11輸出名稱們由字母X開始.
所有Wayland輸出名稱們由字母WL開始.
對於DRM backend, 可用的輸出名稱被列表在weston-launch裡
用法的範例:
LVDS1 DRM backend, Laptop internal panel no.1
VGA1 DRM backend, VGA connector no.1
X1 X11 backend, X window no.1
WL1 Wayland backend, Wayland window no.1
可看weston-drm(http://manpages.ubuntu.com/manpages/wily/man7/weston-drm.7.html)獲得更多細節
2. mode=mode
設定輸出模式(字串). 模式參數會依據backend去做不同處理.
在X11 backend, 它只設定weston視窗的WIDTHxHEIGHT.
DRM backend接受不同模式:
WIDTHxHEIGHT Resolution size width and height in pixels
preferred Uses the preferred mode
current Uses the current crt controller mode
off Disables the output
可選地, 一個使用者可指定一個modeline, 例如:
173.00 1920 2048 2248 2576 1080 1083 1088 1120 -hsync +vsync
它包含了刷新頻率(refresh rate)(單位為Hz), 水平與垂直解析度, 水平與垂直同步的選項.
程序cvt(http://manpages.ubuntu.com/manpages/wily/man1/cvt.1.html)可提供合適的modeline字串
3. transform=normal
使轉換被提供於螢幕輸出(字串).
轉換鍵可為下列八個字串的其中之一:
normal Normal output.
90 90 degrees clockwise.
180 Upside down.
270 90 degrees counter clockwise.
flipped Horizontally flipped
flipped-90 Flipped and 90 degrees clockwise
flipped-180 Flipped upside down
flipped-270 Flipped and 90 degrees counter clockwise
4. scale=factor
一個整數, 默認為1, 當需要時通常被配置為2, 意味者輸出的比例係數.
支持他的應用程式會用適當比例呈現. 對於其他的應用程式, weston將會經由這個係數去縮放(scale)他們的輸出
輸出使用數值2有著高解析度. 這樣的顯示通常被稱作"HiDPI"或"retina"顯示.
5. seat=name
邏輯位置(seat)名稱為這個輸出應該要去做連結的名稱.
如果這被設定, 那麼位置(seat)的輸入將會被限制在在其上設置有位置(seat)的輸出.
(If this is set then the seat's input will be confined to the output that has the seat set on it. )
此期望為: 這個功能將會被使用在一個multiheaded環境, 且此環境有著多重的輸出輸入配置之一個單一合成器
(The expectation is that this functionality will be used in a multiheaded environment with a single compositor for multiple output and input configurations.)
默認位置(seat)被稱為"default"並且將總是出現. 這個位置(seat)可以如同任何其他一樣被約束(constrained ).
<INPUT-METHOD SECTION>
path=/usr/libexec/weston-keyboard
設置螢幕上螢幕輸入方法之路徑(the path of the on screen keyboard input method) (字串)
<KEYBOARD SECTION>
這個段落包含下列按鍵們:
1. keymap_rules=evdev
設置keymap rule file(字串). 被使用去map layout並且塑造(model)輸入裝置.
2. keymap_model=pc105
設置keymap模型(字串). 請見在 xkeyboard-config裡的Model段落(http://manpages.ubuntu.com/manpages/wily/man7/xkeyboard-config.7.html)
3. keymap_layout=us,de,gb
設置以逗號分隔的鍵盤layout code列表(字串).
請見在 xkeyboard-config裡的Layout段落(http://manpages.ubuntu.com/manpages/wily/man7/xkeyboard-config.7.html)
4. keymap_variant=euro,,intl
設置以逗號分隔的鍵盤layout variant(變體)列表(字串).
變體(variant)的數目必須與layouts的數目相同. 請見在 xkeyboard-config裡的Layout段落.
5. keymap_options=grp:alt_shift_toggle,grp_led:scroll
設置keymap選項(字串). 請見在xkeyboard-config裡的Options段落.(http://manpages.ubuntu.com/manpages/wily/man7/xkeyboard-config.7.html)
6. repeat-rate=40
設定反覆執行按鍵的速度(為字元/秒) (無號整數)
7. repeat-delay=400
設置以milliseconds 為單位的延遲, 此延遲為鍵盤按下直到反覆執行開始(無號整數)
8. numlock-on=false
為支持之backends去設置weston啟動時的numlock之默認狀態
<TERMINAL SECTION>
包含了weston終端應用程式的設定(weston-terminal). 她允許去制定font以及command line介面的shell.
1. font=DejaVu Sans Mono
設置終端的字體(font) (字串).為了一個良好經驗, 它被推薦去使用monospace 字體(fonts).
如果找不到字體，則使用默認字體
2. font-size=14
設置終端字體的尺寸(無號整數)
3. term=xterm-256color
終端shell (字串). 設置$TERM 變量.
<XWAYLAND SECTION>
path=/usr/bin/Xwayland
設置xserver去執行之路徑 (字串)
<SCREEN-SHARE SECTION>
command=/usr/bin/weston --backend=rdp-backend.so --shell=fullscreen-
shell.so --no-clients-resize
為螢幕分享, 去設置命令去開啟一個全螢幕(fullscreen) shell server (字串)
