---
title: "init(referencing:converter:destinationPixelFormat:)"
framework: accelerate
role: symbol
role_heading: Initializer
path: "accelerate/vimage/pixelbuffer/init(referencing:converter:destinationpixelformat:)"
---

# init(referencing:converter:destinationPixelFormat:)

Returns a new pixel buffer that references the specified Core Video pixel buffer and populated converter.

## Declaration

```swift
init(referencing lockedCVPixelBuffer: CVPixelBuffer, converter: vImageConverter, destinationPixelFormat: 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.
- `converter`: The vImage Core Video to Core Graphics any-to-any converter.
- `destinationPixelFormat`: The pixel format of the initialized buffer.

## Discussion

Discussion The following code shows how to incorporate a vImage pixel buffer into a CIImageProcessorKernel instance. The code calls init(referencing:converter:destinationPixelFormat:) to initialize a source and destination vImage pixel buffers that share data with the processor kernel’s input and output. class ContrastStretchImageProcessorKernel: CIImageProcessorKernel {          static var cgImageFormat = vImage_CGImageFormat(         bitsPerComponent: 8,         bitsPerPixel: 32,         colorSpace: CGColorSpaceCreateDeviceRGB(),         bitmapInfo: CGBitmapInfo(rawValue: CGImageAlphaInfo.noneSkipLast.rawValue),         renderingIntent: .defaultIntent)!          static let cvImageFormat = vImageCVImageFormat.make(         format: .format32BGRA,         colorSpace: CGColorSpaceCreateDeviceRGB(),         alphaIsOpaqueHint: true)!          static let converter = try! vImageConverter.make(sourceFormat: cvImageFormat,                                                      destinationFormat: cgImageFormat)          override class var outputFormat: CIFormat {         return CIFormat.BGRA8     }          override class func formatForInput(at input: Int32) -> CIFormat {         return CIFormat.BGRA8     }          override class func process(with inputs: [CIImageProcessorInput]?,                                 arguments: [String: Any]?,                                 output: CIImageProcessorOutput) throws {                  guard             let input = inputs?.first,             let inputPixelBuffer = input.pixelBuffer,             let outputPixelBuffer = output.pixelBuffer else {                 return             }                  CVPixelBufferLockBaseAddress(inputPixelBuffer,                                      CVPixelBufferLockFlags.readOnly)         CVPixelBufferLockBaseAddress(outputPixelBuffer,                                      CVPixelBufferLockFlags(rawValue: 0))                  defer {             CVPixelBufferUnlockBaseAddress(inputPixelBuffer,                                            CVPixelBufferLockFlags.readOnly)             CVPixelBufferUnlockBaseAddress(outputPixelBuffer,                                            CVPixelBufferLockFlags(rawValue: 0))         }                  let source = vImage.PixelBuffer(             referencing: inputPixelBuffer,             converter: converter,             destinationPixelFormat: vImage.Interleaved8x4.self)                  let destination = vImage.PixelBuffer(             referencing: outputPixelBuffer,             converter: converter,             destinationPixelFormat: vImage.Interleaved8x4.self)                  source.contrastStretch(destination: destination)     } }

## See Also

### Related Documentation

- [vImageBuffer_InitForCopyFromCVPixelBuffer(_:_:_:_:)](accelerate/vimagebuffer_initforcopyfromcvpixelbuffer(_:_:_:_:).md)

### Creating a pixel buffer from a Core Video buffer

- [init(copying:cvImageFormat:cgImageFormat:pixelFormat:)](accelerate/vimage/pixelbuffer/init(copying:cvimageformat:cgimageformat:pixelformat:).md)
- [init(referencing:planeIndex:overrideSize:pixelFormat:)](accelerate/vimage/pixelbuffer/init(referencing:planeindex:overridesize:pixelformat:).md)