# vImageConvert_PlanarFtoPlanar8_dithered(_:_:_:_:_:_:) Converts a floating-point 32-bit planar buffer to an 8-bit planar buffer using the specified dithering algorithm. ``` func vImageConvert_PlanarFtoPlanar8_dithered(_ src: UnsafePointer, _ dest: UnsafePointer, _ maxFloat: Pixel_F, _ minFloat: Pixel_F, _ dither: Int32, _ flags: vImage_Flags) -> vImage_Error ``` ## Parameters `src` The source vImage buffer. `dest` A pointer to the destination vImage buffer structure. You’re responsible for filling out the [`height`](/documentation/Accelerate/vImage_Buffer/height), [`width`](/documentation/Accelerate/vImage_Buffer/width), and [`rowBytes`](/documentation/Accelerate/vImage_Buffer/rowBytes) fields of this structure, and for allocating a data buffer of the appropriate size. On return, the data buffer this structure points to contains the destination image data. When you no longer need the data buffer, deallocate the memory to prevent memory leaks. `maxFloat` The maximum source pixel value. `minFloat` The minimum source pixel value. `dither` The dithering algorithm. `flags` The options to use when performing the operation. If your code implements its own tiling or its own multithreading, pass [`kvImageDoNotTile`](/documentation/Accelerate/kvImageDoNotTile); otherwise, pass [`kvImageNoFlags`](/documentation/Accelerate/kvImageNoFlags). ## Return Value [`kvImageNoError`](/documentation/Accelerate/kvImageNoError); otherwise, one of the error codes in . ## Discussion This function supports the following dithering algorithms: - [`kvImageConvert_DitherNone`](/documentation/Accelerate/kvImageConvert_DitherNone): Doesn’t apply any dithering. This algorithm rounds the input values to the nearest representable value in the destination format. - [`kvImageConvert_DitherOrdered`](/documentation/Accelerate/kvImageConvert_DitherOrdered): Adds precomputed blue noise to the source image before it rounds the input values to the nearest representable value in the destination format. The vImage conversion functions support uniform and Gaussian noise by including [`kvImageConvert_OrderedUniformBlue`](/documentation/Accelerate/kvImageConvert_OrderedUniformBlue) and [`kvImageConvert_OrderedGaussianBlue`](/documentation/Accelerate/kvImageConvert_OrderedGaussianBlue), respectively. - [`kvImageConvert_DitherOrderedReproducible`](/documentation/Accelerate/kvImageConvert_DitherOrderedReproducible): Returns the same result as [`kvImageConvert_DitherOrdered`](/documentation/Accelerate/kvImageConvert_DitherOrdered), but uses the same offset into the blue noise for each call. - [`kvImageConvert_DitherFloydSteinberg`](/documentation/Accelerate/kvImageConvert_DitherFloydSteinberg): Applies Floyd-Steinberg dithering to the image. - [`kvImageConvert_DitherAtkinson`](/documentation/Accelerate/kvImageConvert_DitherAtkinson): Applies Atkinson dithering to the image. ## See Also --- 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)