Weston Display Configuration

Weston picks the default settings for display by itself. If the default settings are insufficient, the display settings can be defined in weston.ini.

To configure the display, add the following to weston.ini with the appropriate values for output name, mode, and transform:

[output]
name=<output_name>
mode=<mode>
transform=<transformation>

Where name=<output_name> sets a name for the output string. The backend uses the name to identify the output.

Output Name	Description
LVDS1	Laptop internal panel number 1.
VGA1	VGA connector number.

The mode=<mode> assignment sets the output mode string. The mode parameter is handled differently depending on the backend. The DRM backend accepts different modes:

Mode	Description
WIDTHxHEIGHT	Resolution size width and height in pixels.
preferred	Uses the preferred mode.
current	Uses the current CRT controller mode.
off	Disables the output.

Optionally, you can specify a modeline, for example:

173.00 1920 2048 2248 2576 1080 1083 1088 1120 -hsync +vsync

A modeline consists of the refresh rate in Hz, the horizontal and vertical resolution, and options for horizontal and vertical synchronization. The cvt(1) program provides a suitable modeline string.

The transform=<transformation> assignment applies the transformation to the screen output string. The transform key must be one of the following 8 strings:

Transform string	Description
normal	Normal output.
90	90 degrees clockwise.
180	Upside down.
270	90 degrees counter clockwise.
flipped	Horizontally flipped.
flipped-90	Flipped and rotated 90 degrees clockwise.
flipped-180	Flipped upside down.
flipped-270	Flipped and 90 degrees counter clockwise.

The following is a weston.ini configuration example:

[output]
name=LVDS1
mode=1680x1050
transform=90
icc_profile=/usr/share/color/icc/colord/Bluish.icc