# Chromium Experimental Resource Table

The `chromium_experimental_resource_table` is an experimental extension that provides different
prototype options to support the WebGPU bindless prototypes.

# Status

This extension is experimental and the syntax is being discussed. No official WebGPU specification
has been written yet.

# Availability

| Platform | Notes |
| SPIR-V | Requires `SPV_EXT_descriptor_indexing` extension and `RuntimeDescriptorArray` capability |
| HLSL | Supported for DXC, not FXC |
| MSL | Supported (TODO determine if there are Metal version restrictions) |
| GLSL | Not supported |

Due to limited availability, this will need an `enable` statement to be used. For this experimental
extension it would be `enable chromium_experimental_resource_table`.

# Specification

## Resource table

The concept of a `Resource Table` is added to WGSL. This is not a type which can be written, or
an address space, but a data table available to use with the `getResource` and `hasResource`
methods. The table is made available by the system and is just accessible.

### `hasResource`
```
@must_use fn hasResource<T>(index: I) -> bool
```
* `I` is an `i32` or `u32`
* `T` is a format-less storage texture (e.g. `texture_storage_2d<f32>`), sampled texture, multisampled
  texture, or depth texture.

`hasResource` returns true if the item a `index` of the resource table is of type `T`.

### `getResource`
```
@must_use fn getResource<T>(index: I) -> T
```
* `I` is an `i32` or `u32`
* `T` is a format-less storage texture (e.g. `texture_storage_2d<f32>`), sampled texture, multisampled
  texture, or depth texture.

`getResource` returns the value in the resource table at `index` of type `T`.

If `index` is outside the bounds of the resource table then a default value of type `T` will be
returned. If the item at `index` is not of type `T` then a default value of type `T` is returned.
Essentially, a value is always returned, it may just be a synthensized default value.

# Example usage

## Resource Table
```
enable chromium_experimental_resource_table;

const kHouseTexture = 0u;

@fragment fn fs() {
    if (hasResource<texture_2d<f32, filterable>>(kHouseTexture)) {
        let tex = textureLoad(getResource<texture_2d<f32, filterable>>(kHouseTexture));
    }
}
```