Interface CopyToTextureTaskConfig

View-relative source mip level. Default 0. A texture-backed wrapper exposes one mip, so LOD clamps to zero and both paths read its selected physical mip. Ordinary sources use this as their source mipLevel or textureSampleLevel LOD.

When true, this task owns targetTexture: it rebuilds the target on every frame-graph build (including canvas resize) and disposes it with the task. Leave false for externally owned targets.

Optional single-sample texture that receives a hardware MSAA-resolve of the task's MSAA color attachment at end-of-pass. Two modes:

• Blit + resolve: targetTexture is MSAA and resolveTexture is SS. The shader blit writes into targetTexture and at end-of-pass the GPU resolves targetTexture into resolveTexture.

• Resolve-only: targetTexture is omitted. The task runs a no-draw render pass with sourceTexture as the color attachment (so the source itself must be MSAA) and resolveTexture as its resolve target. viewport and lodLevel are ignored. sourceTexture and resolveTexture must have matching dimensions.

In both modes, resolveTexture.format must match the MSAA attachment's format and resolveTexture must be single-sample.

Source render target. The engine swapchain render target is not supported because its GPU texture changes every frame.

Target attachment that receives the blit. Required UNLESS resolveTexture is set, in which case the task does a resolve-only operation and writes directly into resolveTexture.

Viewport applied to the target before the blit. When undefined (default), the whole target is overwritten and the encoder-copy fast path becomes available. When set, the blit path is used.