←Select platform

YuvParameters Property

Summary

Gets or sets the YUV conversion properties.

Syntax
C#
VB
C++
public ConversionYuvParameters YuvParameters { get; set; } 
  
Public Property YuvParameters As ConversionYuvParameters 
public: 
property ConversionYuvParameters YuvParameters { 
   ConversionYuvParameters get(); 
   void set (    ConversionYuvParameters ); 
} 

Property Value

A ConversionYuvParameters structure that contains the CIELab conversion properties.

Remarks

The YUV conversion properties. If this property value is null(Nothing), default values are assumed.

Example

This example will convert a buffer from Yuv to Rgb Color Space.

C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ColorConversion; 
 
public byte[] GetYuvBufferFromImage(RasterImage bgrImage) 
{ 
   // StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup(); 
 
   // Image buffer array 
   byte[] bgrBuffer = new byte[bgrImage.Width * bgrImage.Height * 3]; 
 
   bgrImage.Access(); 
   // get image buffer 
   for (int i = 0; i < bgrImage.Height; i++) 
      bgrImage.GetRow(i, bgrBuffer, (i * bgrImage.Width * 3), bgrImage.Width * 3); 
   bgrImage.Release(); 
 
   // Initialize a new Converter object 
   RasterColorConverterEngine converter = new RasterColorConverterEngine(); 
 
   byte[] yuvBuffer = new byte[bgrBuffer.Length]; 
 
   try 
   { 
      // Start the color conversion 
      converter.Start(ConversionColorFormat.Bgr, ConversionColorFormat.Yuv, null); 
 
      // convert the image buffer  
      converter.Convert(bgrBuffer, // input buffer 
         0, // offset from the beginning of the source buffer 
         yuvBuffer, // output buffer 
         0, // offset from the beginning of the destination buffer 
         bgrImage.Width, // pixels width 
         bgrImage.Height, // pixels height 
         0, // 0 bytes align 
         0); // 0 bytes align 
 
      // stop the conversion 
      converter.Stop(); 
   } 
   catch (Exception ex) 
   { 
      MessageBox.Show(ex.Message); 
   } 
 
   RasterColorConverterEngine.Shutdown(); 
 
   return yuvBuffer; 
} 
 
public RasterImage GetImageFromYuvBuffer(byte[] yuvBuffer, int width, int height) 
{ 
   // StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup(); 
 
   // Initialize a new Converter object 
   RasterColorConverterEngine converter = new RasterColorConverterEngine(); 
 
   // Initialize an image to hold the converted buffer. 
   RasterImage yuvImage = null; 
   try 
   { 
      yuvImage = new RasterImage(RasterMemoryFlags.Conventional, width, height, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, null, IntPtr.Zero, 0); 
 
      // Start the color conversion 
      converter.Start(ConversionColorFormat.Yuv, ConversionColorFormat.Bgr, null); 
 
      // convert the image buffer 
      converter.ConvertToImage(yuvBuffer, // converted buffer 
         0,                // offset from the beginning of the source buffer 
         yuvImage,        // image to be save 
         width,   // pixels width 
         height,  // pixels height 
         0,                // 0 bytes align 
         0);               // 0 bytes align 
 
      // stop the conversion 
      converter.Stop(); 
   } 
   catch (Exception ex) 
   { 
      MessageBox.Show(ex.Message); 
   } 
   // Shutdown the ColorConversion. 
   RasterColorConverterEngine.Shutdown(); 
   return yuvImage; 
} 
 
public void YuvParametersPropertyExample() 
{ 
   // Startup the RasterCodecs 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup(); 
 
   // The input file name 
   string inputFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
 
   // load the input image as Bgr. 
   RasterImage bgrImage = codecs.Load(inputFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1); 
 
   int width = bgrImage.Width; 
   int height = bgrImage.Height; 
 
   byte[] yuvBuffer = GetYuvBufferFromImage(bgrImage); 
 
   // Initialize the Rgb 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; 
 
   // set the yuv parameters 
   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 
   RasterColorConverterEngine converter = new RasterColorConverterEngine(); 
 
   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); 
 
      // Change the Yuv Parameters 
      convParams.Method = ConversionMethodFlags.ChangeYuv; 
 
      // Change the MacroPixel value 
      yuvParameters.Mask = ConversionYuvMaskFlags.MacroPixel; 
 
      // Reset the MacroPixel Property. 
      yuvParameters.MacroPixel = 16; 
      convParams.YuvParameters = yuvParameters; 
 
      // 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); 
      rgbBuffer = null; 
   } 
 
   // the output File Name. 
   string outputFileName = Path.Combine(LEAD_VARS.ImagesDir, "ResultImage.bmp"); 
 
   // Save the converted Image 
   RasterImage yuvImage = GetImageFromYuvBuffer(yuvBuffer, width, height); 
   codecs.Save(yuvImage, outputFileName, RasterImageFormat.Bmp, 24); 
 
   // Shutdown the ColorConversion. 
   RasterColorConverterEngine.Shutdown(); 
 
   // Shutdown the RasterCodecs 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ColorConversion 
 
Public Function GetYuvBufferFromImage(ByVal bgrImage As RasterImage) As Byte() 
   ' StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup() 
 
   ' Image buffer array 
   Dim bgrBuffer(bgrImage.Width * bgrImage.Height * 3) As Byte 
 
   ' get image buffer 
   Dim i As Integer 
   bgrImage.Access() 
   For i = 0 To bgrImage.Height 
      bgrImage.GetRow(i, bgrBuffer, (i * bgrImage.Width * 3), bgrImage.Width * 3) 
   Next i 
   bgrImage.Release() 
 
   ' Initialize a new Converter object 
   Dim converter As New RasterColorConverterEngine() 
 
   Dim yuvBuffer(bgrBuffer.Length) As Byte 
 
   Try 
      ' Start the color conversion 
      converter.Start(ConversionColorFormat.Bgr, ConversionColorFormat.Yuv, Nothing) 
 
      ' convert the image buffer  
      converter.Convert(bgrBuffer, 
         0, 
         yuvBuffer, 
         0, 
         bgrImage.Width, 
         bgrImage.Height, 
         0, 
         0) 
 
      ' stop the conversion 
      converter.Stop() 
   Catch ex As Exception 
      MessageBox.Show(ex.Message) 
   End Try 
 
   RasterColorConverterEngine.Shutdown() 
 
   Return yuvBuffer 
End Function 
 
Public Function GetImageFromYuvBuffer(ByVal yuvBuffer As Byte(), ByVal width As Integer, ByVal height As Integer) As RasterImage 
   ' StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup() 
 
   ' Initialize a new Converter object 
   Dim Converter As New RasterColorConverterEngine() 
 
   ' Initialize an image to hold the converted buffer. 
   Dim yuvImage As RasterImage = Nothing 
   Try 
      yuvImage = New RasterImage(RasterMemoryFlags.Conventional, width, height, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, Nothing, IntPtr.Zero, 0) 
 
      ' Start the color conversion 
      Converter.Start(ConversionColorFormat.Yuv, ConversionColorFormat.Bgr, Nothing) 
 
      ' convert the image buffer 
      Converter.ConvertToImage(yuvBuffer, 
         0, 
         yuvImage, 
         width, 
         height, 
         0, 
         0) 
 
      ' stop the conversion 
      Converter.Stop() 
   Catch ex As Exception 
      MessageBox.Show(ex.Message) 
   End Try 
 
   ' Shutdown the ColorConversion. 
   RasterColorConverterEngine.Shutdown() 
   Return yuvImage 
End Function 
 
Public Sub YuvParametersExampleExample() 
   ' Startup the RasterCodecs 
   Dim codecs As New RasterCodecs() 
 
   ' StartUp the ColorConversion. 
   RasterColorConverterEngine.Startup() 
 
   ' The input file name 
   Dim inputFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp") 
 
   ' load the input image as Bgr. 
   Dim bgrImage As RasterImage = codecs.Load(inputFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1) 
 
   Dim width As Integer = bgrImage.Width 
   Dim height As Integer = bgrImage.Height 
   Dim yuvBuffer() As Byte = GetYuvBufferFromImage(bgrImage) 
 
   ' Initialize the Rgb buffer array 
   Dim rgbBuffer(yuvBuffer.Length) As Byte 
 
   ' 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 New RasterColorConverterEngine 
 
   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) 
 
      ' Change the Yuv Parameters 
      convParams.Method = ConversionMethodFlags.ChangeYuv 
 
      ' Change the MacroPixel value 
      yuvParameters.Mask = ConversionYuvMaskFlags.MacroPixel 
 
      ' Reset the MacroPixel Property. 
      yuvParameters.MacroPixel = 16 
      convParams.YuvParameters = yuvParameters 
 
      ' 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) 
      rgbBuffer = Nothing 
   End Try 
 
   ' the output File Name. 
   Dim outputFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "ResultImage.bmp") 
 
   ' Save the converted Image 
   Dim yuvImage As RasterImage = GetImageFromYuvBuffer(yuvBuffer, width, height) 
   codecs.Save(yuvImage, outputFileName, RasterImageFormat.Bmp, 24) 
 
   ' Shutdown the ColorConversion. 
   RasterColorConverterEngine.Shutdown() 
 
   ' Shutdown the RasterCodecs 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class 

Requirements

Target Platforms

Help Version 20.0.2020.3.31
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.ColorConversion Assembly