系列博客总目录:https://segmentfault.com/a/1190000040716735


阐明

WebGPU 的标准是通过 WebIDL 语言来形容的,本篇次要介绍类型定义。

函数定义、继承形容较为简单,故略去。

用于定义类型的语法有以下五种。

enum

枚举类型,通常其枚举值就是 JavaScript 字符串,取值时合乎外面的任意一个即可。

enum GPUTextureDimension {  "1d",  "2d",  "3d",};

于是,你能够在创立纹理对象时这样用这个枚举:

const texture = device.createTexture({  /* ... */  dimension: "2d", // <- dimension 字段是 GPUTextureDimension 类型})

你要是传 "36d" 那就不适合了。

namespace

须要通过 Namespace.XXX 拜访,通常是二进制数字值,也算是一种枚举吧。

typedef [EnforceRange] unsigned long GPUBufferUsageFlags;[Exposed=(Window, DedicatedWorker)]namespace GPUBufferUsage {  const GPUFlagsConstant MAP_READ      = 0x0001;  const GPUFlagsConstant MAP_WRITE     = 0x0002;  const GPUFlagsConstant COPY_SRC      = 0x0004;  const GPUFlagsConstant COPY_DST      = 0x0008;  const GPUFlagsConstant INDEX         = 0x0010;  const GPUFlagsConstant VERTEX        = 0x0020;  const GPUFlagsConstant UNIFORM       = 0x0040;  const GPUFlagsConstant STORAGE       = 0x0080;  const GPUFlagsConstant INDIRECT      = 0x0100;  const GPUFlagsConstant QUERY_RESOLVE = 0x0200;};

那么创立一个 GPUBuffer 时,它的 usage 字段就能够这么设置:

const buffer = device.createBuffer({  usage: GPUBufferUsage.UNIFORM,  /* ... */})

因为字面量是二进制数字值,所以能够用位运算来实现多种类型并设:

const buffer = device.createBuffer({  usage: GPUBufferUsage.VERTEX | GPUBufferUsage.MAP_WRITE,  /* ... */})

如果有敌人喜爱背书的,能够把它们的数值熟记于心,而后间接用字面值赋值也不是不能够(然而,真的很蠢)。

interface

interface 通常有一个对应的 JavaScript Class,大多数是通过设施对象创立而来(通道编码器、适配器等则不是)。

大多数在浏览器 window 环境和专用型 WebWorker 下能够获取到。

大多数须要一个对应的 descriptor,即 JavaScript Object 作为参数。

const adapter = await navigator.gpu.requestAdapter()console.log(adapter instanceof GPUAdapter) // true

创立行为:

const device = await adapter.requestDevice()const getBuffer = (desc: GPUBufferDescriptor): GPUBuffer => {  return device.createBuffer(desc)}const buffer = getBuffer({ /* ... */ })

尽管下面这两段 typescript 代码有点蠢,然而足够阐明 interface 了。

dictionary

一个 dictionary 代表一个 JavaScript Object。

// typescriptconst bufferEntry: GPUBindGroupLayoutEntry = {  binding: 0,  visibility: GPUShaderStage.VERTEX,  buffer: { /* 全副默认,代表 UBO */ }}

有时候示意一种 descriptor,有时候代表 descriptor 中某个字段的值。

typedef

定义一种数字类型的别名,相似 C 语言中的宏定义。

typedef [EnforceRange] unsigned long GPUBufferDynamicOffset;typedef [EnforceRange] unsigned long GPUStencilValue;typedef [EnforceRange] unsigned long GPUSampleMask;typedef [EnforceRange] long GPUDepthBias;typedef [EnforceRange] unsigned long long GPUSize64;typedef [EnforceRange] unsigned long GPUIntegerCoordinate;typedef [EnforceRange] unsigned long GPUIndex32;typedef [EnforceRange] unsigned long GPUSize32;typedef [EnforceRange] long GPUSignedOffset32;typedef unsigned long GPUFlagsConstant;

次要用到的有这些类型。

数字类型解释
unsigned longUInt32,占 4bytes
unsigned long longUInt64,占 8bytes
longUInt16,占 2bytes
floatFloat32,占 4bytes
doubleFloat64,占 8bytes