diff options
Diffstat (limited to 'sway/sway-output.5.scd')
-rw-r--r-- | sway/sway-output.5.scd | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/sway/sway-output.5.scd b/sway/sway-output.5.scd new file mode 100644 index 00000000..fe5b33bc --- /dev/null +++ b/sway/sway-output.5.scd | |||
@@ -0,0 +1,66 @@ | |||
1 | sway-output(5) | ||
2 | |||
3 | # NAME | ||
4 | |||
5 | sway-output - output configuration commands for sway | ||
6 | |||
7 | # DESCRIPTION | ||
8 | |||
9 | You may combine output commands into one, like so: | ||
10 | |||
11 | output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch | ||
12 | |||
13 | You can get a list of output names with *swaymsg -t get\_outputs*. You may also | ||
14 | match any output by using the output name "\*". | ||
15 | |||
16 | # COMMANDS | ||
17 | |||
18 | *output* <name> mode|resolution|res <WIDTHxHEIGHT>[@<RATE>[Hz]] | ||
19 | Configures the specified output to use the given mode. Modes are a | ||
20 | combination of width and height (in pixels) and a refresh rate that your | ||
21 | display can be configured to use. For a list of available modes for each | ||
22 | output, use *swaymsg -t get\_outputs*. | ||
23 | |||
24 | Examples: | ||
25 | |||
26 | output HDMI-A-1 mode 1920x1080 | ||
27 | |||
28 | output HDMI-A-1 mode 1920x1080@60Hz | ||
29 | |||
30 | *output* <name> position|pos <X> <Y> | ||
31 | Places the specified output at the specific position in the global | ||
32 | coordinate space. | ||
33 | |||
34 | *output* <name> scale <factor> | ||
35 | Scales the specified output by the specified scale _factor_. An integer is | ||
36 | recommended, but fractional values are also supported. If a fractional | ||
37 | value are specified, be warned that it is not possible to faithfully | ||
38 | represent the contents of your windows - they will be rendered at the next | ||
39 | highest integral scale factor and downscaled. You may be better served by | ||
40 | setting an integral scale factor and adjusting the font size of your | ||
41 | applications to taste. | ||
42 | |||
43 | *output* <name> background|bg <file> <mode> [<fallback\_color>] | ||
44 | Sets the wallpaper for the given output to the specified file, using the | ||
45 | given scaling mode (one of "stretch", "fill", "fit", "center", "tile"). If | ||
46 | the specified file cannot be accessed or if the image does fill the entire | ||
47 | output, a fallback color may be provided to cover the rest of the output. | ||
48 | __fallback\_color__ should be specified as _#RRGGBB_. Alpha is not | ||
49 | supported. | ||
50 | |||
51 | *output* <name> background|bg <color> solid\_color | ||
52 | Sets the background of the given output to the specified color. _color_ | ||
53 | should be specified as _#RRGGBB_. Alpha is not supported. | ||
54 | |||
55 | *output* <name> transform <transform> | ||
56 | Sets the background transform to the given value. Can be one of "90", "180", | ||
57 | "270" for rotation; or "flipped", "flipped-90", "flipped-180", "flipped-270" | ||
58 | to apply a rotation and flip, or "normal" to apply no transform. | ||
59 | |||
60 | *output* <name> disable|enable | ||
61 | Enables or disables the specified output (all outputs are enabled by | ||
62 | default). | ||
63 | |||
64 | # SEE ALSO | ||
65 | |||
66 | *sway*(5) *sway-input*(5) | ||