Convert(IntPtr,long,IntPtr,long,int,int,int,int) Method

Summary

Converts image data in a buffer from one color conversion model to another.

Syntax

C++/CLI

Python

public void Convert( 
   IntPtr srcBuffer, 
   long srcBufferOffset, 
   IntPtr destBuffer, 
   long destBufferOffset, 
   int width, 
   int height, 
   int inAlign, 
   int outAlign 
)

public: 
void Convert(  
   IntPtr srcBuffer, 
   int64 srcBufferOffset, 
   IntPtr destBuffer, 
   int64 destBufferOffset, 
   int width, 
   int height, 
   int inAlign, 
   int outAlign 
)

def Convert(self,srcBuffer,srcBufferOffset,destBuffer,destBufferOffset,width,height,inAlign,outAlign):

Parameters

srcBuffer
A pointer to a buffer containing the input data.

srcBufferOffset
Offset to the first byte of the srcBuffer data buffer.

destBuffer
A pointer to a buffer that will hold the converted data.

destBufferOffset
Offset to the first byte of the destBuffer data buffer.

width
Width of pixels to be processed.

height
Height of pixels to be processed.

inAlign
Each scanline in the input buffer is a multiple of inAlign bytes.

outAlign
Each scan line in the output buffer is a multiple of outAlign bytes.

Remarks

Conversion is done by setting the active method value specified in ActiveMethod property. To change the active method, use SetParameters method. To convert to the Yp41 type the input image width must be multiple of 8

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ColorConversion; 
 
 
       
public void StartupExample() 
{ 
   // Initialize the RasterCodecs class  
   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); 
 
   // Image buffer array  
   byte[] bgrBuffer = new byte[bgrImage.BytesPerLine * bgrImage.Height]; 
 
   bgrImage.Access(); 
   // get image buffer  
   for (int i = 0; i < bgrImage.Height; i++) 
      bgrImage.GetRow(i, bgrBuffer, i * bgrImage.BytesPerLine, bgrImage.BytesPerLine); 
   bgrImage.Release(); 
 
   // Initialize a new Converter object  
   RasterColorConverterEngine converter = new RasterColorConverterEngine(); 
 
   byte[] cmykBuffer = new byte[bgrImage.Height * bgrImage.Width * 4]; 
 
   try 
   { 
      // Start the color conversion  
      converter.Start(ConversionColorFormat.Bgr, ConversionColorFormat.Cmyk, null); 
 
      // convert the image buffer   
      converter.Convert(bgrBuffer, // input buffer  
         0, // offset from the beginning of the source buffer  
         cmykBuffer, // output buffer  
         0, // offset from the beginning of the destination buffer  
         bgrImage.Width, // pixels width  
         bgrImage.Height, // pixels height  
         bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8)), 
         0); // 0 bytes align 
 
      // stop the conversion  
      converter.Stop(); 
 
      // Initialize an image to hold the converted buffer.  
      RasterImage cmykImage = new RasterImage(RasterMemoryFlags.Conventional, bgrImage.Width, bgrImage.Height, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, null, IntPtr.Zero, 0); 
 
      // Start the color conversion  
      converter.Start(ConversionColorFormat.Cmyk, ConversionColorFormat.Bgr, null); 
 
      // convert the image buffer  
      converter.ConvertToImage(cmykBuffer, // converted buffer  
         0,                // offset from the beginning of the source buffer  
         cmykImage,        // image to be save  
         bgrImage.Width,   // pixels width  
         bgrImage.Height,  // pixels height  
         0,                // 0 bytes align  
         bgrImage.BytesPerLine - (bgrImage.Width * (bgrImage.BitsPerPixel / 8))); 
 
      // stop the conversion  
      converter.Stop(); 
 
      // the output File Name.  
      string outputFileName = Path.Combine(LEAD_VARS.ImagesDir, "ResultImage.bmp"); 
 
      // Save the result image.  
      codecs.Save(cmykImage, outputFileName, RasterImageFormat.Bmp, 24); 
 
      // dispose of the used images  
      bgrImage.Dispose(); 
      cmykImage.Dispose(); 
   } 
   catch (Exception ex) 
   { 
      Debug.WriteLine(ex.ToString()); 
   } 
 
   // Shutdown the ColorConversion.  
   RasterColorConverterEngine.Shutdown(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}