applyLookup(_:destination:)
Applies a lookup table to transform an 8-bit planar image to a 32-bit planar image.
Declaration
func applyLookup(_ lookupTable: [Pixel_F], destination: vImage.PixelBuffer<vImage.PlanarF>)Parameters
- lookupTable:
A lookup table that contains 256 Pixel_f values.
- destination:
The destination pixel buffer.
Discussion
You can use this function to create custom response curves (that is, the value of an output pixel based on the value of the corresponding input pixel). Changing the shape of the response curve changes the brightness and contrast of an image.
The following code creates a simple lookup table that’s based on a sigmoid function. This example uses BNNS to create 256 Float values in the range 0...1 that describe a sigmoid curve. The code uses the sigmoid as the lookup table.
let count = 256
// The following lines populate the array descriptor with sigmoid
// curve values in the range 0...1:
let sigmoidSourceValues: [Float] = vDSP.ramp(in: -10 ... 10,
count: count)
let descriptor = BNNSNDArrayDescriptor.allocate(initializingFrom: sigmoidSourceValues,
shape: .vector(count))
defer {
descriptor.deallocate()
}
let activationLayer = BNNS.ActivationLayer(function: .sigmoid,
input: descriptor,
output: descriptor,
filterParameters: nil)
try? activationLayer!.apply(batchSize: 1,
input: descriptor,
output: descriptor)
let lookup = descriptor.makeArray(of: Float.self)!
let destinationBuffer = vImage.PixelBuffer(
size: sourceBuffer.size,
pixelFormat: vImage.PlanarF.self)The graph below visualizes the values in the lookup table:
[Image]
Use the following code to apply the lookup table to a vImage.Planar8 source buffer and write the result to a vImage.PlanarF destination buffer:
let destinationBuffer = vImage.PixelBuffer(
size: sourceBuffer.size,
pixelFormat: vImage.PlanarF.self)
sourceBuffer.applyLookup(lookup, destination: destinationBuffer)The images below show an example grayscale source image on the left and the transformed result on the right. The operation flattens the response for very dark and very bright areas and increases the contrast in the destination image.
[Image]