diff options
Diffstat (limited to 'sway/sway-output.5.scd')
-rw-r--r-- | sway/sway-output.5.scd | 43 |
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) |