Document updates to the output command

This commit is contained in:
Drew DeVault 2018-02-25 11:35:31 -05:00
parent 583c30dbe3
commit 669f91b991

View file

@ -353,35 +353,44 @@ The default colors are:
Prevents windows matching <criteria> from being focused automatically when Prevents windows matching <criteria> from being focused automatically when
they're created. This does not apply to the first window in a workspace. they're created. This does not apply to the first window in a workspace.
**output** <name> <resolution|res> <WIDTHxHEIGHT>:: **output** <name> mode|resolution|res <WIDTHxHEIGHT>[@<RATE>[Hz]]::
Configures the specified output to use the given resolution. Configures the specified output to use the given mode. Modes are a combination
of width and height (in pixels) and a refresh rate that your display can be
configured to use. For a list of available modes, use swaymsg -t get_outputs.
+ +
_Note_: sway does not currently support setting the output mode. Your output's native Examples:
resolution will be used and the screen will be scaled from the resolution +
specified to your native resolution. output HDMI-A-1 mode 1920x1080
+
output HDMI-A-1 mode 1920x1080@60Hz
**output** <name> <position|pos> <X,Y>:: **output** <name> position|pos <X,Y>::
Configures the specified output to be arranged at the given position. Configures the specified output to be arranged at the given position.
**output** <name> <scale> <I>:: **output** <name> scale <I>::
Configures the specified output to be scaled up by the specified integer Configures the specified output to be scaled up by the specified integer
scaling factor (usually 2 for HiDPI screens). scaling factor (usually 2 for HiDPI screens). Fractional scaling is supported.
**output** <name> <background|bg> <file> <mode>:: **output** <name> background|bg <file> <mode>::
Sets the wallpaper for the given output to the specified file, using the given Sets the wallpaper for the given output to the specified file, using the given
scaling mode (one of "stretch", "fill", "fit", "center", "tile"). scaling mode (one of "stretch", "fill", "fit", "center", "tile").
**output** <name> <background|bg> <color> solid_color:: **output** <name> background|bg <color> solid_color::
Sets the background of the given output to the specified color. _color_ should Sets the background of the given output to the specified color. _color_ should
be specified as an _#rrggbb_ (no alpha) color. be specified as an _#rrggbb_ (no alpha) color.
**output** <name> transform <transform>::
Sets the background transform to the given value. Can be one of "90", "180",
"270" for rotation; or "flipped", "flipped-90", "flipped-180", "flipped-270"
to apply a rotation and flip, or "normal" to apply no transform.
**output** <name> disable:: **output** <name> disable::
Disables the specified output. Disables the specified output.
**NOTES FOR THE OUTPUT COMMAND**:: **NOTES FOR THE OUTPUT COMMAND**::
You may combine output commands into one, like so: You may combine output commands into one, like so:
+ +
output HDMI-A-1 res 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch output HDMI-A-1 mode 1920x1080 pos 1920,0 bg ~/wallpaper.png stretch
+ +
You can get a list of output names like so: You can get a list of output names like so:
+ +