eCidZddlZedkredejddZdeded Zd Zd Zd Z d Z dZ dZ dZ dS)am This "remote port" instructs Emscripten (4.0.10+) how to automatically download the actual port for Emdawnwebgpu. See README below for instructions. # Emdawnwebgpu Emdawnwebgpu is Dawn's implementation of webgpu.h for Emscripten (on top of the WebGPU JS API). It is a fork of Emscripten's original `USE_WEBGPU` bindings, and while it is maintained in Dawn, it works in any browser supporting WebGPU (modulo individual feature support). Emdawnwebgpu provides everything necessary to use `` and the Dawn-style `` with Emscripten. If you find an issue in this release, please download the latest Emdawnwebgpu release (see below) and latest Emscripten and verify the bug, then report it at . ## API Stability Core parts of `webgpu.h` (defined in ) are considered stable APIs and should not change, except for bugfixes (though guarantees are not made). Dawn/Emscripten-specific parts, and all of `webgpu_cpp.h`, are **NOT** considered stable, and may change. ## How to use Emdawnwebgpu Emdawnwebgpu is distributed in several ways. Choose the one that works for you. In all cases, it is important to enable Closure to reduce code size in release builds. Pass the following flag to `emcc` during linking: --closure=1 ### Targeting Web only #### Easiest: "Remote" port built into Emscripten Recent releases of Emscripten vendor a copy of a "remote" port which automatically downloads a pinned version of Emdawnwebgpu and configures it. Pass the following flag to `emcc` during both compilation and linking: --use-port=emdawnwebgpu #### Latest: "Remote" port from Dawn release This is the same as the built-in port, but you can download a newer version if you need recent bugfixes or features in Emdawnwebgpu that haven't been rolled into Emscripten yet. **Requires Emscripten 4.0.10+.** Download and extract the `emdawnwebgpu-*.remoteport.py` file from . Pass the following flag to `emcc` during both compilation and linking: --use-port=path/to/emdawnwebgpu_remoteport_file.py #### Latest, without automatic downloading: "Local" port from Dawn release Use this method if your build system requires sources to be local (e.g. checked into your repository) instead of automatically downloaded, or if you use Emscripten before 4.0.10. **Note that Emdawnwebgpu may not work with older Emscripten releases.** Download and extract the `emdawnwebgpu_pkg-*.zip` package from . (Note the package is text-only and does not contain any binaries, but see below if you need to build the package from the original source.) Pass the following flag to `emcc` during both compilation and linking: --use-port=path/to/emdawnwebgpu_pkg/emdawnwebgpu.port.py If (and only if) using Emscripten before 4.0.7, pass this flag during linking: --closure-args=--externs=path/to/emdawnwebgpu_pkg/webgpu/src/webgpu-externs.js #### Without using a port file (**Unsupported!**) It is possible to integrate the Emdawnwebgpu sources directly into your build process, which may be necessary for certain build systems, but this is not officially supported. Using a port file instead is strongly recommended. If you do this, the port files or Dawn's GN or CMake files can serve as a reference for the steps needed. Note that in all cases, the sources include both C++ and JS code. While it is possible to precompile the C++ code to `.a`, the JS code cannot be precompiled and must be provided at the final link step. ### Cross-targeting Web/Native #### Using CMake Use this method if your project uses CMake and targets both Emscripten and native platforms. #### Building the package locally to use with a non-CMake project If your project already has Dawn source, or you otherwise want to cross-target Web and native with your non-CMake project, you can use CMake to build `emdawnwebgpu_pkg` locally (similar to how you would build binary libraries to link with in native), then use the "Local" port instructions above. ## Port options Options can be set by appending `:key1=value:key2=value` to `--use-port`. For information about port options, run: emcc --use-port=emdawnwebgpu:help emcc --use-port=path/to/emdawnwebgpu_remoteport_file.py:help emcc --use-port=path/to/emdawnwebgpu_pkg/emdawnwebgpu.port.py:help ### C++ bindings By default, C++ bindings are provided in the include path. Note that unlike `webgpu.h`, these are not intended to be fully stable. If you don't want these for any reason (you have custom bindings, you're using a pinned snapshot of `webgpu_cpp.h`, etc.), you can set the option `cpp_bindings=false`: --use-port=emdawnwebgpu:cpp_bindings=false --use-port=path/to/emdawnwebgpu_remoteport_file.py:cpp_bindings=false --use-port=path/to/emdawnwebgpu_pkg/emdawnwebgpu.port.py:cpp_bindings=false ## Embuilder If your build process needs a separate step to build the port before linking, use Emscripten's `embuilder`. Under `embuilder`, some options cannot be set automatically, so they must be set manually. For details, see `OPTIONS` in `emdawnwebgpu.port.py` (in the package zip). N__main__zNPlease see documentation inside this file for details on how to use this port.zv20251002.162335z1https://github.com/google/dawn/releases/download/z/emdawnwebgpu_pkg-z.zipڀed15672c2c495a77c764929e6979f4e155bf8b9c46dee5b0f234f3208a708bc2b846d89eef345b725d03454b56d549531f48fc84ff2afe7627d14115893b0fb0z%emdawnwebgpu_pkg/emdawnwebgpu.port.pyzSome files: BSD 3-Clause License. Other files: Emscripten's license (available under both MIT License and University of Illinois/NCSA Open Source License)z~Emdawnwebgpu implements webgpu.h on WebGPU, replacing -sUSE_WEBGPU. **For info on usage and filing feedback, see link below.**zlhttps://dawn.googlesource.com/dawn/+/01940842b667a7812d0e4ca0ef4367fbec294241/src/emdawnwebgpu/pkg/README.mdc td)Nz(Remote ports require Emscripten 4.0.10+.) Exceptionportssettingsshareds ? ??cdS)Nrs r clearrsDr)__doc__sys__name__printexit_VERSION EXTERNAL_PORTSHA512 PORT_FILELICENSE DESCRIPTIONURLr rrrr rsJJX  z E Z[[[ CHQKKK  oHnn`hnnn  L 3 gO t@@@      r