WebGPU API
The GPUTexture interface of the WebGPU API represents a container used to store 1D, 2D, or 3D arrays of data, such as images, to use in GPU rendering operations.
A GPUTexture object instance is created using the GPUDevice.createTexture() method.
Instance properties
- GPUTexture.depthOrArrayLayers
- : A number representing the depth or layer count of the
GPUTexture(pixels, or number of layers).
- : A number representing the depth or layer count of the
- GPUTexture.dimension
- : An enumerated value representing the dimension of the set of texels for each
GPUTexturesubresource.
- : An enumerated value representing the dimension of the set of texels for each
- GPUTexture.format
- : An enumerated value representing the format of the
GPUTexture. See the Texture formats section of the specification for all the possible values. Also see Tier 1 and Tier 2 texture formats.
- : An enumerated value representing the format of the
- GPUTexture.height
- : A number representing the height of the
GPUTexturein pixels.
- : A number representing the height of the
- GPUTexture.label
- : A string providing a label that can be used to identify the object, for example in GPUError messages or console warnings.
- GPUTexture.mipLevelCount
- : A number representing the number of mip levels of the
GPUTexture.
- : A number representing the number of mip levels of the
- GPUTexture.sampleCount
- : A number representing the sample count of the
GPUTexture.
- : A number representing the sample count of the
- GPUTexture.usage
- : The bitwise flags representing the allowed usages of the
GPUTexture.
- : The bitwise flags representing the allowed usages of the
- GPUTexture.width
- : A number representing the width of the
GPUTexturein pixels.
- : A number representing the width of the
Instance methods
- GPUTexture.createView
- : Creates a GPUTextureView representing a specific view of the
GPUTexture.
- : Creates a GPUTextureView representing a specific view of the
- GPUTexture.destroy
- : Destroys the
GPUTexture.
- : Destroys the
Examples
In the WebGPU samples Textured Cube sample, a texture to use on the faces of a cube is created by:
- Loading the image into an HTMLImageElement and creating an image bitmap using Window.createImageBitmap.
- Creating a new
GPUTextureusingcreateTexture(). - Copying the image bitmap into the texture using GPUQueue.copyExternalImageToTexture().
// …
let cubeTexture;
{
const img = document.createElement("img");
img.src = new URL(
"../../../assets/img/Di-3d.png",
import.meta.url,
).toString();
await img.decode();
const imageBitmap = await createImageBitmap(img);
cubeTexture = device.createTexture({
size: [imageBitmap.width, imageBitmap.height, 1],
format: "rgba8unorm",
usage:
GPUTextureUsage.TEXTURE_BINDING |
GPUTextureUsage.COPY_DST |
GPUTextureUsage.RENDER_ATTACHMENT,
});
device.queue.copyExternalImageToTexture(
{ source: imageBitmap },
{ texture: cubeTexture },
[imageBitmap.width, imageBitmap.height],
);
}
// …
Specifications
Browser compatibility
See also
- The WebGPU API
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
