<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Metal",
  "identifier" : "/documentation/Metal/MTL4ComputeCommandEncoder/copy(sourceTexture:sourceSlice:sourceLevel:destinationTexture:destinationSlice:destinationLevel:sliceCount:levelCount:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Metal"
    ],
    "preciseIdentifier" : "c:objc(pl)MTL4ComputeCommandEncoder(im)copyFromTexture:sourceSlice:sourceLevel:toTexture:destinationSlice:destinationLevel:sliceCount:levelCount:"
  },
  "title" : "copy(sourceTexture:sourceSlice:sourceLevel:destinationTexture:destinationSlice:destinationLevel:sliceCount:levelCount:)"
}
-->

# copy(sourceTexture:sourceSlice:sourceLevel:destinationTexture:destinationSlice:destinationLevel:sliceCount:levelCount:)

Encodes a command that copies slices of a texture to slices of another texture.

```
func copy(sourceTexture: any MTLTexture, sourceSlice: Int, sourceLevel: Int, destinationTexture: any MTLTexture, destinationSlice: Int, destinationLevel: Int, sliceCount: Int, levelCount: Int)
```

## Parameters

`sourceTexture`

A [`MTLTexture`](/documentation/Metal/MTLTexture) texture that the command copies data from. To read the source
texture contents, you need to set its [`isFramebufferOnly`](/documentation/Metal/MTLTexture/isFramebufferOnly) property
to <doc://com.apple.documentation/documentation/Swift/false> prior to drawing into it.

`sourceSlice`

A slice within `sourceTexture` the command uses as a starting point to copy
data from. Set this to `0` if `sourceTexture` isn’t a texture array or a
cube texture.

`sourceLevel`

A mipmap level within `sourceTexture`.

`destinationTexture`

Another [`MTLTexture`](/documentation/Metal/MTLTexture) the command copies the data to that has the same
[`pixelFormat`](/documentation/Metal/MTLTexture/pixelFormat) and [`sampleCount`](/documentation/Metal/MTLTexture/sampleCount) as `sourceTexture`.
To write the contents into this texture, you need to set its [`isFramebufferOnly`](/documentation/Metal/MTLTexture/isFramebufferOnly)
property to <doc://com.apple.documentation/documentation/Swift/false>.

`destinationSlice`

A slice within `destinationTexture` the command uses as its starting point
for copying data to. Set this to `0` if `destinationTexture` isn’t a texture
array or a cube texture.

`destinationLevel`

A mipmap level within `destinationTexture`. The mipmap level you reference needs to
have the same size as the `sourceTexture` slice’s mipmap at `sourceLevel`.

`sliceCount`

The number of slices the command copies so that it satisfies the conditions
that the sum of `sourceSlice` and `sliceCount` doesn’t exceed the number of
slices in `sourceTexture` and the sum of `destinationSlice` and `sliceCount`
doesn’t exceed the number of slices in `destinationTexture`.

`levelCount`

The number of mipmap levels the command copies so that it satisfies the
conditions that the sum of `sourceLevel` and `levelCount` doesn’t exceed the
number of mipmap levels in `sourceTexture` and the sum of `destinationLevel`
and `levelCount` doesn’t exceed the number of mipmap levels in `destinationTexture`.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)