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