Generic YUV conversion

The .NET Color Conversion provides direct color conversion to an image. Generic YUV conversion provides the ability to convert any YUV format to any supported color space, using the ConversionYuvParameters class and adhering to the restrictions listed below. After defining the YUV format, you can proceed with the conversion normally, just like any other conversion. Use Convert method to perform the conversion and call Stop method to free the conversion resources used. Currently the conversion from any color space to Generic YUV is not supported.

Generic YUV conversion currently has the following restrictions:

No sub-sampling of Y is supported.
The number of Y elements must be a multiple of both U, and V.
With non-planar formats, vertical sub-sampling of Y, U, and V is not supported.
No alignment supported in planar format; line width must not contain additional bytes.
The horizontal sub-sampling periods of U, and V must be multiples of each other, and the vertical sub-sampling periods of U, and V must be multiples of each other.

Examples

Converting Y41P to RGB using Generic YUV Conversion:

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ColorConversion 
                      
' This example converts Y41P to RGB color space using Generic YUV Conversion. 
Private Function TestConvertGenericY41PToRgb(ByVal yuvBuffer As Byte(), ByVal width As Integer, ByVal height As Integer) As Byte() 
  ' StartUp the ColorConversion. 
  RasterColorConverter.Startup() 
                
  ' Initialize the Lab buffer array 
  Dim rgbBuffer As Byte() = New Byte(yuvBuffer.Length - 1){} 
                
  ' Byte ordering of the format; for Y41P: 
  ' U0 Y0 V0 Y1 U4 Y2 V4 Y3 Y4 Y5 Y6 Y7 
  ' 0    1    2    3    4    5    6    7    8   9    10  11 
  ' Put the Y component order first, then the U and V last as follows: 
  ' Y positions: 1,3,5,7,8,9,10,11 
  ' U positions: 0,4 
  ' V positions: 2,6    
  Dim offset As Integer() = { 1, 3, 5, 7, 8, 9, 10, 11, 0, 4, 2, 6 } 
                
  ' Initialize a new ConversionParameters class object. 
  Dim convParams As ConversionParameters = New ConversionParameters() 
                
  ' Initialize the YuvParameters class property. 
  Dim yuvParameters As ConversionYuvParameters = ConversionYuvParameters.Empty 
                
  ' Determine the horizontal sub-sampling of U 
  yuvParameters.UH = 4 
                
  ' Determine the vertical sub-sampling of U 
  yuvParameters.UV = 1 
                
  ' Determine the horizontal sub-sampling of V 
  yuvParameters.VH = 4 
                
  ' Determine the vertical sub-sampling of V 
  yuvParameters.VV = 1 
                
  ' Set the byte ordering 
  yuvParameters.Offsets = offset 
                
  ' The YUV values range 
  yuvParameters.Range = ConversionYuvRange.UseFull 
                
  ' This represents the macro pixels(smallest group of pixels allowed),  
  ' which indicates how many actual pixels are in the macro pixel.  
  ' This value is important only in non - planar format 
  yuvParameters.MacroPixel = 8 
                
  ' This is a Boolean value that represents the type of the YUV format (Planar = true, or non - Planar = false.) 
  yuvParameters.Planar = False 
                
  convParams.YuvParameters = yuvParameters 
                
  ' Determine the type of conversion to be used in the conversion, for YUVGeneric, only use UseBuiltIn 
  convParams.Method = ConversionMethodFlags.UseBuiltIn 
                
  ' Determine the type of conversion to be activated. For YUVGeneric, only UseBuiltIn 
  convParams.ActiveMethod = ConversionMethodFlags.UseBuiltIn 
                
  ' Initialize a new Converter object 
  Dim converter As RasterColorConverter = New RasterColorConverter() 
                
  Try 
    'Initialize the conversion 
    converter.Start(ConversionColorFormat.Yuv, ConversionColorFormat.Rgb, convParams) 
                
    ' Convert the Buffer from Yuv to Rgb 
    converter.Convert(yuvBuffer, 0, rgbBuffer, 0, width, height, 0, 0) 
                
    ' Stop the conversion 
    converter.Stop() 
  Catch ex As Exception 
    MessageBox.Show(ex.Message) 
    Return Nothing 
  End Try 
                
  ' Shutdown the ColorConversion. 
  RasterColorConverter.Shutdown() 
                
  ' return the converted buffer. 
  Return rgbBuffer 
End Function

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ColorConversion; 
                   
// This example converts Y41P to RGB color space using Generic YUV Conversion. 
private byte[] TestConvertGenericY41PToRgb(byte[] yuvBuffer, int width, int height) 
{ 
   // StartUp the ColorConversion. 
   RasterColorConverter.Startup(); 
             
   // Initialize the Lab buffer array 
   byte[] rgbBuffer = new byte[yuvBuffer.Length]; 
             
   // Byte ordering of the format; for Y41P: 
   // U0 Y0 V0 Y1 U4 Y2 V4 Y3 Y4 Y5 Y6 Y7 
   // 0    1    2    3    4    5    6    7    8   9    10  11 
   // Put the Y component order first, then the U and V last as follows: 
   // Y positions: 1,3,5,7,8,9,10,11 
   // U positions: 0,4 
   // V positions: 2,6    
   int[] offset = { 1, 3, 5, 7, 8, 9, 10, 11, 0, 4, 2, 6 }; 
             
   // Initialize a new ConversionParameters class object. 
   ConversionParameters convParams = new ConversionParameters(); 
             
   // Initialize the YuvParameters class property. 
   ConversionYuvParameters yuvParameters = ConversionYuvParameters.Empty; 
             
   // Determine the horizontal sub-sampling of U 
   yuvParameters.UH = 4; 
             
   // Determine the vertical sub-sampling of U 
   yuvParameters.UV = 1; 
             
   // Determine the horizontal sub-sampling of V 
   yuvParameters.VH = 4; 
             
   // Determine the vertical sub-sampling of V 
   yuvParameters.VV = 1; 
             
   // Set the byte ordering 
   yuvParameters.Offsets = offset; 
             
   // The YUV values range 
   yuvParameters.Range = ConversionYuvRange.UseFull; 
             
   // This represents the macro pixels(smallest group of pixels allowed),  
   // which indicates how many actual pixels are in the macro pixel.  
   // This value is important only in non - planar format 
   yuvParameters.MacroPixel = 8; 
             
   // This is a Boolean value that represents the type of the YUV format (Planar = true, or non - Planar = false.) 
   yuvParameters.Planar = false; 
             
   convParams.YuvParameters = yuvParameters; 
             
   // Determine the type of conversion to be used in the conversion, for YUVGeneric, only use UseBuiltIn 
   convParams.Method = ConversionMethodFlags.UseBuiltIn; 
             
   // Determine the type of conversion to be activated. For YUVGeneric, only UseBuiltIn 
   convParams.ActiveMethod = ConversionMethodFlags.UseBuiltIn; 
             
   // Initialize a new Converter object 
   RasterColorConverter converter = new RasterColorConverter(); 
             
   try 
   { 
      //Initialize the conversion 
      converter.Start(ConversionColorFormat.Yuv, ConversionColorFormat.Rgb, convParams); 
             
      // Convert the Buffer from Yuv to Rgb 
      converter.Convert(yuvBuffer, 0, rgbBuffer, 0, width, height, 0, 0); 
             
      // Stop the conversion 
      converter.Stop(); 
   } 
   catch (Exception ex) 
   { 
      MessageBox.Show(ex.Message); 
      return null; 
   } 
             
   // Shutdown the ColorConversion. 
   RasterColorConverter.Shutdown(); 
             
   // return the converted buffer. 
   return rgbBuffer; 
}

Converting YVU9 (Planar) to RGB using Generic YUV Conversion:

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ColorConversion 
              
' This example converts YVU9 (Planar) to RGB color space using Generic YUV Conversion. 
Private Function TestConvertGenericYVU9ToRGB(ByVal yuvBuffer As Byte(), ByVal width As Integer, ByVal height As Integer) As Byte() 
   ' StartUp the ColorConversion. 
   RasterColorConverter.Startup() 
              
   ' Initialize the Lab buffer array 
   Dim rgbBuffer As Byte() = New Byte(yuvBuffer.Length - 1){} 
              
   ' This array of integers specifies the byte order of the yuv format. For planar formats it takes only a single value that represents the plane sequence in the buffer:  
   '            YUV, YVU, UYV, UVY, VYU, or VUY. 
   Dim offset As Integer() = { ConversionYuvParameters.PlanarYvu } 
              
   'PlanarYuv means the Y plane comes first in the buffer, then the V plane, and the U plane is last. 
   ' Initialize a new Converter object 
   Dim converter As RasterColorConverter = New RasterColorConverter() 
              
   ' Initialize a new ConversionParameters class object. 
   Dim convParams As ConversionParameters = New ConversionParameters() 
              
   ' Initialize the YuvParameters property class. 
   Dim yuvParameters As ConversionYuvParameters = ConversionYuvParameters.Empty 
              
   ' Set the horizontal sub-sampling of U. 
   yuvParameters.UH = 4 
              
   ' Set the vertical sub-sampling of U. 
   yuvParameters.UV = 4 
              
   ' Set the horizontal sub-sampling of V. 
   yuvParameters.VH = 4 
              
   ' Set the vertical sub-sampling of V. 
   yuvParameters.VV = 4 
              
   ' Pass the byte order array. 
   yuvParameters.Offsets = offset 
              
   ' The range value determines the YUV range values. 
   yuvParameters.Range = ConversionYuvRange.UseFull 
              
   ' This represents the macro pixels(smallest group of pixels allowed),  
   ' which indicates how many actual pixels are in the macro pixel.  
   ' This value is important only in non - planar format    
   yuvParameters.MacroPixel = 16 
              
   ' This is a Boolean value that represents the type of the YUV format (Planar, or non - Planar). 
   yuvParameters.Planar = True 
   convParams.YuvParameters = yuvParameters 
              
   ' Set the type of conversion to be used. For YUVGeneric, use only UseBuiltIn. 
   convParams.Method = ConversionMethodFlags.UseBuiltIn 
              
   ' Set the type of conversion to be activated. For YUVGeneric, use only UseBuiltIn. 
   convParams.ActiveMethod = ConversionMethodFlags.UseBuiltIn 
   Try 
      ' Initialize the conversion. 
      converter.Start(ConversionColorFormat.Yuv, ConversionColorFormat.Rgb, convParams) 
      ' Convert the buffer. 
      converter.Convert(yuvBuffer, 0, rgbBuffer, 0, width, height, 0, 0) 
      ' Stop the conversion. 
      converter.Stop() 
   Catch ex As Exception 
      MessageBox.Show(ex.Message) 
      Return Nothing 
   End Try 
   ' Shutdown the ColorConversion. 
   RasterColorConverter.Shutdown() 
   ' return the converted buffer. 
   Return rgbBuffer 
End Function

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ColorConversion; 
                    
// This example converts YVU9 (Planar) to RGB color space using Generic YUV Conversion. 
private byte[] TestConvertGenericYVU9ToRGB(byte[] yuvBuffer, int width, int height) 
{ 
   // StartUp the ColorConversion. 
   RasterColorConverter.Startup(); 
              
   // Initialize the Lab buffer array 
   byte[] rgbBuffer = new byte[yuvBuffer.Length]; 
              
   // This array of integers specifies the byte order of the yuv format. For planar formats it takes only a single value that represents the plane sequence in the buffer:  
   //            YUV, YVU, UYV, UVY, VYU, or VUY. 
   int[] offset = { ConversionYuvParameters.PlanarYvu }; 
   //PlanarYuv means the Y plane comes first in the buffer, then the V plane, and the U plane is last. 
              
   // Initialize a new Converter object 
   RasterColorConverter converter = new RasterColorConverter(); 
              
   // Initialize a new ConversionParameters class object. 
   ConversionParameters convParams = new ConversionParameters(); 
              
   // Initialize the YuvParameters property class. 
   ConversionYuvParameters yuvParameters = ConversionYuvParameters.Empty; 
              
   // Set the horizontal sub-sampling of U. 
   yuvParameters.UH = 4; 
              
   // Set the vertical sub-sampling of U. 
   yuvParameters.UV = 4; 
              
   // Set the horizontal sub-sampling of V. 
   yuvParameters.VH = 4; 
              
   // Set the vertical sub-sampling of V. 
   yuvParameters.VV = 4; 
              
   // Pass the byte order array. 
   yuvParameters.Offsets = offset; 
              
   // The range value determines the YUV range values. 
   yuvParameters.Range = ConversionYuvRange.UseFull; 
              
   // This represents the macro pixels(smallest group of pixels allowed),  
   // which indicates how many actual pixels are in the macro pixel.  
   // This value is important only in non - planar format    
              
   yuvParameters.MacroPixel = 16; 
              
   // This is a Boolean value that represents the type of the YUV format (Planar, or non - Planar). 
   yuvParameters.Planar = true; 
              
   convParams.YuvParameters = yuvParameters; 
              
   // Set the type of conversion to be used. For YUVGeneric, use only UseBuiltIn. 
   convParams.Method = ConversionMethodFlags.UseBuiltIn; 
              
   // Set the type of conversion to be activated. For YUVGeneric, use only UseBuiltIn. 
   convParams.ActiveMethod = ConversionMethodFlags.UseBuiltIn; 
              
   try 
   { 
      // Initialize the conversion. 
      converter.Start(ConversionColorFormat.Yuv, ConversionColorFormat.Rgb, convParams); 
              
      // Convert the buffer. 
      converter.Convert(yuvBuffer, 0, rgbBuffer, 0, width, height, 0, 0); 
              
      // Stop the conversion. 
      converter.Stop(); 
   } 
   catch (Exception ex) 
   { 
      MessageBox.Show(ex.Message); 
      return null; 
   } 
              
   // Shutdown the ColorConversion. 
   RasterColorConverter.Shutdown(); 
              
   // return the converted buffer. 
   return rgbBuffer; 
}