From 9a69791586a9a4f6ab7fd267c9f8df3ac02ae477 Mon Sep 17 00:00:00 2001 From: Liz Upton Date: Tue, 16 Jan 2024 16:53:48 +0000 Subject: [PATCH] CE Also removed TODO about manually setting rotation under X. --- .../configuration/display-resolution.adoc | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/documentation/asciidoc/computers/configuration/display-resolution.adoc b/documentation/asciidoc/computers/configuration/display-resolution.adoc index a935232f71..7394a8bf7a 100644 --- a/documentation/asciidoc/computers/configuration/display-resolution.adoc +++ b/documentation/asciidoc/computers/configuration/display-resolution.adoc @@ -1,21 +1,23 @@ == Setting your display's resolution and rotation -If you find yourself in circumstances where the Raspberry Pi may not be able to determine the best mode, or you specifically wish to set a non-default resolution, you can manually set the resolution or rotation. The method for doing this depends on whether you're booting to the desktop environment or booting to the CLI (text console). +If you find yourself in a situation where the Raspberry Pi may not be able to determine the best mode, or you specifically wish to set a non-default resolution, you can set the resolution or rotation manually. The method for doing this depends on whether you're booting to the desktop environment or booting to the CLI (text console). === Setting the desktop environment resolution and rotation -If you are running the Raspberry Pi desktop then the resolution or rotation is most easily changed by using the `Screen Configuration` utility from the desktop `Preferences` menu. This will bring up a graphical representation of the display or displays connected to the Raspberry Pi. Right click on the display you wish to modify and select the required option(s) before clicking `Apply`. +If you are using the Raspberry Pi desktop, the resolution or rotation is most easily changed by selecting the `Screen Configuration` utility from the desktop `Preferences` menu. This will bring up a graphical representation of the display or displays connected to the Raspberry Pi. Right click on the display you wish to modify, and select the required option(s) before clicking `Apply`. -NOTE: If you are using the X11 backend, you need to ensure that you close the Screen Configuration utility in order to save the changes you've made. If you don't do this, the changes you made will be "forgotten" when you reboot. +NOTE: If you are using the X11 backend, you need to ensure that you close the Screen Configuration utility in order to save the changes you've made. If you don't do this, the changes you made will be forgotten when you reboot. + +It is also possible to change these settings by editing config files, although the method for doing this depends on whether you're running the Wayland or X11 backend. Open a Terminal window and type: -It is also possible to change these settings by editing config files, although the method for doing this depends on whether you're running the Wayland or X11 backend. Type [,bash] ---- ps ax | grep [w]ayfire ---- -into a Terminal window, and if you get `/usr/bin/wayfire` displayed then you're running Wayland, and if you get no output you're running X11. -NOTE: In the current version of Raspberry Pi OS Bookworm, Raspberry Pi 4 and 400 default to using Wayland to display the desktop environment; whereas earlier models of Raspberry Pi default to using X11 to display the desktop environment. +If you see `/usr/bin/wayfire` displayed then you're running Wayland; and if you get no output you're running X11. + +NOTE: In the current version of Raspberry Pi OS Bookworm, Raspberry Pi 5, Raspberry Pi 4 and Raspberry Pi 400 default to using Wayland to display the desktop environment. Earlier models of Raspberry Pi default to using X11 to display the desktop environment. ==== Manually setting the desktop environment resolution and rotation for Wayland @@ -26,6 +28,7 @@ mode = 1920x1080@60 ---- The `` part of the `output:` line (`HDMI-A-1` in the example shown here) matches the display options <>. + The `mode` line is _similar_ to that used by KMS, but slightly different. Consult the https://github.com/WayfireWM/wayfire-wiki/blob/master/Configuration.md#output-configuration[Wayfire documentation] for more extensive information. You can also rotate your display by adding a `transform` line like: @@ -37,9 +40,7 @@ transform = 270 where the allowable `transform` options are: `normal`, `90`, `180` and `270`. -If you've set Raspberry Pi OS to boot to desktop but *not* auto-login, then you'll also need to edit `/usr/share/greeter.ini` as this determines the resolution and rotation used by the login screen. This file has the same format as `.config/wayfire.ini` described earlier, so again you'll need to add or edit the `[output:]` section. - -// TODO: ==== Manually setting the desktop environment resolution and rotation for X11 +If you've set Raspberry Pi OS to boot to desktop but are *not* using auto-login, then you'll also need to edit `/usr/share/greeter.ini`, which determines the resolution and rotation used by the login screen. This file has the same format as `.config/wayfire.ini` described earlier, so again you'll need to add or edit the `[output:]` section. === Setting the text console resolution and rotation