# Transforming with lookup tables Use lookup tables to apply color transformations to images. ## Discussion Lookup table functions use the value of a source pixel as an index into a lookup table of colors that defines the corresponding destination pixel. You can use lookup table functions to perform tasks, such as color grading, converting between color spaces, or generating false-color images. ## Topics ### Transforming planar-to-planar with a lookup table [`func vImageTableLookUp_Planar8(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageTableLookUp_Planar8(_:_:_:_:)) Uses a lookup table to transform an 8-bit planar image to an 8-bit planar image. [`func vImageLookupTable_PlanarFtoPlanar8(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_PlanarFtoPlanar8(_:_:_:_:)) Uses a lookup table to transform a 32-bit planar image to an 8-bit planar image. [`func vImageLookupTable_Planar8toPlanar16(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_Planar8toPlanar16(_:_:_:_:)) Uses a lookup table to transform an 8-bit planar image to an unsigned 16-bit planar image. [`func vImageLookupTable_Planar8toPlanarF(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_Planar8toPlanarF(_:_:_:_:)) Uses a lookup table to transform an 8-bit planar image to a 32-bit planar image. [`func vImageLookupTable_8to64U(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_8to64U(_:_:_:_:)) Uses a lookup table to transform an 8-bit planar image to a 64-bit planar image. [`func vImageLookupTable_Planar16(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_Planar16(_:_:_:_:)) Uses a lookup table to transform a 16-bit planar image. [`func vImageInterpolatedLookupTable_PlanarF(UnsafePointer, UnsafePointer, UnsafePointer, vImagePixelCount, Float, Float, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageInterpolatedLookupTable_PlanarF(_:_:_:_:_:_:_:)) Uses an interpolated lookup table to transform a 32-bit planar image. ### Transforming planar-to-interleaved with a lookup table [`func vImageLookupTable_Planar8toPlanar24(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_Planar8toPlanar24(_:_:_:_:)) Uses a lookup table to transform an 8-bit planar image to an 8-bit-per-channel, three-channel interleaved image. [`func vImageLookupTable_Planar8toPlanar48(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_Planar8toPlanar48(_:_:_:_:)) Uses a lookup table to transform an 8-bit planar image to a 16-bit-per-channel, three-channel interleaved image. [`func vImageLookupTable_Planar8toPlanar96(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_Planar8toPlanar96(_:_:_:_:)) Uses a lookup table to transform an 8-bit planar image to a 32-bit-per-channel, three-channel interleaved image. [`func vImageLookupTable_Planar8toPlanar128(UnsafePointer, UnsafePointer, UnsafePointer, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageLookupTable_Planar8toPlanar128(_:_:_:_:)) Uses a lookup table to transform an 8-bit planar image to a 32-bit-per-channel, four-channel interleaved image. ### Transforming interleaved-to-interleaved with a lookup table [`func vImageTableLookUp_ARGB8888(UnsafePointer, UnsafePointer, UnsafePointer!, UnsafePointer!, UnsafePointer!, UnsafePointer!, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageTableLookUp_ARGB8888(_:_:_:_:_:_:_:)) Uses a lookup table to transform an interleaved, four-channel 8-bit planar image to an interleaved, four-channel 8-bit planar image. ### Transforming with a multidimensional lookup table [`func vImageMultidimensionalTable_Create(UnsafePointer, UInt32, UInt32, UnsafePointer, vImageMDTableUsageHint, vImage_Flags, UnsafeMutablePointer!) -> vImage_MultidimensionalTable!`](/documentation/Accelerate/vImageMultidimensionalTable_Create(_:_:_:_:_:_:_:)) Creates a multidimensional lookup table. [`func vImageMultiDimensionalInterpolatedLookupTable_PlanarF(UnsafePointer, UnsafePointer, UnsafeMutableRawPointer!, vImage_MultidimensionalTable, vImage_InterpolationMethod, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageMultiDimensionalInterpolatedLookupTable_PlanarF(_:_:_:_:_:_:)) Uses a multidimensional lookup table to transform a 32-bit planar image. [`func vImageMultiDimensionalInterpolatedLookupTable_Planar16Q12(UnsafePointer, UnsafePointer, UnsafeMutableRawPointer!, vImage_MultidimensionalTable, vImage_InterpolationMethod, vImage_Flags) -> vImage_Error`](/documentation/Accelerate/vImageMultiDimensionalInterpolatedLookupTable_Planar16Q12(_:_:_:_:_:_:)) Uses a multidimensional lookup table to transform a 16Q12 planar image. [`func vImageMultidimensionalTable_Retain(vImage_MultidimensionalTable!) -> vImage_Error`](/documentation/Accelerate/vImageMultidimensionalTable_Retain(_:)) Retains a multidimensional table. [`func vImageMultidimensionalTable_Release(vImage_MultidimensionalTable!) -> vImage_Error`](/documentation/Accelerate/vImageMultidimensionalTable_Release(_:)) Releases a multidimensional table. [`typealias vImage_MultidimensionalTable`](/documentation/Accelerate/vImage_MultidimensionalTable) An opaque pointer that represents a multidimensional lookup table. [`struct vImageMDTableUsageHint`](/documentation/Accelerate/vImageMDTableUsageHint) Constants that indicate the use for a multidimensional lookup table. [`struct vImage_InterpolationMethod`](/documentation/Accelerate/vImage_InterpolationMethod) Constants that represent different interpolation methods. --- Copyright © 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)