Crate wgpu_core

Expand description

This library safely implements WebGPU on native platforms. It is designed for integration into browsers, as well as wrapping into other language-specific user-friendly libraries.

§Feature flags

counters — Internally count resources and events for debugging purposes. If the counters feature is disabled, the counting infrastructure is removed from the build and the exposed counters always return 0.
api_log_info — Log all API entry points at info instead of trace level. Also, promotes certain debug log calls to info.
resource_log_info — Log resource lifecycle management at info instead of trace level.
renderdoc — Support the Renderdoc graphics debugger: https://renderdoc.org/
strict_asserts — Apply run-time checks, even in release builds. These are in addition to the validation carried out at public APIs in all builds.
indirect-validation — Validates indirect draw/dispatch calls. This will also enable naga’s WGSL frontend since we use a WGSL compute shader to do the validation.
serde — Enables serialization via serde on common wgpu types.
trace — Enable API tracing.
observe_locks — Enable lock order observation.
replay — Enable API replaying
raw-window-handle — Enable creating instances using raw-window-handle
wgsl — Enable ShaderModuleSource::Wgsl
glsl — Enable ShaderModuleSource::Glsl
spirv — Enable ShaderModuleSource::SpirV
fragile-send-sync-non-atomic-wasm — Implement Send and Sync on Wasm, but only if atomics are not enabled.

WebGL/WebGPU objects can not be shared between threads. However, it can be useful to artificially mark them as Send and Sync anyways to make it easier to write cross-platform code. This is technically very unsafe in a multithreaded environment, but on a wasm binary compiled without atomics we know we are definitely not in a multithreaded environment.

§Backends, passed through to wgpu-hal

metal — Enable the metal backend.
vulkan — Enable the vulkan backend.
gles — Enable the GLES backend.

This is used for all of GLES, OpenGL, and WebGL.
dx12 — Enable the dx12 backend.