Compatibility Mode - Terse Version #6244

greggman · 2026-04-16T17:12:26Z

greggman
Apr 16, 2026
Maintainer

Copied and edited from mrdoob/three.js#30725 (comment)

Restriction	Description
Storage Buffers in Vertex Shaders	~45% older devices don't support storage buffers in vertex shaders.
Single Texture View Dimension	Textures limited to one view dimension set at creation.
Subset of Layers in Texture Views	Cannot select subset of texture layers when creating views.
Mipmap Generation	Requires special handling due to texture view restrictions.
Uniform Color Blending	Blending settings must be identical across all color targets.
Copy Operations with Compressed Textures	`copyTextureToBuffer` and `copyTextureToTexture` don't support compressed textures.
Multisampled Textures	`copyTextureToTexture` does not support multisampled textures.
Cube-Array Textures	Cube-array textures are unsupported.
Texture View Consistency	Texture views within a draw/dispatch call must have identical aspects/mip levels.
Sample Mask and Index	`@builtin(sample_mask)` and `@builtin(sample_index)` unsupported.
Storage Texture Formats	`rg32uint`, `rg32sint`, `rg32float` formats unsupported as storage textures.
Depth Clamp Bias	Must be set to 0.
Interpolation Modes	`@interpolation(linear)`, `@interpolation(sample)`, `@interpolate(flat)`, `@interpolate(flat, first)` unsupported; use `@interpolate(flat, either)` instead.
Texture Format Reinterpretation	Cannot reinterpret textures between formats (e.g., `rgba8unorm` ↔ `rgba8unorm-srgb`).
Unsupported Texture Formats	`bgra8unorm-srgb` is not supported.
Multisampled Texture Restrictions	`rgba16float`, `r32float`, and integer formats cannot be multisampled.
Texture Dimension Compatibility	`depthOrArrayLayers` must match `textureBindingViewDimension`.
Depth Textures	No `textureLoad` or non-comparison samplers on depth textures.
Texture-Sampler Combinations	Limited to 16 combinations per shader stage.
Default Limits	Lower defaults, e.g., `maxColorAttachments` (4), `maxComputeInvocationsPerWorkgroup` (128), `maxTextureDimension1D` (4096), `maxTextureDimension2D` (4096).
New Limits	`maxStorageBuffersInVertexStage` (0), `maxStorageTexturesInVertexStage` (0), `maxStorageBuffersInFragmentStage` (4), `maxStorageTexturesInFragmentStage` (4).

Also see:

kainino0x · 2026-04-16T18:38:35Z

kainino0x
Apr 16, 2026
Maintainer

Nice! Maybe a wiki page would be a good permanent place for this?

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Compatibility Mode - Terse Version #6244

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Compatibility Mode - Terse Version #6244

Uh oh!

Uh oh!

greggman Apr 16, 2026 Maintainer

Replies: 1 comment

Uh oh!

kainino0x Apr 16, 2026 Maintainer

greggman
Apr 16, 2026
Maintainer

kainino0x
Apr 16, 2026
Maintainer