GPUCommandEncoder: copyBufferToTexture() Methode

Syntax

Parameter

Ein Objekt, das den Puffer definiert, von dem kopiert werden soll, plus das Layout der Daten im Puffer, die auf die Textur kopiert werden sollen. Zusammen mit copySize definiert es den Bereich des Quellpuffers. source kann die folgenden Eigenschaften haben:

Der GPUBuffer, von dem kopiert werden soll.

Der Offset in Bytes vom Anfang von data bis zum Beginn der zu kopierenden Bilddaten. Wenn nicht angegeben, ist der Standardwert von offset 0.

Eine Zahl, die den Abstand in Bytes zwischen dem Beginn jeder Blockzeile (d.h. einer Reihe vollständiger Texelblöcke) und der nachfolgenden Blockzeile darstellt. Dies ist erforderlich, wenn es mehrere Blockzeilen gibt (d.h. die Kopierhöhe oder -tiefe beträgt mehr als ein Block).

Die Anzahl der Blockzeilen pro Einzelbild innerhalb der Daten. bytesPerRow × rowsPerImage ergibt den Abstand in Bytes zwischen dem Beginn jedes vollständigen Bildes. Dies ist erforderlich, wenn mehrere Bilder kopiert werden sollen.

Ein Objekt, das die Textur definiert, in die die Daten geschrieben werden sollen. Zusammen mit copySize definiert es den Bereich der Zieltexturunterressource. destination kann die folgenden Eigenschaften haben:

Ein enumerierter Wert, der definiert, welche Aspekte der Textur die Daten geschrieben werden sollen. Mögliche Werte sind:

Alle verfügbaren Aspekte des Texturformats werden beschriftet, was je nach Format alle oder einige der folgenden sein können: Farbe, Tiefe und Stencil.

Es wird nur der Tiefenaspekt eines Tiefen- oder Stencil-Formats beschrieben.

Es wird nur der Stencilaspekt eines Tiefen- oder Stencil-Formats beschrieben.

Wenn nicht angegeben, hat aspect den Wert "all".

Eine Zahl, die die Mip-Map-Ebene der Textur repräsentiert, in die die Daten geschrieben werden sollen. Wenn nicht angegeben, ist der Standardwert von mipLevel 0.

Ein Objekt oder Array, das den Ursprung der Kopie angibt — die minimale Ecke des Texturbereichs, in den die Daten geschrieben werden sollen. Zusammen mit size definiert dies das volle Ausmaß des zu kopierenden Bereichs. Die x, y und z-Werte haben den Standardwert 0, wenn origin nicht oder nicht vollständig angegeben ist.

Zum Beispiel kann ein Array wie [0, 0, 0] übergeben werden, oder das entsprechende Objekt { x: 0, y: 0, z: 0 }.

Ein GPUTexture-Objekt, das die Textur darstellt, in die die Daten geschrieben werden sollen.

Ein Objekt oder Array, das die Breite, Höhe und Tiefe/Array-Ebenenzahl der kopierten Daten angibt. Der Breitenwert muss immer angegeben werden, während die Höhen- und Tiefen-/Array-Ebenenzahl optional sind und den Standardwert 1 haben, wenn sie nicht angegeben sind.

Zum Beispiel kann ein Array [16, 16, 2] übergeben werden, oder das entsprechende Objekt { width: 16, height: 16, depthOrArrayLayers: 2 }.

Rückgabewert

Keiner (Undefined).

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenn copyBufferToTexture() aufgerufen wird, andernfalls wird ein GPUValidationError erzeugt und der GPUCommandEncoder wird ungültig.

Für source:

• source.bytesPerRow ist ein Vielfaches von 256.
• Die source.buffer-Eigenschaft GPUBuffer.usage enthält das GPUBufferUsage.COPY_SRC-Flag.

Für destination:

• mipLevel ist kleiner als die GPUTexture.mipLevelCount.
• origin.x ist ein Vielfaches der Texelblockbreite der GPUTexture.format.
• origin.y ist ein Vielfaches der Texelblockhöhe der GPUTexture.format.
• Wenn das GPUTexture.format ein Tiefen- oder Stencil-Format ist oder GPUTexture.sampleCount mehr als 1 ist, ist die Subressourcengröße gleich size.
• Die destination-Eigenschaft GPUTexture.usage enthält das GPUTextureUsage.COPY_DST-Flag.
• Die destination-Eigenschaft GPUTexture.sampleCount ist 1.
• destination.aspect bezieht sich auf einen einzelnen Aspekt des GPUTexture.format.
• Dieser Aspekt ist ein gültiges Bildkopie-Ziel gemäß Tiefen- oder Stencil-Formaten.
• Die destination ist kompatibel mit der copySize.

Beispiele

Spezifikationen

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

• Die WebGPU API