A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://github.com/gfx-rs/wgpu below:

gfx-rs/wgpu: A cross-platform, safe, pure-Rust graphics API.

wgpu is a cross-platform, safe, pure-rust graphics API. It runs natively on Vulkan, Metal, D3D12, and OpenGL; and on top of WebGL2 and WebGPU on wasm.

The API is based on the WebGPU standard. It serves as the core of the WebGPU integration in Firefox, Servo, and Deno.

Contributors are welcome! See CONTRIBUTING.md for more information.

The repository hosts the following libraries:

The following binaries:

For an overview of all the components in the gfx-rs ecosystem, see the big picture.

Go to https://wgpu.rs/examples/ to play with our examples in your browser. Requires a browser supporting WebGPU for the WebGPU examples.

Rust examples can be found at examples. You can run the examples natively with cargo run --bin wgpu-examples <example>.

If you are new to wgpu and graphics programming, we recommend starting with https://sotrh.github.io/learn-wgpu/.

To run the examples in a browser, run cargo xtask run-wasm. Then open http://localhost:8000 in your browser, and you can choose an example to run. Naturally, in order to display any of the WebGPU based examples, you need to make sure your browser supports it.

To use wgpu in C/C++, you need wgpu-native.

If you are looking for a wgpu C++ tutorial, look at the following:

If you want to use wgpu in other languages, there are many bindings to wgpu-native from languages such as Python, D, Julia, Kotlin, and more. See the list.

We have the Matrix space with a few different rooms that form the wgpu community:

We have a wiki that serves as a knowledge base.

While the core of wgpu is based on the WebGPU standard, we also support extensions that allow for features that the standard does not have yet. For high-level documentation on how to use these extensions, see the individual specifications:

🧪EXPERIMENTAL🧪 APIs are subject to change and may allow undefined behavior if used incorrectly.

API Windows Linux/Android macOS/iOS Web (wasm) Vulkan ✅ ✅ 🌋 Metal ✅ DX12 ✅ OpenGL 🆗 (GL 3.3+) 🆗 (GL ES 3.0+) 📐 🆗 (WebGL2) WebGPU ✅

✅ = First Class Support
🆗 = Downlevel/Best Effort Support
📐 = Requires the ANGLE translation layer (GL ES 3.0 only)
🌋 = Requires the MoltenVK translation layer
🛠️ = Unsupported, though open to contributions

wgpu supports shaders in WGSL, SPIR-V, and GLSL. Both HLSL and GLSL have compilers to target SPIR-V. All of these shader languages can be used with any backend as we handle all of the conversions. Additionally, support for these shader inputs is not going away.

While WebGPU does not support any shading language other than WGSL, we will automatically convert your non-WGSL shaders if you're running on WebGPU.

WGSL is always supported by default, but GLSL and SPIR-V need features enabled to compile in support.

Note that the WGSL specification is still under development, so the draft specification does not exactly describe what wgpu supports. See below for details.

To enable SPIR-V shaders, enable the spirv feature of wgpu. To enable GLSL shaders, enable the glsl feature of wgpu.

Angle is a translation layer from GLES to other backends developed by Google. We support running our GLES3 backend over it in order to reach platforms DX11 support, which aren't accessible otherwise. In order to run with Angle, the "angle" feature has to be enabled, and Angle libraries placed in a location visible to the application. These binaries can be downloaded from gfbuild-angle artifacts, manual compilation may be required on Macs with Apple silicon.

On Windows, you generally need to copy them into the working directory, in the same directory as the executable, or somewhere in your path. On Linux, you can point to them using LD_LIBRARY_PATH environment.

Due to complex dependants, we have two MSRV policies:

It is enforced on CI (in "/.github/workflows/ci.yml") with the CORE_MSRV and REPO_MSRV variables. This version can only be upgraded in breaking releases, though we release a breaking version every three months.

The naga, wgpu-core, wgpu-hal, and wgpu-types crates should never require an MSRV ahead of Firefox's MSRV for nightly builds, as determined by the value of MINIMUM_RUST_VERSION in python/mozboot/mozboot/util.py.

All testing and example infrastructure share the same set of environment variables that determine which Backend/GPU it will run on.

When running the CTS, use the variables DENO_WEBGPU_ADAPTER_NAME, DENO_WEBGPU_BACKEND, DENO_WEBGPU_POWER_PREFERENCE.

We have multiple methods of testing, each of which tests different qualities about wgpu. We automatically run our tests on CI. The current state of CI testing:

Platform/Backend Tests Notes Windows/DX12 ✔️ using WARP Windows/OpenGL ✔️ using llvmpipe MacOS/Metal ✔️ using hardware runner Linux/Vulkan ✔️ using lavapipe Linux/OpenGL ES ✔️ using llvmpipe Chrome/WebGL ✔️ using swiftshader Chrome/WebGPU ❌ not set up

We use a tool called cargo nextest to run our tests. To install it, run cargo install cargo-nextest.

To run the test suite:

To run the test suite on WebGL (currently incomplete):

cd wgpu
wasm-pack test --headless --chrome --no-default-features --features webgl --workspace

This will automatically run the tests using a packaged browser. Remove --headless to run the tests with whatever browser you wish at http://localhost:8000.

If you are a user and want a way to help contribute to wgpu, we always need more help writing test cases.

WebGPU Conformance Test Suite

WebGPU includes a Conformance Test Suite to validate that implementations are working correctly. We run cases from the CTS against wgpu using Deno. A default list of enabled tests is automatically run on pull requests in CI.

To run the default set of CTS tests locally, run:

You can also specify a test selector on the command line:

cargo xtask cts 'webgpu:api,operation,command_buffer,basic:*'

Or supply your own test list in a file:

cargo xtask cts -f your_tests.lst

To find the full list of tests, go to the web version of the CTS.

The version of the CTS used by cargo xtask cts is specified in cts_runner/revision.txt.

Tracking the WebGPU and WGSL draft specifications

The wgpu crate is meant to be an idiomatic Rust translation of the WebGPU API. That specification, along with its shading language, WGSL, are both still in the "Working Draft" phase, and while the general outlines are stable, details change frequently. Until the specification is stabilized, the wgpu crate and the version of WGSL it implements will likely differ from what is specified, as the implementation catches up.

Exactly which WGSL features wgpu supports depends on how you are using it:

wgpu uses the coordinate systems of D3D and Metal:


RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4