[docs] textures: Writing arrays of images to a 3D texture crashes

[dakumisu]

Docs

This may be me who hasn't understood yet how it works but it seems that the "Writing arrays of images" docs example doesn't work :

const texture3d = root.createTexture({
  size: [256, 256, 3],
  format: 'rgba8unorm',
  dimension: '3d',
}).$usage('sampled');

texture3d.write([imageBitmap1, imageBitmap2, imageBitmap3]); // ↓

WebGPU's copyExternalImageToTexture (used internally by .write()) only accepts 2D textures as destination — dimension: '3d' is invalid by spec, regardless of usage flags.

Workaround

Drop dimension: '3d'. The default creates a 2D-array texture, which works:

const texture3d = root.createTexture({
  size: [256, 256, 3],
  format: 'rgba8unorm',
}).$usage('sampled', 'render');

texture3d.write([imageBitmap1, imageBitmap2, imageBitmap3]); // ✅

The docs example should be updated to use a 2D-array, or include a note that dimension: '3d' cannot be written from image sources.

Environment

• TypeGPU 0.11.2
• Arc / macOS

[pullfrog]

  ^{｜ Build this ➔ ｜ Make a plan ➔}

[iwoplaza]

Thanks for reporting this! @reczkok You're the most familiar with this API, is that a documentation error, or is creating a 3d texture out of 2d slices something we were aiming to support with our APIs?

[reczkok]

Hello! The write API is currently pretty limited when it comes to capabilities (especially when it comes to resizing), I will make sure 3d textures are properly supported as a part of #2641

[reczkok]

Support for 3d textures with formats that can be sampled landed in the #2641, should land in 0.12 :)