GPUSupportedLimits

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("WebGPU API")}}{{SecureContext_Header}}{{AvailableInWorkers}}

The **GPUSupportedLimits** interface of the {{domxref("WebGPU API", "WebGPU API", "", "nocode")}} describes the limits supported by a {{domxref("GPUAdapter")}}.

{{InheritanceDiagram}}

Instance properties

The following limits are represented by properties in a GPUSupportedLimits object. See the Limits section of the specification for detailed descriptions of what the limits relate to.

All properties are read-only.

Limit nameDefault value
maxTextureDimension1D8192
maxTextureDimension2D8192
maxTextureDimension3D2048
maxTextureArrayLayers256
maxBindGroups4
maxBindingsPerBindGroup640
maxDynamicUniformBuffersPerPipelineLayout8
maxDynamicStorageBuffersPerPipelineLayout4
maxSampledTexturesPerShaderStage16
maxSamplersPerShaderStage16
maxStorageBuffersInFragmentStage8
maxStorageBuffersInVertexStage8
maxStorageBuffersPerShaderStage8
maxStorageTexturesInFragmentStage4
maxStorageTexturesInVertexStage4
maxStorageTexturesPerShaderStage4
maxUniformBuffersPerShaderStage12
maxUniformBufferBindingSize65536 bytes
maxStorageBufferBindingSize134217728 bytes (128 MB)
minUniformBufferOffsetAlignment256 bytes
minStorageBufferOffsetAlignment256 bytes
maxVertexBuffers8
maxBufferSize268435456 bytes (256 MB)
maxVertexAttributes16
maxVertexBufferArrayStride2048 bytes
maxInterStageShaderComponents {{deprecated_inline}} {{non-standard_inline}} (use maxInterStageShaderVariables instead, see deprecation notice for more info)60
maxInterStageShaderVariables16
maxColorAttachments8
maxColorAttachmentBytesPerSample32
maxComputeWorkgroupStorageSize16384 bytes
maxComputeInvocationsPerWorkgroup256
maxComputeWorkgroupSizeX256
maxComputeWorkgroupSizeY256
maxComputeWorkgroupSizeZ64
maxComputeWorkgroupsPerDimension65535

Description

The GPUSupportedLimits object for the current adapter is accessed via the {{domxref("GPUAdapter.limits")}} property.

Instead of reporting the exact limits of each GPU, browsers typically report different tier values of different limits (to reduce the unique information available to drive-by fingerprinting). For example, the tiers of a certain limit might be 2048, 8192, and 32768. If your GPU's actual limit is 16384, the browser will still report 8192.

Given that different browsers will handle this differently and the tier values may change over time, it is hard to provide an accurate account of what limit values to expect — thorough testing is advised.

Note that when calling {{domxref("GPUAdapter.requestDevice()")}} to request a {{domxref("GPUDevice")}} that meets some minimum requirements ("limits"), you pass an object that has the same property names as GPUSupportedLimits.

Storage buffer and texture limits outside compatibility mode

When creating a device, requested maxStorageBuffersInFragmentStage, maxStorageBuffersInVertexStage, maxStorageTexturesInFragmentStage, and maxStorageTexturesInVertexStage limits aren't kept as separate values when WebGPU compatibility mode isn't being used. Instead, they raise the maxStorageBuffersPerShaderStage and maxStorageTexturesPerShaderStage limits if they're higher, and are then adjusted to equal them.

Examples

In the following code we query the GPUAdapter.limits value of maxBindGroups to see if it is equal to or greater than 6. Our theoretical example app ideally needs 6 bind groups, so if the returned value is >= 6, we add a maximum limit of 6 to the requiredLimits object. We then request a device with that limit requirement using {{domxref("GPUAdapter.requestDevice()")}}:

js
async function init() {
  if (!navigator.gpu) {
    throw Error("WebGPU not supported.");
  }

  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) {
    throw Error("Couldn't request WebGPU adapter.");
  }

  const requiredLimits = {};

  // App ideally needs 6 bind groups, so we'll try to request what the app needs
  if (adapter.limits.maxBindGroups >= 6) {
    requiredLimits.maxBindGroups = 6;
  }

  const device = await adapter.requestDevice({
    requiredLimits,
  });

  // …
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • The WebGPU API