GPUCanvasContext: getCurrentTexture() メソッド

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

GPUCanvasContext インターフェイスの getCurrentTexture() メソッドは、このキャンバスコンテキストによって文書に次に合成される GPUTexture を返します。

構文

js
getCurrentTexture()

引数

なし

返値

GPUTexture オブジェクトのインスタンスです。

例外

InvalidStateError DOMException

設定をする前 (すなわち、GPUCanvasContext.configure() を呼び出す前) のキャンバスコンテキストで getCurrentTexture() が呼ばれたとき投げられます。

例

js
const canvas = document.querySelector("#gpuCanvas");
const context = canvas.getContext("webgpu");

context.configure({
  device: device,
  format: navigator.gpu.getPreferredCanvasFormat(),
  alphaMode: "premultiplied",
});

//...
// 後で
const commandEncoder = device.createCommandEncoder();

const renderPassDescriptor = {
  colorAttachments: [
    {
      clearValue: [0, 0, 0, 1], // 不透明な黒
      loadOp: "clear",
      storeOp: "store",
      view: context.getCurrentTexture().createView(),
    },
  ],
};

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

仕様書

Specification
WebGPU
# dom-gpucanvascontext-getcurrenttexture

ブラウザーの互換性

BCD tables only load in the browser

関連情報