aboutsummaryrefslogtreecommitdiffstats
path: root/sway/sway-output.5.scd
diff options
context:
space:
mode:
Diffstat (limited to 'sway/sway-output.5.scd')
-rw-r--r--sway/sway-output.5.scd43
1 files changed, 38 insertions, 5 deletions
diff --git a/sway/sway-output.5.scd b/sway/sway-output.5.scd
index 69f529fe..028cb7ab 100644
--- a/sway/sway-output.5.scd
+++ b/sway/sway-output.5.scd
@@ -24,7 +24,7 @@ must be separated by one space. For example:
24 24
25# COMMANDS 25# COMMANDS
26 26
27*output* <name> mode|resolution|res [--custom] <WIDTHxHEIGHT>[@<RATE>Hz] 27*output* <name> mode|resolution|res [--custom] <width>x<height>[@<rate>Hz]
28 Configures the specified output to use the given mode. Modes are a 28 Configures the specified output to use the given mode. Modes are a
29 combination of width and height (in pixels) and a refresh rate that your 29 combination of width and height (in pixels) and a refresh rate that your
30 display can be configured to use. For a list of available modes for each 30 display can be configured to use. For a list of available modes for each
@@ -40,6 +40,16 @@ must be separated by one space. For example:
40 40
41 output HDMI-A-1 mode 1920x1080@60Hz 41 output HDMI-A-1 mode 1920x1080@60Hz
42 42
43*output* <name> modeline <clock> <hdisplay> <hsync_start> <hsync_end> <htotal> <vdisplay> <vsync_start> <vsync_end> <vtotal> <hsync> <vsync>
44 Configures the specified output to use the given modeline. It can be
45 generated using *cvt*(1) and *gtf*(1) commands. See *xorg.conf*(5).
46 Only supported on DRM backend.
47
48 Example:
49
50 output HDMI-A-1 modeline 173.00 1920 2048 2248 2576 1080 1083 1088 1120 -hsync +vsync
51
52
43*output* <name> position|pos <X> <Y> 53*output* <name> position|pos <X> <Y>
44 Places the specified output at the specific position in the global 54 Places the specified output at the specific position in the global
45 coordinate space. The cursor may only be moved between immediately 55 coordinate space. The cursor may only be moved between immediately
@@ -109,12 +119,20 @@ must be separated by one space. For example:
109 Enables or disables the specified output (all outputs are enabled by 119 Enables or disables the specified output (all outputs are enabled by
110 default). 120 default).
111 121
122 As opposed to the _power_ command, the output will lose its current
123 workspace and windows.
124
112*output* <name> toggle 125*output* <name> toggle
113 Toggle the specified output. 126 Toggle the specified output.
114 127
115*output* <name> dpms on|off 128*output* <name> power on|off|toggle
116 Enables or disables the specified output via DPMS. To turn an output off 129 Turns on or off the specified output.
117 (ie. blank the screen but keep workspaces as-is), one can set DPMS to off. 130
131 As opposed to the _enable_ and _disable_ commands, the output keeps its
132 current workspaces and windows.
133
134*output* <name> dpms on|off|toggle
135 Deprecated. Alias for _power_.
118 136
119*output* <name> max_render_time off|<msec> 137*output* <name> max_render_time off|<msec>
120 Controls when sway composites the output, as a positive number of 138 Controls when sway composites the output, as a positive number of
@@ -142,11 +160,26 @@ must be separated by one space. For example:
142 Enables or disables adaptive synchronization (often referred to as Variable 160 Enables or disables adaptive synchronization (often referred to as Variable
143 Refresh Rate, or by the vendor-specific names FreeSync/G-Sync). 161 Refresh Rate, or by the vendor-specific names FreeSync/G-Sync).
144 162
145 Adaptive sync allows clients to submit frames a little to late without 163 Adaptive sync allows clients to submit frames a little too late without
146 having to wait a whole refresh period to display it on screen. Enabling 164 having to wait a whole refresh period to display it on screen. Enabling
147 adaptive sync can improve latency, but can cause flickering on some 165 adaptive sync can improve latency, but can cause flickering on some
148 hardware. 166 hardware.
149 167
168*output* <name> render_bit_depth 8|10
169 Controls the color channel bit depth at which frames are rendered; the
170 default is currently 8 bits per channel.
171
172 Setting higher values will not have an effect if hardware and software lack
173 support for such bit depths. Successfully increasing the render bit depth
174 will not necessarily increase the bit depth of the frames sent to a display.
175 An increased render bit depth may provide smoother rendering of gradients,
176 and screenshots which can more precisely store the colors of programs
177 which display high bit depth colors.
178
179 Warnings: this can break screenshot/screencast programs which have not been
180 updated to work with different bit depths. This command is experimental,
181 and may be removed or changed in the future.
182
150# SEE ALSO 183# SEE ALSO
151 184
152*sway*(5) *sway-input*(5) 185*sway*(5) *sway-input*(5)