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

183 commits

Author SHA1 Message Date
Stephen Gutekanst
835f93fb53 gpu: update defaults/optionality for RenderPassDescriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
158ba8db59 gpu: correct nullable slice / _count-ed pointers (bug in Dawn docs) 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
937d0120a3 gpu: update defaults/optionality for ColorTargetState/VertexState 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
1b146cffd3 gpu: update ComputePassDescriptor defaults/optionality 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
b5601d69e6 gpu: add RequestAdapterOptions defaults 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
a8022775a9 gpu: add createInstance, getProcAddress 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
84f0a1c4b3 gpu: add CreateRenderPipelineAsyncCallback 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
4bf198b35e gpu: add CreateComputePipelineAsyncCallback 
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
2d6dbd3351 gpu: add getProcAddress 
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
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
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
2fa5e5adf4 gpu: add RenderPassDescriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
7a8f1b0cf9 gpu: add ComputePassDescriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
b90658aba8 gpu: add RequestAdapterOptions 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
a91186c2c9 gpu: add RenderPassTimestampWrite 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
eead8fd29c gpu: add RenderPassDescriptorMaxDrawCount 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
1f9bb8078f gpu: add RenderPassDepthStencilAttachment 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
4fc752723c gpu: add MultisampleState 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
5094ad2e72 gpu: add dawn.CacheDeviceDescriptor 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
2877121147 gpu: add CopyTextureForBrowserOptions 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
bb399b5050 gpu: add ComputePassTimestampWrite 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
9f77103cae gpu: make TextureView an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
05f153009d gpu: make Texture an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
2a65690ffc gpu: make SwapChain an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
94ca8ffe35 gpu: make Surface an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
4413860d92 gpu: make ShaderModule an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
40306320f6 gpu: make Sampler an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
64d973faf7 gpu: make RenderPipeline an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
8148b59907 gpu: make RenderPassEncoder an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
e4706f778d gpu: make RenderBundleEncoder an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
6fcb70b295 gpu: make RenderBundle an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
068b829384 gpu: make Queue an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
f521c4c9dd gpu: make QuerySet an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
51c5a8cf25 gpu: make PipelineLayout an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
1fefc7e66b gpu: make Instance an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
81b8caa48c gpu: make ExternalTexture an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
58602f7407 gpu: make Device an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
62a991090a gpu: make ComputePipeline an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
e42554fc3f gpu: make ComputePassEncoder an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
df0f827851 gpu: make CommandEncoder an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
9ff6409d73 gpu: make CommandBuffer an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
7563a18ca3 gpu: make BindGroupLayout an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00
Stephen Gutekanst
138847d425 gpu: make BindGroup an enum with methods 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
 2022-08-12 00:43:43 -07:00