<!--
{
  "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/init(referencing:planeIndex:overrideSize:pixelFormat:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "Accelerate"
    ],
    "preciseIdentifier" : "s:10Accelerate6vImageO11PixelBufferVA2A011SinglePlaneC6FormatRzrlE11referencing10planeIndex12overrideSize05pixelG0AEy_xGSo11CVBufferRefa_SiAC0L0VSgxmtcfc"
  },
  "title" : "init(referencing:planeIndex:overrideSize:pixelFormat:)"
}
-->

# init(referencing:planeIndex:overrideSize:pixelFormat:)

Initializes a pixel buffer by refencing the data from a single plane of a multiplane Core Video pixel buffer.

```
init(referencing lockedCVPixelBuffer: CVPixelBuffer, planeIndex: Int, overrideSize: vImage.Size? = nil, pixelFormat: Format.Type = Format.self)
```

## Parameters

`lockedCVPixelBuffer`

The locked Core Video pixel buffer. Use <doc://com.apple.documentation/documentation/CoreVideo/CVPixelBufferLockBaseAddress(_:_:)> and <doc://com.apple.documentation/documentation/CoreVideo/CVPixelBufferUnlockBaseAddress(_:_:)> to lock and unlock the pixel buffer.

`planeIndex`

The index of the plane that the function references.

`overrideSize`

An optional size that overrides the size returned by <doc://com.apple.documentation/documentation/CoreVideo/CVPixelBufferGetHeightOfPlane(_:_:)> and <doc://com.apple.documentation/documentation/CoreVideo/CVPixelBufferGetWidthOfPlane(_:_:)>. Use this parameter if you intend to pass the buffer to the any-to-any converter that requires all buffers to be the same size.

`pixelFormat`

The pixel format of the initialized buffer.

---

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)