/** * @file WebGPU 的声明文件 https://www.w3.org/TR/2023/WD-webgpu-20230322/ * */ type GPUPowerPreference = 'low-power' | 'high-performance' type GPUFeatureName = 'depth-clip-control' | 'depth32float-stencil8' | 'texture-compression-bc' | 'texture-compression-etc2' | 'texture-compression-astc' | 'timestamp-query' | 'indirect-first-instance' | 'shader-f16' | 'rg11b10ufloat-renderable' | 'float32-filterable' type GPUBufferMapState = 'unmapped' | 'pending' | 'mapped' type GPUTextureAspect = 'all' | 'stencil-only' | 'depth-only' type GPUTextureDimension = '1d' | '2d' | '3d' type GPUTextureViewDimension = GPUTextureDimension | '2d-array' | 'cube' | 'cube-array' type GPUAddressMode = 'clamp-to-edge' | 'repeat' | 'mirror-repeat' type GPUFilterMode = 'nearest' | 'linear' type GPUMipmapFilterMode = 'nearest' | 'linear' type GPUBufferBindingType = 'uniform' | 'storage' | 'read-only-storage' type GPUSamplerBindingType = 'filtering' | 'non-filtering' | 'comparison' type GPUTextureSampleType = 'float' | 'unfilterable-float' | 'depth' | 'sint' | 'uint' type GPUStorageTextureAccess = 'write-only' type GPUAutoLayoutMode = 'auto' type GPUCompilationMessageType = 'error' | 'warning' | 'info' type GPUVertexStepMode = 'vertex' | 'instance' type GPUPrimitiveTopology = 'point-list' | 'line-list' | 'line-strip' | 'triangle-list' | 'triangle-strip' type GPUFrontFace = 'ccw' | 'cw' type GPUIndexFormat = 'uint16' | 'uint32' type GPUCullMode = 'none' | 'front' | 'back' type GPUStencilOperation = 'keep' | 'zero' | 'replace' | 'invert' | 'increment-clamp' | 'decrement-clamp' | 'increment-wrap' | 'decrement-wrap' type GPUBlendOperation = 'add' | 'subtract' | 'reverse-subtract' | 'min' | 'max' type GPUBlendFactor = 'zero' | 'one' | 'src' | 'one-minus-src' | 'src-alpha' | 'one-minus-src-alpha' | 'dst' | 'one-minus-dst' | 'dst-alpha' | 'one-minus-dst-alpha' | 'src-alpha-saturated' | 'constant' | 'one-minus-constant' /** * load 保存之前的颜色缓冲区 * clear 清除之前的延时缓冲区 */ type GPULoadOp = 'load' | 'clear' /** * store 保存绘制之后的颜色缓冲区 * discard 丢弃绘制之后的延时缓冲区 */ type GPUStoreOp = 'store' | 'discard' type GPUQueryType = /** * 遮挡查询 */ 'occlusion' /** * 时间戳查询 */ | 'timestamp' type GPURenderPassTimestampLocation = 'beginning' | 'end' type GPUComputePassTimestampLocation = 'beginning' | 'end' type GPUCanvasAlphaMode = 'opaque' | 'premultiplied' type GPUSize64 = number type GPUIndex32 = number type GPUSize32 = number type GPUSignedOffset32 = number type GPUBufferDynamicOffset = number type GPUStencilValue = number type GPUSampleMask = number type GPUDepthBias = number type GPUIntegerCoordinate = number type GPUFlagsConstant = number type GPUPipelineConstantValue = number interface GPUColorDict { r: number g: number b: number a: number } type GPUColor = number[] | GPUColorDict type GPUCompareFunction = 'never' | 'less' | 'equal' | 'less-equal' | 'greater' | 'not-equal' | 'greater-equal' | 'always' type GPUExtent3D = GPUIntegerCoordinate[] | { width: GPUIntegerCoordinate height?: GPUIntegerCoordinate depthOrArrayLayers?: GPUIntegerCoordinate } type GPUOrigin2D = GPUIntegerCoordinate[] | { x?: GPUIntegerCoordinate y?: GPUIntegerCoordinate } type GPUOrigin3D = GPUIntegerCoordinate[] | { x?: GPUIntegerCoordinate y?: GPUIntegerCoordinate z?: GPUIntegerCoordinate } type GPUTextureFormat = // 8-bit formats 'r8unorm' | 'r8snorm' | 'r8uint' | 'r8sint' // 16-bit formats | 'r16uint' | 'r16sint' | 'r16float' | 'rg8unorm' | 'rg8snorm' | 'rg8uint' | 'rg8sint' // 32-bit formats | 'r32uint' | 'r32sint' | 'r32float' | 'rg16uint' | 'rg16sint' | 'rg16float' | 'rgba8unorm' | 'rgba8unorm-srgb' | 'rgba8snorm' | 'rgba8uint' | 'rgba8sint' | 'bgra8unorm' | 'bgra8unorm-srgb' // Packed 32-bit formats | 'rgb9e5ufloat' | 'rgb10a2unorm' | 'rg11b10ufloat' // 64-bit formats | 'rg32uint' | 'rg32sint' | 'rg32float' | 'rgba16uint' | 'rgba16sint' | 'rgba16float' // 128-bit formats | 'rgba32uint' | 'rgba32sint' | 'rgba32float' // Depth/stencil formats | 'stencil8' | 'depth16unorm' | 'depth24plus' | 'depth24plus-stencil8' | 'depth32float' // "depth32float-stencil8" feature | 'depth32float-stencil8' /* * BC compressed formats usable if "texture-compression-bc" is both * supported by the device/user agent and enabled in requestDevice. */ | 'bc1-rgba-unorm' | 'bc1-rgba-unorm-srgb' | 'bc2-rgba-unorm' | 'bc2-rgba-unorm-srgb' | 'bc3-rgba-unorm' | 'bc3-rgba-unorm-srgb' | 'bc4-r-unorm' | 'bc4-r-snorm' | 'bc5-rg-unorm' | 'bc5-rg-snorm' | 'bc6h-rgb-ufloat' | 'bc6h-rgb-float' | 'bc7-rgba-unorm' | 'bc7-rgba-unorm-srgb' /* * ETC2 compressed formats usable if "texture-compression-etc2" is both * supported by the device/user agent and enabled in requestDevice. */ | 'etc2-rgb8unorm' | 'etc2-rgb8unorm-srgb' | 'etc2-rgb8a1unorm' | 'etc2-rgb8a1unorm-srgb' | 'etc2-rgba8unorm' | 'etc2-rgba8unorm-srgb' | 'eac-r11unorm' | 'eac-r11snorm' | 'eac-rg11unorm' | 'eac-rg11snorm' /* * ASTC compressed formats usable if "texture-compression-astc" is both * supported by the device/user agent and enabled in requestDevice. */ | 'astc-4x4-unorm' | 'astc-4x4-unorm-srgb' | 'astc-5x4-unorm' | 'astc-5x4-unorm-srgb' | 'astc-5x5-unorm' | 'astc-5x5-unorm-srgb' | 'astc-6x5-unorm' | 'astc-6x5-unorm-srgb' | 'astc-6x6-unorm' | 'astc-6x6-unorm-srgb' | 'astc-8x5-unorm' | 'astc-8x5-unorm-srgb' | 'astc-8x6-unorm' | 'astc-8x6-unorm-srgb' | 'astc-8x8-unorm' | 'astc-8x8-unorm-srgb' | 'astc-10x5-unorm' | 'astc-10x5-unorm-srgb' | 'astc-10x6-unorm' | 'astc-10x6-unorm-srgb' | 'astc-10x8-unorm' | 'astc-10x8-unorm-srgb' | 'astc-10x10-unorm' | 'astc-10x10-unorm-srgb' | 'astc-12x10-unorm' | 'astc-12x10-unorm-srgb' | 'astc-12x12-unorm' | 'astc-12x12-unorm-srgb' type GPUVertexFormat = | 'uint8x2' | 'uint8x4' | 'sint8x2' | 'sint8x4' | 'unorm8x2' | 'unorm8x4' | 'snorm8x2' | 'snorm8x4' | 'uint16x2' | 'uint16x4' | 'sint16x2' | 'sint16x4' | 'unorm16x2' | 'unorm16x4' | 'snorm16x2' | 'snorm16x4' | 'float16x2' | 'float16x4' | 'float32' | 'float32x2' | 'float32x3' | 'float32x4' | 'uint32' | 'uint32x2' | 'uint32x3' | 'uint32x4' | 'sint32' | 'sint32x2' | 'sint32x3' | 'sint32x4' interface GPURequestAdapterOptions { powerPreference?: GPUPowerPreference forceFallbackAdapter?: boolean } interface GPUSupportedLimits { readonly maxTextureDimension1D: number readonly maxTextureDimension2D: number readonly maxTextureDimension3D: number readonly maxTextureArrayLayers: number readonly maxBindGroups: number readonly maxBindingsPerBindGroup: number readonly maxDynamicUniformBuffersPerPipelineLayout: number readonly maxDynamicStorageBuffersPerPipelineLayout: number readonly maxSampledTexturesPerShaderStage: number readonly maxSamplersPerShaderStage: number readonly maxStorageBuffersPerShaderStage: number readonly maxStorageTexturesPerShaderStage: number readonly maxUniformBuffersPerShaderStage: number readonly maxUniformBufferBindingSize: number readonly maxStorageBufferBindingSize: number readonly minUniformBufferOffsetAlignment: number readonly minStorageBufferOffsetAlignment: number readonly maxVertexBuffers: number readonly maxBufferSize: number readonly maxVertexAttributes: number readonly maxVertexBufferArrayStride: number readonly maxInterStageShaderComponents: number readonly maxInterStageShaderVariables: number readonly maxColorAttachments: number readonly maxColorAttachmentBytesPerSample: number readonly maxComputeWorkgroupStorageSize: number readonly maxComputeInvocationsPerWorkgroup: number readonly maxComputeWorkgroupSizeX: number readonly maxComputeWorkgroupSizeY: number readonly maxComputeWorkgroupSizeZ: number readonly maxComputeWorkgroupsPerDimension: number } interface GPUObjectDescriptorBase { label?: string } interface GPUObjectBase { label: string } interface GPUQueueDescriptor extends GPUObjectDescriptorBase { } interface GPUDeviceDescriptor extends GPUObjectDescriptorBase { requiredFeatures?: GPUFeatureName[] requiredLimits?: Record defaultQueue?: GPUQueueDescriptor } interface GPUAdapterInfo { readonly vendor: string readonly architecture: string readonly device: string readonly description: string } type GPUSupportedFeatures = Map interface GPUCommandBuffer extends GPUObjectBase { } declare enum GPUBufferUsage { MAP_READ = 0x0001, MAP_WRITE = 0x0002, COPY_SRC = 0x0004, COPY_DST = 0x0008, INDEX = 0x0010, VERTEX = 0x0020, UNIFORM = 0x0040, STORAGE = 0x0080, INDIRECT = 0x0100, QUERY_RESOLVE = 0x0200 } enum GPUMapModeFlags { READ = 0x0001, WRITE = 0x0002 } declare enum GPUTextureUsage { COPY_SRC = 0x01, COPY_DST = 0x02, TEXTURE_BINDING = 0x04, STORAGE_BINDING = 0x08, RENDER_ATTACHMENT = 0x10 } interface GPUBuffer extends GPUObjectBase { readonly size: GPUSize64 readonly usage: GPUBufferUsage readonly mapState: GPUBufferMapState mapAsync(mode: GPUMapModeFlags, offset?: GPUSize64, size?: GPUSize64): Promise getMappedRange(offset?: GPUSize64, size?: GPUSize64): ArrayBuffer unmap(): void destroy(): void } interface GPUTextureViewDescriptor extends GPUObjectDescriptorBase { format?: GPUTextureFormat dimension?: GPUTextureViewDimension aspect?: GPUTextureAspect baseMipLevel?: GPUIntegerCoordinate mipLevelCount?: GPUIntegerCoordinate baseArrayLayer?: GPUIntegerCoordinate arrayLayerCount?: GPUIntegerCoordinate } interface GPUTextureView extends GPUObjectBase { } interface GPUTexture extends GPUObjectBase { readonly width: GPUIntegerCoordinate readonly height: GPUIntegerCoordinate readonly depthOrArrayLayers: GPUIntegerCoordinate readonly mipLevelCount: GPUIntegerCoordinate readonly sampleCount: GPUSize32 readonly dimension: GPUTextureDimension readonly format: GPUTextureFormat readonly usage: number createView(descriptor?: GPUTextureViewDescriptor): GPUTextureView destroy(): void } interface GPUImageCopyTexture { texture: GPUTexture mipLevel?: number origin?: GPUOrigin3D aspect?: GPUTextureAspect } interface GPUImageDataLayout { offset?: GPUSize64 bytesPerRow?: GPUSize32 rowsPerImage?: GPUSize32 } interface GPUImageCopyExternalImage { source: ImageBitmap | HTMLVideoElement | HTMLCanvasElement | OffscreenCanvas | VideoFrame origin?: GPUOrigin2D flipY?: boolean } interface GPUImageCopyTextureTagged extends GPUImageCopyTexture { colorSpace?: string premultipliedAlpha?: boolean } interface GPUQueue extends GPUObjectBase { submit(commandBuffers: GPUCommandBuffer[]): void onSubmittedWorkDone(): Promise writeBuffer( buffer: GPUBuffer, bufferOffset: GPUSize64, data: BufferSource, dataOffset?: GPUSize64, size?: GPUSize64 ): void writeTexture( destination: GPUImageCopyTexture, data: BufferSource, dataLayout: GPUImageDataLayout, size: GPUExtent3D ): void copyExternalImageToTexture( source: GPUImageCopyExternalImage, destination: GPUImageCopyTextureTagged, copySize: GPUExtent3D ): void } interface GPUBufferDescriptor extends GPUObjectDescriptorBase { size: GPUSize64 usage: number mappedAtCreation?: boolean } interface GPUTextureDescriptor extends GPUObjectDescriptorBase { size: GPUExtent3D format: GPUTextureFormat usage: number mipLevelCount?: GPUIntegerCoordinate sampleCount?: GPUSize32 dimension?: GPUTextureDimension viewFormats?: GPUTextureFormat[] } interface GPUSamplerDescriptor extends GPUObjectDescriptorBase { addressModeU?: GPUAddressMode addressModeV?: GPUAddressMode addressModeW?: GPUAddressMode magFilter?: GPUFilterMode minFilter?: GPUFilterMode mipmapFilter?: GPUMipmapFilterMode lodMinClamp?: number lodMaxClamp?: number compare?: GPUCompareFunction maxAnisotropy?: number } interface GPUSampler extends GPUObjectBase {} interface GPUExternalTextureDescriptor extends GPUObjectDescriptorBase { source: HTMLVideoElement | VideoFrame colorSpace?: string } interface GPUExternalTexture extends GPUObjectBase { readonly expired: boolean } declare enum GPUShaderStage { VERTEX = 0x1, FRAGMENT = 0x2, COMPUTE = 0x4 } interface GPUBufferBindingLayout { type?: GPUBufferBindingType hasDynamicOffset?: boolean minBindingSize?: GPUSize64 } interface GPUSamplerBindingLayout { type?: GPUSamplerBindingType } interface GPUTextureBindingLayout { sampleType?: GPUTextureSampleType viewDimension?: GPUTextureViewDimension multisampled?: boolean } interface GPUStorageTextureBindingLayout { access?: GPUStorageTextureAccess format: GPUTextureFormat viewDimension?: GPUTextureViewDimension } interface GPUExternalTextureBindingLayout {} interface GPUBindGroupLayoutEntry { binding: GPUIndex32 visibility: GPUShaderStage buffer?: GPUBufferBindingLayout sampler?: GPUSamplerBindingLayout texture?: GPUTextureBindingLayout storageTexture?: GPUStorageTextureBindingLayout externalTexture?: GPUExternalTextureBindingLayout } interface GPUBindGroupLayoutDescriptor extends GPUObjectDescriptorBase { entries: GPUBindGroupLayoutEntry[] } interface GPUBindGroupLayout extends GPUObjectBase {} interface GPUPipelineLayoutDescriptor extends GPUObjectDescriptorBase { bindGroupLayouts: GPUBindGroupLayout[] } interface GPUPipelineLayout extends GPUObjectBase {} interface GPUBufferBinding { buffer: GPUBuffer offset?: GPUSize64 size?: GPUSize64 } type GPUBindingResource = GPUSampler | GPUTextureView | GPUBufferBinding | GPUExternalTexture interface GPUBindGroupEntry { binding: GPUIndex32 resource: GPUBindingResource } interface GPUBindGroupDescriptor extends GPUObjectDescriptorBase { layout: GPUBindGroupLayout entries: GPUBindGroupEntry[] } interface GPUBindGroup extends GPUObjectBase {} interface GPUShaderModuleCompilationHint { layout?: GPUPipelineLayout | GPUAutoLayoutMode } interface GPUShaderModuleDescriptor extends GPUObjectDescriptorBase { code: string sourceMap?: Object hints?: Record } interface GPUCompilationMessage { readonly message: string readonly type: GPUCompilationMessageType readonly lineNum: number readonly linePos: number readonly offset: number readonly length: number } interface GPUCompilationInfo { readonly messages: GPUCompilationMessage[] } interface GPUShaderModule extends GPUObjectBase { compilationInfo(): Promise } interface GPUProgrammableStage { module: GPUShaderModule entryPoint: string constants?: Record } interface GPUPipelineDescriptorBase extends GPUObjectDescriptorBase { layout: GPUPipelineLayout | GPUAutoLayoutMode } interface GPUComputePipelineDescriptor extends GPUPipelineDescriptorBase { compute: GPUProgrammableStage } interface GPUPipelineBase { getBindGroupLayout(index: number): GPUBindGroupLayout } interface GPUComputePipeline extends GPUObjectBase, GPUPipelineBase {} interface GPUVertexAttribute { format: GPUVertexFormat offset: GPUSize64 shaderLocation: GPUIndex32 } interface GPUVertexBufferLayout { arrayStride: number stepMode?: GPUVertexStepMode attributes: GPUVertexAttribute[] } interface GPUVertexState extends GPUProgrammableStage { buffers: GPUVertexBufferLayout[] } interface GPUPrimitiveState { topology?: GPUPrimitiveTopology stripIndexFormat?: GPUIndexFormat frontFace?: GPUFrontFace cullMode?: GPUCullMode unclippedDepth?: boolean } interface GPUStencilFaceState { compare?: GPUCompareFunction failOp?: GPUStencilOperation depthFailOp?: GPUStencilOperation passOp?: GPUStencilOperation } interface GPUDepthStencilState { format: GPUTextureFormat depthWriteEnabled?: boolean depthCompare?: GPUCompareFunction stencilFront?: GPUStencilFaceState stencilBack?: GPUStencilFaceState stencilReadMask?: GPUStencilValue stencilWriteMask?: GPUStencilValue depthBias?: GPUDepthBias depthBiasSlopeScale?: number depthBiasClamp?: number } interface GPUMultisampleState { count?: GPUSize32 mask?: GPUSampleMask alphaToCoverageEnabled?: boolean } interface GPUBlendComponent { operation?: GPUBlendOperation srcFactor?: GPUBlendFactor dstFactor?: GPUBlendFactor } interface GPUBlendState { color: GPUBlendComponent alpha: GPUBlendComponent } declare enum GPUColorWrite { RED = 0x1, GREEN = 0x2, BLUE = 0x4, ALPHA = 0x8, ALL = 0xF } interface GPUColorTargetState { format: GPUTextureFormat blend?: GPUBlendState writeMask?: number } interface GPUFragmentState extends GPUProgrammableStage { targets: GPUColorTargetState[] } interface GPURenderPipelineDescriptor extends GPUPipelineDescriptorBase { vertex: GPUVertexState primitive?: GPUPrimitiveState depthStencil?: GPUDepthStencilState multisample?: GPUMultisampleState fragment?: GPUFragmentState } interface GPURenderPipeline extends GPUObjectBase, GPUPipelineBase {} interface GPUCommandEncoderDescriptor extends GPUObjectDescriptorBase {} interface GPUCommandsMixin {} interface GPUDebugCommandsMixin { pushDebugGroup(groupLabel: number): void popDebugGroup(): void insertDebugMarker(markerLabel: number): void } interface GPURenderPassColorAttachment { view: GPUTextureView resolveTarget?: GPUTextureView clearValue?: GPUColor loadOp: GPULoadOp storeOp: GPUStoreOp } interface GPURenderPassDepthStencilAttachment { view: GPUTextureView depthClearValue?: number depthLoadOp?: GPULoadOp depthStoreOp?: GPUStoreOp depthReadOnly?: boolean stencilClearValue?: GPUStencilValue stencilLoadOp?: GPULoadOp stencilStoreOp?: GPUStoreOp stencilReadOnly?: boolean } interface GPUQuerySet extends GPUObjectBase { destroy(): void readonly type: GPUQueryType readonly count: GPUSize32 } interface GPURenderPassTimestampWrite { querySet: GPUQuerySet queryIndex: GPUSize32 location: GPURenderPassTimestampLocation } type GPURenderPassTimestampWrites = GPURenderPassTimestampWrite[] interface GPURenderPassDescriptor extends GPUObjectDescriptorBase { colorAttachments: GPURenderPassColorAttachment[] depthStencilAttachment?: GPURenderPassDepthStencilAttachment occlusionQuerySet?: GPUQuerySet timestampWrites?: GPURenderPassTimestampWrites maxDrawCount?: GPUSize64 } interface GPUBindingCommandsMixin { setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsets?: GPUBufferDynamicOffset[]): void setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsetsData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void } interface GPURenderCommandsMixin { setPipeline(pipeline: GPURenderPipeline): void setIndexBuffer(buffer: GPUBuffer, indexFormat: GPUIndexFormat, offset?: GPUSize64, size?: GPUSize64): void setVertexBuffer(slot: GPUIndex32, buffer: GPUBuffer, offset?: GPUSize64, size?: GPUSize64): void draw(vertexCount: GPUSize32, instanceCount?: GPUSize32, firstVertex?: GPUSize32, firstInstance?: GPUSize32): void drawIndexed(indexCount: GPUSize32, instanceCount?: GPUSize32, firstIndex?: GPUSize32, baseVertex?: GPUSignedOffset32, firstInstance?: GPUSize32): void drawIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void drawIndexedIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void } interface GPURenderBundle extends GPUObjectBase {} interface GPURenderPassEncoder extends GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin, GPURenderCommandsMixin { setViewport(x: number, y: number, width: number, height: number, minDepth: number, maxDepth: number): void setScissorRect( x: GPUIntegerCoordinate, y: GPUIntegerCoordinate, width: GPUIntegerCoordinate, height: GPUIntegerCoordinate ): void setBlendConstant(color: GPUColor): void setStencilReference(reference: GPUStencilValue): void beginOcclusionQuery(queryIndex: GPUSize32): void endOcclusionQuery(): void executeBundles(bundles: GPURenderBundle[]): void end(): void } interface GPUComputePassTimestampWrite { querySet: GPUQuerySet queryIndex: GPUSize32 location: GPUComputePassTimestampLocation } type GPUComputePassTimestampWrites = GPUComputePassTimestampWrite[] interface GPUComputePassDescriptor extends GPUObjectDescriptorBase { timestampWrites?: GPUComputePassTimestampWrites } interface GPUComputePassEncoder extends GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin { setPipeline(pipeline: GPUComputePipeline): void dispatchWorkgroups( workgroupCountX: GPUSize32, workgroupCountY?: GPUSize32, workgroupCountZ?: GPUSize32 ): void dispatchWorkgroupsIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void end(): void } interface GPUImageCopyBuffer extends GPUImageDataLayout { buffer: GPUBuffer } interface GPUCommandBufferDescriptor extends GPUObjectDescriptorBase {} interface GPUCommandEncoder extends GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin { /** * 开启一个渲染通道编码器 * * @param descriptor */ beginRenderPass(descriptor: GPURenderPassDescriptor): GPURenderPassEncoder /** * 开启一个计算通道编码器 * * @param descriptor */ beginComputePass(descriptor: GPUComputePassDescriptor): GPUComputePassEncoder /** * 将一个 GPU 缓存数据复制到另一个 GPU 缓存 * * @param source * @param sourceOffset * @param destination * @param destinationOffset * @param size */ copyBufferToBuffer( source: GPUBuffer, sourceOffset: GPUSize64, destination: GPUBuffer, destinationOffset: GPUSize64, size: GPUSize64 ): void /** * 将 GPU 缓存中的数据复制到一个纹理中 * * @param source * @param destination * @param copySize */ copyBufferToTexture( source: GPUImageCopyBuffer, destination: GPUImageCopyTexture, copySize: GPUExtent3D ): void /** * 将纹理数据复制到一个 GPU 缓存 * * @param source * @param destination * @param copySize */ copyTextureToBuffer( source: GPUImageCopyTexture, destination: GPUImageCopyBuffer, copySize: GPUExtent3D ): void /** * 将纹理数据复制到另一个纹理 * * @param source * @param destination * @param copySize */ copyTextureToTexture( source: GPUImageCopyTexture, destination: GPUImageCopyTexture, copySize: GPUExtent3D ): void /** * 清空 GPU 缓存 * * @param buffer * @param offset * @param size */ clearBuffer( buffer: GPUBuffer, offset?: GPUSize64, size?: GPUSize64 ): void /** * 记录时间戳 * * @param querySet * @param queryIndex */ writeTimestamp(querySet: GPUQuerySet, queryIndex: GPUSize32): void /** * 将时间戳查询结果写入存储型缓冲 * * @param querySet * @param firstQuery * @param queryCount * @param destination * @param destinationOffset */ resolveQuerySet( querySet: GPUQuerySet, firstQuery: GPUSize32, queryCount: GPUSize32, destination: GPUBuffer, destinationOffset: GPUSize64 ): void /** * 结束指令编码 * * @param descriptor */ finish(descriptor?: GPUCommandBufferDescriptor): GPUCommandBuffer } interface GPURenderPassLayout extends GPUObjectDescriptorBase { colorFormats: GPUTextureFormat[] depthStencilFormat?: GPUTextureFormat sampleCount?: GPUSize32 } interface GPURenderBundleEncoderDescriptor extends GPURenderPassLayout { depthReadOnly?: boolean stencilReadOnly?: boolean } interface GPURenderBundleDescriptor extends GPUObjectDescriptorBase {} interface GPURenderBundleEncoder extends GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin, GPURenderCommandsMixin { /** * 结束渲染捆绑包编码 * * @param descriptor */ finish(descriptor?: GPURenderBundleDescriptor): GPURenderBundle } interface GPUQuerySetDescriptor extends GPUObjectDescriptorBase { type: GPUQueryType count: GPUSize32 } interface GPUDevice extends EventTarget, GPUObjectBase { readonly features: GPUSupportedFeatures readonly limits: GPUSupportedLimits /** * 指令队列 */ readonly queue: GPUQueue readonly lost: Promise destroy(): void /** * 创建一块 GPU 内存 * * @param descriptor */ createBuffer(descriptor: GPUBufferDescriptor): GPUBuffer /** * 创建一个纹理 * * @param descriptor */ createTexture(descriptor: GPUTextureDescriptor): GPUTexture /** * 创建一个采样器 * * @param descriptor */ createSampler(descriptor?: GPUSamplerDescriptor): GPUSampler /** * 从 一个 video 元素导出一个纹理， * * @param descriptor */ importExternalTexture(descriptor: GPUExternalTextureDescriptor): GPUExternalTexture /** * 创建一个绑定组布局 * * @param descriptor */ createBindGroupLayout(descriptor: GPUBindGroupLayoutDescriptor): GPUBindGroupLayout /** * 创建一个管线布局 * * @param descriptor */ createPipelineLayout(descriptor: GPUPipelineLayoutDescriptor): GPUPipelineLayout /** * 创建一个绑定组 * * @param descriptor */ createBindGroup(descriptor: GPUBindGroupDescriptor): GPUBindGroup /** * 创建一个着色器 * * @param descriptor */ createShaderModule(descriptor: GPUShaderModuleDescriptor): GPUShaderModule /** * 创建一个计算管线 * * @param descriptor */ createComputePipeline(descriptor: GPUComputePipelineDescriptor): GPUComputePipeline /** * 创建一个渲染管线 * * @param descriptor */ createRenderPipeline(descriptor: GPURenderPipelineDescriptor): GPURenderPipeline /** * 异步创建一个计算管线 * * @param descriptor */ createComputePipelineAsync(descriptor: GPUComputePipelineDescriptor): Promise /** * 异步创建一个渲染管线 * @param descriptor */ createRenderPipelineAsync(descriptor: GPURenderPipelineDescriptor): Promise /** * 创建一个指令编码器 * * @param descriptor */ createCommandEncoder(descriptor?: GPUCommandEncoderDescriptor): GPUCommandEncoder /** * 创建一个渲染捆绑包编码器 * * @param descriptor */ createRenderBundleEncoder(descriptor: GPURenderBundleEncoderDescriptor): GPURenderBundleEncoder /** * 创建一个查询集 * * @param descriptor */ createQuerySet(descriptor: GPUQuerySetDescriptor): GPUQuerySet } interface GPUAdapter { /** * 当前 GPU Adapter 支持的功能列表 */ readonly features: Map /** * 当前 GPU Adapter 的一些限制 */ readonly limits: GPUSupportedLimits /** * 是否是回滚的 GPU Adapter（比如在一个没有独显的设备上请求独显 Adapter，则返回的核显 Adapter，此值为 true） */ readonly isFallbackAdapter: boolean /** * 获取 GPUDevice 设备 * * @param options */ requestDevice(options?: GPUDeviceDescriptor): Promise /** * 获取 GPU Adapter 的一些信息 * * @param unmaskHints */ requestAdapterInfo(unmaskHints?: string[]): Promise } interface GPUCanvasConfiguration { device: GPUDevice format: GPUTextureFormat usage?: number viewFormats?: GPUTextureFormat[] colorSpace?: string alphaMode?: GPUCanvasAlphaMode } declare interface GPUCanvasContext { readonly canvas: HTMLCanvasElement | OffscreenCanvas /** * GPUCanvasContext 配置 * * @param configuration */ configure(configuration: GPUCanvasConfiguration): void /** * GPUCanvasContext 取消配置 */ unconfigure(): void /** * 获取当前的 canvas 颜色缓冲 texture（注意每次一绘制操作都需要重新获取） */ getCurrentTexture(): GPUTexture } interface GPU { /** * 获取设备适配器，可以选择获取核显或独显 * 'low-power' 核显 * 'high-performance' 独显 * * @param options */ requestAdapter(options?: GPURequestAdapterOptions): Promise /** * 获取 canvas 的优先颜色格式（texture 最好使用这个颜色格式） */ getPreferredCanvasFormat(): 'rgba8unorm' | 'bgra8unorm' } declare interface Navigator { gpu: GPU } declare interface HTMLCanvasElement { /** * 获取 webgpu 上下文 * * @param contextId */ getContext(contextId: 'webgpu'): GPUCanvasContext | null }