GPUDevice: importExternalTexture() Methode

descriptor

Ein Objekt, das die folgenden Eigenschaften enthält:

colorSpace Optional

Ein enumerierter Wert, der den Farbraum für den Videoframe angibt. Mögliche Werte sind "srgb" und "display-p3". Wenn ausgelassen, ist der Standardwert für colorSpace "srgb".

label Optional

Ein String, der ein Label bereitstellt, das zur Identifizierung des Objekts dienen kann, zum Beispiel in GPUError-Meldungen oder Konsolenwarnungen.

source

Die HTMLVideoElement- oder VideoFrame-Quelle des Video-Schnappschusses.

Eine Instanz des GPUExternalTexture-Objekts.

Beachten Sie, dass der Moment, in dem das GPUExternalTexture-Objekt abläuft (zerstört wird), davon abhängt, was seine Quelle ist:

• GPUExternalTexture-Objekte mit einer HTMLVideoElement-Quelle laufen ab, sobald sie verwendet werden (zum Beispiel in einer Bind-Gruppe).
• GPUExternalTexture-Objekte mit einer VideoFrame-Quelle laufen erst ab, wenn das VideoFrame geschlossen wird, zum Beispiel durch einen Aufruf von VideoFrame.close().

Die folgenden Kriterien müssen erfüllt sein, wenn importExternalTexture() aufgerufen wird, andernfalls wird ein GPUValidationError generiert und ein ungültiges GPUExternalTexture-Objekt zurückgegeben:

• Der Video-Schnappschuss muss verwendbar sein (z. B. die Videoquelle ist ordnungsgemäß geladen und hat nicht die Breite oder Höhe von 0).

SecurityError DOMException

Wird ausgelöst, wenn die Videodatenquelle cross-origin ist.

Im WebGPU-Beispiel Video Uploading sample wird ein importExternalTexture()-Aufruf als Wert eines Bind-Gruppen-Eintrags resource verwendet, der bei der Erstellung einer GPUBindGroup über einen GPUDevice.createBindGroup()-Aufruf spezifiziert wird:

// …

const uniformBindGroup = device.createBindGroup({
  layout: pipeline.getBindGroupLayout(0),
  entries: [
    {
      binding: 1,
      resource: sampler,
    },
    {
      binding: 2,
      resource: device.importExternalTexture({
        source: video,
      }),
    },
  ],
});

// …

• Die WebGPU API