1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-24 22:01:47 +03:00
wezterm/docs
Wez Furlong b7e303f39c Windows: prefer to use Direct3D11 via ANGLE
This is similar in spirit to the work in 4d71a7913a
but for Windows.

This commit adds ANGLE binaries built from
07ea804e62
to the repo.  The build and packaging will copy those into the same
directory as wezterm.exe so that they can be resolved at runtime.

By default, `prefer_egl = true`, which will cause the window
crate to first try to load an EGL implementation.  If that fails,
or if `prefer_egl = false`, then the window crate will perform
the usual WGL initialization.

The practical effect of this change is that Direct3D11 is used for the
underlying render, which avoids problematic OpenGL drivers and means
that the process can survive graphics drivers being updated.

It may also increase the chances that the GPU will really be used
in an RDP session rather than the pessimised use of the software
renderer.

The one downside that I've noticed is that the resize behavior feels a
little janky in comparison to WGL (frames can render with mismatched
surface/window sizes which makes the window contents feel like they're
zooming/rippling slightly as the window is live resized). I think this
is specific to the ANGLE D3D implementation as EGL on other platforms
feels more solid.

I'm a little on the fence about making this the default; I think
it makes sense to prefer something that won't quit unexpectedly
while a software update is in progress, so that's a strong plus
in favor of EGL as the default, but I'm not sure how much the
resize wobble is going to set people off.

If you prefer WGL and are fine with the risk of a drive update
killing wezterm, then you can set this in your config:

```lua
return {
  prefer_egl = false,
}
```

refs: https://github.com/wez/wezterm/issues/265
closes: https://github.com/wez/wezterm/issues/156
2020-10-17 19:08:16 -07:00
..
config docs: changelog and info on dead keys on Windows 2020-10-16 12:13:30 -07:00
install docs: fix typo 2020-07-18 10:16:51 -07:00
screenshots add launch_menu section to the configuration 2020-04-11 17:31:55 -07:00
_config.yml docs: switch to the "Hacker" theme which is darker 2019-12-18 09:25:36 -08:00
book.toml default to darker styling 2019-12-29 22:05:49 -08:00
changelog.markdown Windows: prefer to use Direct3D11 via ANGLE 2020-10-17 19:08:16 -07:00
contributing.markdown docs: link to the contributing file in the repo 2020-06-20 13:09:04 -07:00
copymode.markdown docs: update released version info for some newer features 2020-06-17 00:08:43 -07:00
custom.css style download buttons a bit better 2019-12-29 21:39:23 -08:00
faq.markdown docs: add some input troubleshooting info the FAQ 2020-06-25 07:15:57 -07:00
features.markdown docs: add splits/panes to features list 2020-10-10 10:52:15 -07:00
help.markdown docs: add a bit about contributing 2020-06-16 22:16:56 -07:00
hyperlinks.markdown docs: update for lua configuration syntax 2020-04-06 16:32:16 -07:00
imgcat.markdown add screenshot of imgcat 2019-12-31 18:33:24 -08:00
index.markdown docs: add splits/panes to features list 2020-10-10 10:52:15 -07:00
installation.markdown docs: split install page into pages by platform 2020-05-30 10:30:32 -07:00
lua.js docs: enable syntax highlighting for lua 2020-04-06 17:39:57 -07:00
multiplexing.markdown docs: more changelog updates 2020-10-13 20:26:27 -07:00
scrollback.markdown docs: update released version info for some newer features 2020-06-17 00:08:43 -07:00
serial.markdown docs: update for lua configuration syntax 2020-04-06 16:32:16 -07:00
shell-integration.markdown docs: more tweaks 2020-04-07 08:45:57 -07:00
ssh.markdown docs: update for lua configuration syntax 2020-04-06 16:32:16 -07:00