<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: -",
    "macOS: 13.0.0 -",
    "tvOS: 16.0.0 -",
    "visionOS: -",
    "watchOS: 9.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Accelerate",
  "identifier" : "/documentation/Accelerate/vImage/PixelBuffer/extractChannel(at:destination:)-8xrq1",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Accelerate"
    ],
    "preciseIdentifier" : "s:10Accelerate6vImageO11PixelBufferVAaC14InterleavedFx4VRszrlE14extractChannel2at11destinationySi_AEy_AC7PlanarFVGtF"
  },
  "title" : "extractChannel(at:destination:)"
}
-->

# extractChannel(at:destination:)

Extracts a single channel from an 32-bit-per-channel, 4-channel interleaved pixel buffer.

```
func extractChannel(at channelIndex: Int, destination: vImage.PixelBuffer<vImage.PlanarF>)
```

## Parameters

`channelIndex`

The index of the channel that the function extracts.

`destination`

The destination pixel buffer.

## Discussion

For example, the following code extracts channel `2` from a four-channel pixel buffer.

```swift
let src = vImage.PixelBuffer<vImage.InterleavedFx4>(
    pixelValues: [0.10, 0.11, 0.12, 0.13,
                  0.20, 0.21, 0.22, 0.23,
                  0.30, 0.31, 0.32, 0.33],
    size: vImage.Size(width: 1, height: 3))

let dest = vImage.PixelBuffer<vImage.PlanarF>(
    size: src.size)

src.extractChannel(at: 2,
                   destination: dest)

// Prints "[0.12, 0.22, 0.32]".
print(dest.array)
```

---

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)