Open-Source Wikis

/

wgpu

/

Crates

/

wgpu-info

gfx-rs/wgpu

wgpu-info

wgpu-info (wgpu-info/) is a small CLI tool that enumerates GPU adapters and prints their capabilities. It's invaluable when debugging "why doesn't this feature work on this machine?" issues.

Purpose

  • Enumerate every adapter that wgpu can see on the current machine, across every compiled-in backend.
  • For each adapter, print the AdapterInfo, the supported Features, the Limits, and the DownlevelCapabilities.
  • Let users attach the output to bug reports.

Directory layout

wgpu-info/
├── Cargo.toml
├── README.md
└── src/                 small CLI

Run it

cargo run -p wgpu-info

You can filter by backend with WGPU_BACKEND=vulkan, by adapter name with WGPU_ADAPTER_NAME=..., etc.

What you'll see

For each adapter, the tool prints:

  • Adapter info — vendor, device, driver version, backend, device type (discrete / integrated / virtual / cpu).
  • Features — the bitflag set of wgt::Features the adapter supports.
  • Limits — every wgt::Limits field with the adapter's actual value.
  • Downlevel capabilitiesDownlevelFlags and DownlevelLimits.
  • Format support — for each TextureFormat, the TextureFormatFeatures (filterable, blendable, storage usage, multisample counts, ...).

Integration points

  • Above: developer / CI / bug reporters.
  • Below: wgpu directly. wgpu-info is not part of the runtime path; it's a diagnostic tool.

Entry points for modification

Add a new Features or Limits field — wgpu-info's formatter probably needs an entry for it. The tool's source is small (a few hundred lines); adding a new section is straightforward.

Built by Factory AutoWiki from public repository content. It is a generated preview for codebase exploration, not source-maintained documentation.

wgpu-info – wgpu wiki | Factory