diff options
author | Lorn Potter <lorn.potter@gmail.com> | 2021-09-15 11:28:04 +1000 |
---|---|---|
committer | Qt Cherry-pick Bot <cherrypick_bot@qt-project.org> | 2021-10-08 05:55:47 +0000 |
commit | e6ec644c85fc99fc348c5c80f5d5a6de3db44671 (patch) | |
tree | 5275ee8add4fd57bab5934d456f52b291355a706 | |
parent | 41202b055655ac5aae5a04e6f735c9e69e111e19 (diff) |
wasm: add configuration documentation
This briefly documents the use for simd, threads,
source maps and opengles3
Change-Id: I7cc87e4b0704baf73360295f53168234f69e0f26
Reviewed-by: Morten Johan Sørvig <morten.sorvig@qt.io>
(cherry picked from commit 31cc0424b673c4fdd06dbec8f9e679b121d34b14)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-rw-r--r-- | doc/src/platforms/webasm.qdoc | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/src/platforms/webasm.qdoc b/doc/src/platforms/webasm.qdoc index 978a85b01..355cf62e0 100644 --- a/doc/src/platforms/webasm.qdoc +++ b/doc/src/platforms/webasm.qdoc @@ -173,6 +173,31 @@ This generates the following files: \sa {WebAssembly Resource site},{Getting Started with Qt for WebAssembly}, {Remote UIs with WebGL and WebAssembly} +\section3 Additional configuration + Qt for Webassembly has several additional configuration arguments available. +\table + \header + \li Configure Argument + \li Brief Description + \row + \li -sse2 + \li This enables autovectorization and Wasm SIMD support by adding the compiler argument -msimd128. In addition, emulated + and native optcode SSE instructions are utilized (at which point Qt's SSE code paths will also be used). + SSE1, SSE2, SSE3, SSSE3, SSE4.1, SSE4.2, and 128-bit AVX instructions only. Simd support may need to be enabled + in browsers advanced configurations, such as 'about:config' or 'chrome:flags'. There may be performance + issues when used with certain SIMD instructions that are emulated and that have no native optcode supported by the browser. + For more information see https://emscripten.org/docs/porting/simd.html + \row + \li -feature-thread + \li Multi-threaded wasm + \row + \li -device-option QT_WASM_SOURCE_MAP=1 + \li Debugging option for creating source maps + \row + \li -feature-opengles3 + \li Use opengles3 in addition to the default opengles2 +\endtable + \section1 Test-run your application You can test-run your application in the following way: |