407: Build Docs with Nightly r=kvark a=cwfitzgerald
This builds docs with nightly by default. We use intra-doc links which is currently only supported with nightly. docs.rs also uses the latest nightly to build our code, so this will match behavior with docs.rs. I added a fallback to stable in case nightly has issues so we still have working docs.
Co-authored-by: Connor Fitzgerald <connorwadefitzgerald@gmail.com>
395: First Phase of Tracing Transition r=kvark a=cwfitzgerald
## Connections
This is the wgpu-rs component of https://github.com/gfx-rs/wgpu/pull/740.
## Notable Changes
- Added annotations for non-trivial wrapper functions
- Enabled building all features on docs.rs
- Took a dep on tracing.
- Fixes an assert that randomly stopped compiling.
- Added env variable WGPU_CHROME_TRACING which will be a path to the output chrome trace, if the feature is enabled.
- Added feature which corresponds directly to wgc feature.
Co-authored-by: Connor Fitzgerald <connorwadefitzgerald@gmail.com>
401: Readme updates about the Gecko branch r=grovesNL a=kvark
402: Re-enable auto-deploy from gecko branch r=kvark a=grovesNL
As mentioned on Matrix, the `gecko` branch should be safe to use for auto-deployment to GitHub pages for the wgpu-rs examples on wasm.
We can use the `gecko` branch for now and eventually switch back to `master`.
Co-authored-by: Dzmitry Malyshau <kvarkus@gmail.com>
Co-authored-by: Joshua Groves <josh@joshgroves.com>
396: Update wgpu without peek-poke r=cwfitzgerald a=kvark
Depends on https://github.com/gfx-rs/wgpu/pull/739
Everything works, however I think it's worth changing the render pass color/depth/stencil descriptors to be more rusty, e.g.
```rust
struct ColorAttachmentDescriptor {
attachment: &'a TextureView,
resolve_target: Option<&'a TextureView>,
clear_color: Option<Color>,
store_result: bool,
}
enum DepthStencilChannel<T> {
ReadOnly,
Mutable { clear_value: Option<T>, store_result: bool },
}
struct DepthStencilAttachmentDescriptor {
}
```
This would also involve wgpu-type/wgpu-core changes, but can be done as a follow-up (don't want to block on them).
There is a value in doing it in this PR, so that end users don't get multiple disruptions, but we need to find a proper shape first.
Co-authored-by: Dzmitry Malyshau <kvarkus@gmail.com>
391: Change `include_spirv` macro to accept tokens r=cwfitzgerald a=neachdainn
The `include_spirv` macros was set to accept literals only. Unfortunately, this means that other macros, such as `concat` and `env` aren't accepted, making it unusable with build script-compiled shaders. This change allows those macros to be used to load the SpirV at the expense of a potentially less helpful error message as the `literal` requirement is differed to the `include_bytes` invocation.
Co-authored-by: Nathan Kent <nkent2@cs.rochester.edu>
The `include_spirv` macros was set to accept literals only.
Unfortunately, this means that other macros, such as `concat` and `env`
aren't accepted, making it unusable with build script-compiled shaders.
This change allows those macros to be used to load the SpirV at the
expense of a potentially less helpful error message as the `literal`
requirement is differed to the `include_bytes` invocation.
390: Example feature matrix r=cwfitzgerald a=kvark
This PR introduces a feature matrix to show what feature can be found in which example. I expect we'll be linking to it a lot :)
It also renames the `describe` example so that we can distinguish easily between ones that are framework-based and standalone ones (starting with "hello").
Concerns:
- the star may be a bit too bleak... I haven't found a better one that would be short to type (choosing a long one means editing is uncomfortable).
- sometimes hard to figure out what deserves a feature in the table and what not... still a win to have at least something here
- we need to do something with `capture`, see #387, but I haven't figured out what exactly
also r? @rukai
Co-authored-by: Dzmitry Malyshau <kvarkus@gmail.com>
380: Documentation Pass r=kvark a=cwfitzgerald
The wgpu-rs component of https://github.com/gfx-rs/wgpu/pull/728.
Closes#378.
Notable changes not mentioned in wgpu PR:
- Reexported the wgt-local types whenever we have a type definition. These are reexported as `ThingBase`. This is unfortunately the only way to actually get their documentation to show up, aliases have no way of "inheriting" the documentation.
- Added wgpu logo to docs!
- Hid vertex_format_size macro.
Co-authored-by: Connor Fitzgerald <connorwadefitzgerald@gmail.com>
377: Update with minBufferBindingSize r=cwfitzgerald a=kvark
Depends on https://github.com/gfx-rs/wgpu/pull/726
Also reverts #373 : buffer bindings now have to include at least one element of an unsized struct portion, so they can't be zero-sized.
Co-authored-by: Dzmitry Malyshau <kvarkus@gmail.com>
375: Add water example. r=kvark,cwfitzgerald a=OptimisticPeach
Solves #329, water example requested by @kvark.
I tuned it to my personal preference of visuals, however it might be different for you.
Note: I used https://github.com/ashima/webgl-noise for 3D open simplex noise.
I've commented to explain what most of the things in the rust side of the example mean. However, I'm not 100% sure I did the best job at giving a brief overview, and wouldn't mind someone making sure my terminology/definitions are correct.
Thanks!
Patrik
Co-authored-by: OptimisticPeach <patrikbuhring@yahoo.com>
369: Implement SAMPLED_TEXTURE_ARRAY_NON_UNIFORM_INDEXING r=kvark a=cwfitzgerald
This implements https://github.com/gfx-rs/wgpu/pull/715 in wgpu-rs. I haven't changed the example, as I want to actually think up a better example to use and didn't want that to block this. It will change in the future however.
Co-authored-by: Connor Fitzgerald <connorwadefitzgerald@gmail.com>
370: API update for RODS2 r=cwfitzgerald a=kvark
Reflects upstream changes in https://github.com/gfx-rs/wgpu/pull/716
I'm not too happy about the API just yet, has another idea that I'm going to discuss with the group on Monday, hopefully. But we need to get going and not block other wgpu-rs changes, so this should land in some way.
Co-authored-by: Dzmitry Malyshau <dmalyshau@mozilla.com>
360: Implement TEXTURE_BINDING_ARRAY extension r=kvark a=cwfitzgerald
This extends https://github.com/gfx-rs/wgpu/pull/711 into wgpu-rs.
Notable changes:
- Added an example showing off both this extension and the future descriptor indexing extension.
- Changed the framework so there is a static function showing what extensions you need. This is provided by the trait,, which defaults to no extensions, so existing examples and new ones don't have to care about extensions.
Co-authored-by: Connor Fitzgerald <connorwadefitzgerald@gmail.com>
356: Add generic ranges to buffer mapping api and make it safe. r=kvark a=lachlansneff
[Rendered](https://charted.space/notes/wgpu-rs/wgpu/struct.Buffer.html)
The safety issues with the current api (being able to unmap while still holding a slice to mapped data) are fixed by having `get_mapped_range` and `get_mapped_range_mut` return `BufferView` and `BufferViewMut`, which notify the buffer that those ranges are no longer being used when they're dropped. `Buffer.unmap` asserts that the list of mapped ranges is empty, therefore it is safe.
Co-authored-by: Lachlan Sneff <lachlan.sneff@gmail.com>
