GPUSupportedLimits

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die GPUSupportedLimits-Schnittstelle der WebGPU API beschreibt die von einem GPUAdapter unterstützten Grenzen.

Auf das GPUSupportedLimits-Objekt des aktuellen Adapters wird über die GPUAdapter.limits-Eigenschaft zugegriffen.

Es sollte beachtet werden, dass Browser, anstatt die genauen Grenzen jeder GPU zu melden, wahrscheinlich unterschiedliche Wertstufen verschiedener Grenzen melden, um die verfügbare einzigartige Information zu reduzieren, die für Drive-by-Fingerprinting genutzt werden könnte. Beispielsweise könnten die Stufen einer bestimmten Grenze 2048, 8192 und 32768 sein. Wenn das tatsächliche Limit Ihrer GPU 16384 ist, wird der Browser dennoch 8192 melden.

Da verschiedene Browser dies unterschiedlich handhaben und sich die Stufenwerte im Laufe der Zeit ändern können, ist es schwierig, eine genaue Angabe darüber zu machen, welche Grenzwerte zu erwarten sind — gründliche Tests werden empfohlen.

Instanz-Eigenschaften

Die folgenden Grenzen werden durch Eigenschaften in einem GPUSupportedLimits-Objekt dargestellt. Siehe den Limits-Abschnitt der Spezifikation für detaillierte Beschreibungen, worauf sich die Grenzen beziehen.

Grenzname Standardwert
maxTextureDimension1D 8192
maxTextureDimension2D 8192
maxTextureDimension3D 2048
maxTextureArrayLayers 256
maxBindGroups 4
maxBindingsPerBindGroup 640
maxDynamicUniformBuffersPerPipelineLayout 8
maxDynamicStorageBuffersPerPipelineLayout 4
maxSampledTexturesPerShaderStage 16
maxSamplersPerShaderStage 16
maxStorageBuffersPerShaderStage 8
maxStorageTexturesPerShaderStage 4
maxUniformBuffersPerShaderStage 12
maxUniformBufferBindingSize 65536 bytes
maxStorageBufferBindingSize 134217728 bytes (128 MB)
minUniformBufferOffsetAlignment 256 bytes
minStorageBufferOffsetAlignment 256 bytes
maxVertexBuffers 8
maxBufferSize 268435456 bytes (256 MB)
maxVertexAttributes 16
maxVertexBufferArrayStride 2048 bytes
maxInterStageShaderComponents 60
maxInterStageShaderVariables 16
maxColorAttachments 8
maxColorAttachmentBytesPerSample 32
maxComputeWorkgroupStorageSize 16384 bytes
maxComputeInvocationsPerWorkgroup 256
maxComputeWorkgroupSizeX 256
maxComputeWorkgroupSizeY 256
maxComputeWorkgroupSizeZ 64
maxComputeWorkgroupsPerDimension 65535

Beispiele

Im folgenden Code fragen wir den GPUAdapter.limits-Wert von maxBindGroups ab, um zu sehen, ob er gleich oder größer als 6 ist. Unsere theoretische Beispielanwendung benötigt idealerweise 6 Bind-Gruppen, daher fügen wir ein maximales Limit von 6 zum requiredLimits-Objekt hinzu, wenn der zurückgegebene Wert >= 6 ist. Wir fordern dann ein Gerät mit dieser Grenzanforderung an, indem wir GPUAdapter.requestDevice() verwenden:

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,
  });

  // ...
}

Spezifikationen

Specification
WebGPU
# gpusupportedlimits

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
GPUSupportedLimits
Experimental
maxBindGroups
Experimental
maxBindGroupsPlusVertexBuffers
Experimental
maxBindingsPerBindGroup
Experimental
maxBufferSize
Experimental
maxColorAttachmentBytesPerSample
Experimental
maxColorAttachments
Experimental
maxComputeInvocationsPerWorkgroup
Experimental
maxComputeWorkgroupSizeX
Experimental
maxComputeWorkgroupSizeY
Experimental
maxComputeWorkgroupSizeZ
Experimental
maxComputeWorkgroupStorageSize
Experimental
maxComputeWorkgroupsPerDimension
Experimental
maxDynamicStorageBuffersPerPipelineLayout
Experimental
maxDynamicUniformBuffersPerPipelineLayout
Experimental
maxInterStageShaderComponents
ExperimentalNon-standard
maxInterStageShaderVariables
Experimental
maxSampledTexturesPerShaderStage
Experimental
maxSamplersPerShaderStage
Experimental
maxStorageBufferBindingSize
Experimental
maxStorageBuffersPerShaderStage
Experimental
maxStorageTexturesPerShaderStage
Experimental
maxTextureArrayLayers
Experimental
maxTextureDimension1D
Experimental
maxTextureDimension2D
Experimental
maxTextureDimension3D
Experimental
maxUniformBufferBindingSize
Experimental
maxUniformBuffersPerShaderStage
Experimental
maxVertexAttributes
Experimental
maxVertexBufferArrayStride
Experimental
maxVertexBuffers
Experimental
minStorageBufferOffsetAlignment
Experimental
minUniformBufferOffsetAlignment
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
See implementation notes.
User must explicitly enable this feature.
Has more compatibility info.

Siehe auch