---
title: "vImageConvert_YpCbCrToARGB_GenerateConversion(_:_:_:_:_:_:)"
framework: accelerate
role: symbol
role_heading: Function
path: "accelerate/vimageconvert_ypcbcrtoargb_generateconversion(_:_:_:_:_:_:)"
---

# vImageConvert_YpCbCrToARGB_GenerateConversion(_:_:_:_:_:_:)

Generates the information that describes the conversion from YpCbCr to ARGB.

## Declaration

```swift
func vImageConvert_YpCbCrToARGB_GenerateConversion(_ matrix: UnsafePointer<vImage_YpCbCrToARGBMatrix>, _ pixelRange: UnsafePointer<vImage_YpCbCrPixelRange>, _ outInfo: UnsafeMutablePointer<vImage_YpCbCrToARGB>, _ inYpCbCrType: vImageYpCbCrType, _ outARGBType: vImageARGBType, _ flags: vImage_Flags) -> vImage_Error
```

## Parameters

- `matrix`: A pointer to doc://com.apple.accelerate/documentation/Accelerate/vImage_YpCbCrToARGBMatrix that contains the matrix coefficients for the conversion.
- `pixelRange`: A pointer to doc://com.apple.accelerate/documentation/Accelerate/vImage_YpCbCrPixelRange that contains the pixel range information for the conversion.
- `outInfo`: A pointer to doc://com.apple.accelerate/documentation/Accelerate/vImage_YpCbCrToARGB that’s initialized with information for the conversion function to use later.
- `inYpCbCrType`: A doc://com.apple.accelerate/documentation/Accelerate/vImageYpCbCrType to specify the input (YpCbCr) format.
- `outARGBType`: A doc://com.apple.accelerate/documentation/Accelerate/vImageARGBType to specify the output (ARGB) format.
- `flags`: The options to use when performing this operation. Set the doc://com.apple.accelerate/documentation/Accelerate/kvImagePrintDiagnosticsToConsole flag to print debug messages when a problem occurs.

## Return Value

Return Value kvImageNoError; otherwise, one of the error codes in Data Types and Constants.

## Discussion

Discussion You use this function to create the vImage_YpCbCrToARGB conversion information necessary for all YUV-to-RGB conversion functions. The following example shows how to prepare for the conversion of a YUV format with ITU 601 video range to ARGB8888:  vImage_Error err = kvImageNoError;  vImage_Flags flags = kvImageNoFlags;  vImage_YpCbCrPixelRange pixelRange;  vImage_YpCbCrToARGB outInfo;    pixelRange.Yp_bias         =   16;     // The encoding for Y' = 0.0.  pixelRange.CbCr_bias       =  128;     // The encoding for CbCr = 0.0.  pixelRange.YpRangeMax      =  235;     // The encoding for Y'= 1.0.  pixelRange.CbCrRangeMax    =  240;     // The encoding for CbCr = 0.5.  pixelRange.YpMax           =  255;     // A clamping limit above which the value isn't allowed to go. 255 is fastest. Use pixelRange.YpRangeMax if you don't want Y' > 1.  pixelRange.YpMin           =    0;     // A clamping limit below which the value isn't allowed to go. 0 is fastest. Use pixelRange.Yp_bias if you don't want Y' < 0.  pixelRange.CbCrMax         =  255;     // A clamping limit above which the value isn't allowed to go. 255 is fastest.  Use pixelRange.CbCrRangeMax, if you don't want CbCr > 0.5.  pixelRange.CbCrMin         =    0;     // A clamping limit above which the value isn't allowed to go. 0 is fastest.  Use (2*pixelRange.CbCr_bias - pixelRange.CbCrRangeMax), if you don't want CbCr < -0.5.                                         //                ( pixelRange.CbCr_bias - (pixelRange.CbCrRangeMax - pixelRange.CbCr_bias) = 2*pixelRange.CbCr_bias - pixelRange.CbCrRangeMax )    err = vImageConvert_YpCbCrToARGB_GenerateConversion(kvImageITU601_YpCbCrToARGBMatrix, &pixelRange, &outInfo, kvImage422YpCbYpCr8, kvImageARGB8888, flags); The following example shows how you might define your own conversion coefficients:  vImage_YpCbCrToARGBMatrix matrix;  vImage_YpCbCrPixelRange pixelRange;    matrix.Yp                  =  1.0f;  matrix.Cb_G                = -0.3441f;  matrix.Cb_B                =  1.772f;  matrix.Cr_R                =  1.402f;  matrix.Cr_G                = -0.7141f;  pixelRange.Yp_bias         =   16;     // The encoding for Y' = 0.0.  pixelRange.CbCr_bias       =  128;     // The encoding for CbCr = 0.0.  pixelRange.YpRangeMax      =  235;     // The encoding for Y'= 1.0.  pixelRange.CbCrRangeMax    =  240;     // The encoding for CbCr = 0.5.  pixelRange.YpMax           =  255;     // A clamping limit above which the value isn't allowed to go. 255 is fastest. Use pixelRange.YpRangeMax if you don't want Y' > 1.  pixelRange.YpMin           =    0;     // A clamping limit below which the value isn't allowed to go. 0 is fastest. Use pixelRange.Yp_bias if you don't want Y' < 0.  pixelRange.CbCrMax         =  255;     // A clamping limit above which the value isn't allowed to go. 255 is fastest.  Use pixelRange.CbCrRangeMax, if you don't want CbCr > 0.5.  pixelRange.CbCrMin         =    0;     // A clamping limit above which the value isn't allowed to go. 0 is fastest.  Use (2*pixelRange.CbCr_bias - pixelRange.CbCrRangeMax), if you don't want CbCr < -0.5.                                         //                ( pixelRange.CbCr_bias - (pixelRange.CbCrRangeMax - pixelRange.CbCr_bias) = 2*pixelRange.CbCr_bias - pixelRange.CbCrRangeMax )  err = vImageConvert_YpCbCrToARGB_GenerateConversion(&matrix, &pixelRange, &outInfo, kvImage422YpCbYpCr8, kvImageARGB8888, flags) The vImage_YpCbCrToARGB structure this function creates can be reused concurrently, multiple times from multiple threads. The conversions that are available are:  |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |

## See Also

### Generating conversion information

- [vImageYpCbCrType](accelerate/vimageypcbcrtype.md)
- [vImageARGBType](accelerate/vimageargbtype.md)
- [vImage_YpCbCrToARGBMatrix](accelerate/vimage_ypcbcrtoargbmatrix.md)
- [vImage_YpCbCrToARGB](accelerate/vimage_ypcbcrtoargb.md)
- [vImage_YpCbCrPixelRange](accelerate/vimage_ypcbcrpixelrange.md)