--- title: "GPUCommandEncoder | JavaScript maps SDK" description: "Documentation for MapTiler SDK" --- # Interface GPUCommandEncoder The **`GPUCommandEncoder`** interface of the WebGPU API represents an encoder that collects a sequence of GPU commands to be issued to the GPU. Available only in secure contexts. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder) interface GPUCommandEncoder {     [label](#label): string;     [beginComputePass](#begincomputepass-1)(         descriptor?: [GPUComputePassDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUComputePassDescriptor/),     ): [GPUComputePassEncoder](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUComputePassEncoder/);     [beginRenderPass](#beginrenderpass-1)(descriptor: [GPURenderPassDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPURenderPassDescriptor/)): [GPURenderPassEncoder](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPURenderPassEncoder/);     [clearBuffer](#clearbuffer-1)(buffer: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/), offset?: number, size?: number): void;     [copyBufferToBuffer](#copybuffertobuffer-1)(         source: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),         destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),         size?: number,     ): void;     [copyBufferToBuffer](#copybuffertobuffer-2)(         source: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),         sourceOffset: number,         destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),         destinationOffset: number,         size?: number,     ): void;     [copyBufferToTexture](#copybuffertotexture-1)(         source: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/),         destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),         copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/),     ): void;     [copyBufferToTexture](#copybuffertotexture-2)(         source: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/),         destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),         copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/),     ): void;     [copyTextureToBuffer](#copytexturetobuffer-1)(         source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),         destination: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/),         copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/),     ): void;     [copyTextureToBuffer](#copytexturetobuffer-2)(         source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),         destination: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/),         copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/),     ): void;     [copyTextureToTexture](#copytexturetotexture-1)(         source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),         destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),         copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/),     ): void;     [copyTextureToTexture](#copytexturetotexture-2)(         source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),         destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),         copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/),     ): void;     [finish](#finish-1)(descriptor?: [GPUCommandBufferDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUCommandBufferDescriptor/)): [GPUCommandBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUCommandBuffer/);     [insertDebugMarker](#insertdebugmarker-1)(markerLabel: string): void;     [popDebugGroup](#popdebuggroup-1)(): void;     [pushDebugGroup](#pushdebuggroup-1)(groupLabel: string): void;     [resolveQuerySet](#resolvequeryset-1)(         querySet: [GPUQuerySet](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUQuerySet/),         firstQuery: number,         queryCount: number,         destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),         destinationOffset: number,     ): void; } #### Hierarchy ([View Summary](https://docs.maptiler.com/sdk-js/api-reference/hierarchy/#Externals.GPUCommandEncoder)) - [GPUDebugCommandsMixin](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUDebugCommandsMixin/) - [GPUObjectBase](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUObjectBase/) - GPUCommandEncoder ##### Index ### Properties[](#properties) [label](#label) ### Methods[](#methods) [beginComputePass](#begincomputepass) [beginRenderPass](#beginrenderpass) [clearBuffer](#clearbuffer) [copyBufferToBuffer](#copybuffertobuffer) [copyBufferToTexture](#copybuffertotexture) [copyTextureToBuffer](#copytexturetobuffer) [copyTextureToTexture](#copytexturetotexture) [finish](#finish) [insertDebugMarker](#insertdebugmarker) [popDebugGroup](#popdebuggroup) [pushDebugGroup](#pushdebuggroup) [resolveQuerySet](#resolvequeryset) ## Properties[](#properties-1) ### label[](#label) label: string [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUBindGroup/label) Inherited from [GPUObjectBase](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUObjectBase/).[label](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUObjectBase/#label) ## Methods[](#methods-1) ### beginComputePass[](#begincomputepass) - beginComputePass(descriptor?: [GPUComputePassDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUComputePassDescriptor/)): [GPUComputePassEncoder](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUComputePassEncoder/)[](#begincomputepass-1) The **`beginComputePass()`** method of the GPUCommandEncoder interface starts encoding a compute pass, returning a GPUComputePassEncoder that can be used to control computation. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/beginComputePass) #### Parameters - `Optional`descriptor: [GPUComputePassDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUComputePassDescriptor/) #### Returns [GPUComputePassEncoder](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUComputePassEncoder/) ### beginRenderPass[](#beginrenderpass) - beginRenderPass(descriptor: [GPURenderPassDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPURenderPassDescriptor/)): [GPURenderPassEncoder](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPURenderPassEncoder/)[](#beginrenderpass-1) The **`beginRenderPass()`** method of the GPUCommandEncoder interface starts encoding a render pass, returning a GPURenderPassEncoder that can be used to control rendering. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/beginRenderPass) #### Parameters - descriptor: [GPURenderPassDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPURenderPassDescriptor/) #### Returns [GPURenderPassEncoder](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPURenderPassEncoder/) ### clearBuffer[](#clearbuffer) - clearBuffer(buffer: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/), offset?: number, size?: number): void[](#clearbuffer-1) The **`clearBuffer()`** method of the GPUCommandEncoder interface encodes a command that fills a region of a GPUBuffer with zeroes. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/clearBuffer) #### Parameters - buffer: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/) - `Optional`offset: number - `Optional`size: number #### Returns void ### copyBufferToBuffer[](#copybuffertobuffer) - copyBufferToBuffer(     source: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),     destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),     size?: number, ): void[](#copybuffertobuffer-1) The **`copyBufferToBuffer()`** method of the GPUCommandEncoder interface encodes a command that copies data from one GPUBuffer to another. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/copyBufferToBuffer) #### Parameters - source: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/) - destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/) - `Optional`size: number #### Returns void - copyBufferToBuffer(     source: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),     sourceOffset: number,     destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),     destinationOffset: number,     size?: number, ): void[](#copybuffertobuffer-2) #### Parameters - source: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/) - sourceOffset: number - destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/) - destinationOffset: number - `Optional`size: number #### Returns void ### copyBufferToTexture[](#copybuffertotexture) - copyBufferToTexture(     source: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/),     destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),     copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/), ): void[](#copybuffertotexture-1) The **`copyBufferToTexture()`** method of the GPUCommandEncoder interface encodes a command that copies data from a GPUBuffer to a GPUTexture. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/copyBufferToTexture) #### Parameters - source: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/) - destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/) - copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/) #### Returns void - copyBufferToTexture(     source: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/),     destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),     copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/), ): void[](#copybuffertotexture-2) The **`copyBufferToTexture()`** method of the GPUCommandEncoder interface encodes a command that copies data from a GPUBuffer to a GPUTexture. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/copyBufferToTexture) #### Parameters - source: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/) - destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/) - copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/) #### Returns void ### copyTextureToBuffer[](#copytexturetobuffer) - copyTextureToBuffer(     source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),     destination: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/),     copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/), ): void[](#copytexturetobuffer-1) The **`copyTextureToBuffer()`** method of the GPUCommandEncoder interface encodes a command that copies data from a GPUTexture to a GPUBuffer. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/copyTextureToBuffer) #### Parameters - source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/) - destination: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/) - copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/) #### Returns void - copyTextureToBuffer(     source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),     destination: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/),     copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/), ): void[](#copytexturetobuffer-2) The **`copyTextureToBuffer()`** method of the GPUCommandEncoder interface encodes a command that copies data from a GPUTexture to a GPUBuffer. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/copyTextureToBuffer) #### Parameters - source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/) - destination: [GPUTexelCopyBufferInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyBufferInfo/) - copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/) #### Returns void ### copyTextureToTexture[](#copytexturetotexture) - copyTextureToTexture(     source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),     destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),     copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/), ): void[](#copytexturetotexture-1) The **`copyTextureToTexture()`** method of the GPUCommandEncoder interface encodes a command that copies data from one GPUTexture to another. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/copyTextureToTexture) #### Parameters - source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/) - destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/) - copySize: [GPUExtent3D](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.GPUExtent3D/) #### Returns void - copyTextureToTexture(     source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),     destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/),     copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/), ): void[](#copytexturetotexture-2) The **`copyTextureToTexture()`** method of the GPUCommandEncoder interface encodes a command that copies data from one GPUTexture to another. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/copyTextureToTexture) #### Parameters - source: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/) - destination: [GPUTexelCopyTextureInfo](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUTexelCopyTextureInfo/) - copySize: [Iterable](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.Iterable/) #### Returns void ### finish[](#finish) - finish(descriptor?: [GPUCommandBufferDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUCommandBufferDescriptor/)): [GPUCommandBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUCommandBuffer/)[](#finish-1) The **`finish()`** method of the GPUCommandEncoder interface completes recording of the command sequence encoded on this GPUCommandEncoder, returning a corresponding GPUCommandBuffer. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/finish) #### Parameters - `Optional`descriptor: [GPUCommandBufferDescriptor](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUCommandBufferDescriptor/) #### Returns [GPUCommandBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUCommandBuffer/) ### insertDebugMarker[](#insertdebugmarker) - insertDebugMarker(markerLabel: string): void[](#insertdebugmarker-1) [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/insertDebugMarker) #### Parameters - markerLabel: string #### Returns void Inherited from [GPUDebugCommandsMixin](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUDebugCommandsMixin/).[insertDebugMarker](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUDebugCommandsMixin/#insertdebugmarker) ### popDebugGroup[](#popdebuggroup) - popDebugGroup(): void[](#popdebuggroup-1) [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/popDebugGroup) #### Returns void Inherited from [GPUDebugCommandsMixin](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUDebugCommandsMixin/).[popDebugGroup](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUDebugCommandsMixin/#popdebuggroup) ### pushDebugGroup[](#pushdebuggroup) - pushDebugGroup(groupLabel: string): void[](#pushdebuggroup-1) [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/pushDebugGroup) #### Parameters - groupLabel: string #### Returns void Inherited from [GPUDebugCommandsMixin](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUDebugCommandsMixin/).[pushDebugGroup](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUDebugCommandsMixin/#pushdebuggroup) ### resolveQuerySet[](#resolvequeryset) - resolveQuerySet(     querySet: [GPUQuerySet](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUQuerySet/),     firstQuery: number,     queryCount: number,     destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/),     destinationOffset: number, ): void[](#resolvequeryset-1) The **`resolveQuerySet()`** method of the GPUCommandEncoder interface encodes a command that resolves a GPUQuerySet, copying the results into a specified GPUBuffer. [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUCommandEncoder/resolveQuerySet) #### Parameters - querySet: [GPUQuerySet](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUQuerySet/) - firstQuery: number - queryCount: number - destination: [GPUBuffer](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.GPUBuffer/) - destinationOffset: number #### Returns void