mirror of
				https://github.com/swaywm/sway.git
				synced 2025-11-03 09:01:43 -05:00 
			
		
		
		
	Document updates to the output command
This commit is contained in:
		
							parent
							
								
									583c30dbe3
								
							
						
					
					
						commit
						669f91b991
					
				
					 1 changed files with 20 additions and 11 deletions
				
			
		| 
						 | 
					@ -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:
 | 
				
			||||||
	+
 | 
						+
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue