Crate wgc 

Available on crate feature unstable-wgpu-26 only.

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

See documentation for the wgpu crate for more in-depth information on these features.

Logging Configuration

• 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.

Runtime Checks

• 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.

Debugging

• observe_locks — Enable lock order observation.

Serialization

• serde — Enables serialization via serde on common wgpu types.
• trace — Enable API tracing.
• replay — Enable API replaying

Surface Support

• raw-window-handle — Enable creating surfaces using raw-window-handle

Shading Language Support

• wgsl — Enable ShaderModuleSource::Wgsl
• glsl — Enable ShaderModuleSource::Glsl
• spirv — Enable ShaderModuleSource::SpirV

Other

• 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.
• fragile-send-sync-non-atomic-wasm — Implement Send and Sync on Wasm, but only if atomics are not enabled.
• std (enabled by default) — Enable certain items to be Send and Sync when they would not otherwise be. Also enables backtraces in some error cases when also under cfg(debug_assertions).

External libraries

The following features facilitate integration with third-party supporting libraries.

• static-dxc — Enable using the mach-dxcompiler-rs crate to compile DX12 shaders.
• portable-atomic — Enable portable atomics on platforms that do not support 64bit atomics.

Target Conditional Features

• dx12 — DX12 backend
• metal — Metal backend
• vulkan — Vulkan backend, only available on Windows, Linux, Android
• gles — OpenGL backend, only available on Windows, Linux, Android, and Emscripten
• webgl — WebGL backend, only available on Emscripten
• angle — OpenGL backend, on macOS only
• vulkan-portability — Vulkan portability backend, only available on macOS
• renderdoc — Renderdoc integration, only available on Windows, Linux, and Android
• noop — Enable the noop backend.

Modules

api

binding_model

command

device

error

global

hal_api

hub

Allocating resource ids, and tracking the resources they refer to.

id

identity

instance

naga

Naga can be used to translate source code written in one shading language to another.

pipeline

present

Presentation.

ray_tracing

registry

resource

storage

validation

Macros

impl_labeled

impl_parent_device

impl_resource_type

impl_storage_item

impl_trackable

Constants

MAX_BIND_GROUPS

MAX_COLOR_ATTACHMENTS

MAX_VERTEX_BUFFERS

Functions

hal_label

map_storage_format_from_naga

map_storage_format_to_naga

Type Aliases

Label

RawString

SubmissionIndex

The index of a queue submission.