chromium/src
0
Fork 0
Code Activity

Remove legacy SwiftShader GL from documentation

Browse Source 
Legacy SwiftShader GL is deprecated, so remove it from existing
documentation, so that only SwANGLE related documentation remains.

Bug: chromium:1060139
Change-Id: I1a59d7b4a57f80cbe627df0a77430450296df607
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/3452836
Reviewed-by: Kenneth Russell <kbr@chromium.org>
Commit-Queue: Alexis Hétu <sugoi@google.com>
Cr-Commit-Position: refs/heads/main@{#969936}
This commit is contained in:
Alexis Hetu
2022-02-11 14:35:59 +00:00
committed by Chromium LUCI CQ
parent 0beffe9f20
commit 8c54b0b7e3
3 changed files with 2 additions and 19 deletions

2
docs/chromeos_build_instructions.md

@ -135,7 +135,7 @@ testing it through Chromium Remote Desktop you might face drawing
problems (e.g. Aura window not painting anything). Possible remedies:
* `--ui-enable-software-compositing --ui-disable-threaded-compositing`
* `--use-gl=swiftshader`, but it's slow.
* `--use-gl=angle --use-angle=swiftshader`, but it's slow.
To more closely match the UI used on devices, you can install fonts used
by Chrome OS, such as Roboto, on your Linux distro.

1
docs/gpu/gpu_testing.md

@ -341,7 +341,6 @@ of all suites and resulting step names as of April 15th 2021:
* `webgl_conformance_gles_passthrough_tests`
* `webgl_conformance_metal_passthrough_tests`
* `webgl_conformance_swangle_passthrough_tests`
* `webgl_conformance_swiftshader_validating_tests`
* `webgl_conformance_tests`
* `webgl_conformance_validating_tests`
* `webgl_conformance_vulkan_passthrough_tests`

18
docs/gpu/swiftshader.md

@ -12,18 +12,6 @@ When Chromium uses SwiftShader as the OpenGL ES driver, Chromium behaves as if i
When Chromium uses SwiftShader as the WebGL fallback, Chromium runs in all software mode and only uses SwiftShader to render WebGL content.
SwiftShader also provides 2 different libraries:
1) **The legacy SwiftShader Open GL ES libraries**
Legacy SwiftShader includes a GLES library and an EGL library, in order to provide a complete solution to run OpenGL ES content.
*Do not use these libraries if possible, they are being phased out in favor of SwANGLE (ANGLE + SwiftShader Vulkan).*
2) **The SwiftShader Vulkan library**
SwiftShader Vulkan can be used both to render Vulkan content directly, or OpenGL ES content when use in conjunction with the ANGLE library.
## Relevant Chromium command line switches
When running the **chrome** executable from the command line, SwiftShader can be enabled using the following Switches:
@ -31,9 +19,5 @@ When running the **chrome** executable from the command line, SwiftShader can be
>**\-\-use-gl=angle \-\-use-angle=swiftshader**
2) As the WebGL fallback, SwANGLE (ANGLE + SwiftShader Vulkan)
>**\-\-use-gl=angle \-\-use-angle=swiftshader-webgl**
3) As the OpenGL ES driver, legacy SwiftShader Open GL ES libraries
> **\-\-use-gl=swiftshader**
4) As the WebGL fallback, legacy SwiftShader Open GL ES libraries
>**\-\-use-gl=swiftshader-webgl**
5) As the Vulkan driver (requires the [enable_swiftshader_vulkan](https://source.chromium.org/chromium/chromium/src/+/main:gpu/vulkan/features.gni;l=16) feature)
3) As the Vulkan driver (requires the [enable_swiftshader_vulkan](https://source.chromium.org/chromium/chromium/src/+/main:gpu/vulkan/features.gni;l=16) feature)
>**--use-vulkan=swiftshader**