zig/mach
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
1839 commits 2 branches 0 tags 11 MiB
Commit graph

1839 commits

This branch
This branch
All branches
Author SHA1 Message Date
Stephen Gutekanst
60496259b2 gpu: add Adapter.enumerateFeatures 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
4d5809cc16 gpu: correct refAllDeclsRecursive usage 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
5b0ae990e3 gpu: add Adapter.createDevice and comptime interface strategy 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
2d6dbd3351 gpu: add getProcAddress 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
c0ad349a12 gpu: convert Texture from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
7f952545b9 gpu: convert TextureView from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
5c5990a84f gpu: convert SwapChain from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
b95f0cc41a gpu: convert Surface from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
8719bab867 gpu: convert ShaderModule from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
34edad6a2c gpu: convert Sampler from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
cb8c874536 gpu: convert RenderPipeline from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
26d2aa0099 gpu: convert RenderPassEncoder from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
7acc5798d9 gpu: convert RenderBundle from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
4ff2e96efd gpu: convert RenderBundleEncoder from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
8932f53841 gpu: convert Queue from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
3d0051e720 gpu: convert QuerySet from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
d50bc3527b gpu: convert PipelineLayout from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
1d07d1784e gpu: convert ExternalTexture from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
4e045ff45d gpu: convert Device from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
9fd454407a gpu: convert ComputePipeline from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
ad1122882a gpu: convert ComputePassEncoder from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
05dbde311b gpu: convert CommandEncoder from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
0c1a15a804 gpu: convert CommandBuffer from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
ca21c4fa80 gpu: convert Buffer from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
9b28403d9d gpu: convert BindGroup from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
48dbfc9f55 gpu: convert BindGroupLayout from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
f7df77e2d2 gpu: convert Adapter from enum(usize) to *opaque 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
311ea3f62c gpu: usingnamespace all object types 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
2a09bec5de gpu: make use of usingnamespace 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
5741082848 gpu: begin switching from enum(usize) to opaque pointers 
WebGPU objects, like say `WGPUTexture`, could be represented in one of two ways:

1. As an `enum(usize)` as we were doing previously
2. As an `*opaque` pointer

In `webgpu.h` natively, `void*` opaque pointers are used. However, WebGPU objects are not
actually pointers: they are just IDs. A concrete example of this is how it is almost always
valid to for example pass a `WGPUTexture` that has been freed into the API. Doing so does
not result in undefined behavior, instead the implementation considers the texture to be an
ID and since it can't find such an ID it knows that texture has been free'd and to generate
an error instead of undefined behavior. In this regard, we can say that `enum(usize)` is the
more faithful representation.

`enum(usize)` is not without issues, though: it cannot effectively represent nullability in
Zig, which is used in the `webgpu.h` C ABI to represent _optionality_. `?enum(usize)` is not
a valid exported C type, the Zig compiler rejects it. And so in practice to maintain C ABI
compatability with descriptor struct types (which we do not want to copy or bitcast), we must
represent nullability with a `null` value:

```zig
pub const Texture = enum(usize) {
    _,

    pub const null: Texture = @intToEnum(Texture, 0);

    pub const Descriptor = extern struct {
        next_in_chain: *const ChainedStruct,
    };

    pub fn init() Texture {
        return Texture.null;
    }
};
```

The downside to this is that `init` cannot return a clear optional `?Texture`, and instead
must return a `Texture` which may be `== .null`. This downside seems significant enough to
warrant _not_ going with `enum(usize)` and instead going with `*opaque`:

```zig
pub const Texture = *opaque {
    pub fn init() ?Texture { return null }
};

pub const TextureDescriptor = extern struct {
    next_in_chain: *const ChainedStruct,
};
```

The downside to `*opaque` is that the namespace cannot have types nested below it.
`gpu.Texture.Descriptor` becomes `gpu.TextureDescriptor`.

Not ideal, but a tradeoff we'll accept to be able to represent optionality with the actual
Zig type system.

Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
7f6cb8b511 gpu: add comptime gpu.Interface, gpu.Export for C ABI exports 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
2ccf510696 gpu: use std.testing.refAllDeclsRecursive(@This()); 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
fd948f4e8c gpu: correct extern declarations 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
616395c583 gpu: add RenderPipeline.Descriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
122713a44d gpu: add FragmentState 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
1632a5305e gpu: add VertexState 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
2fa5e5adf4 gpu: add RenderPassDescriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
8484d47e78 gpu: add Device.Descriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
286cbb6160 gpu: add ComputePipeline.Descriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
44d378e102 gpu: add ColorTargetState 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
5b66e3fbe0 gpu: add BindGroupLayout.Descriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
26a29e1b2a gpu: add VertexBufferLayout 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
ed1232f59d gpu: add Texture.Descriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
7f8dedcbd5 gpu: add SupportedLimits 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
cb68331f6c gpu: add RequiredLimits 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
ad6d037d8f gpu: add RenderPassColorAttachment 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
8683fa8aa9 gpu: add ProgrammableStageDescriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
74b7e66793 gpu: add ImageCopyTexture 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
326d66127e gpu: add ImageCopyBuffer 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
9b615f212d gpu: add DepthStencilState 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00