CodecsRasterizeDocumentLoadOptions Class

using Leadtools;
using Leadtools.Codecs;

public async Task RasterizeDocumentExample()
{
   // Initialize the RasterCodecs object to use
   RasterCodecs codecs = new RasterCodecs();
   // Enable using the RasterizeDocumentOptions
   CodecsRasterizeDocumentLoadOptions rasterizeDocumentLoadOptions = codecs.Options.RasterizeDocument.Load;

   // No margins (only used with RTF and TXT files)
   rasterizeDocumentLoadOptions.LeftMargin = 0;
   rasterizeDocumentLoadOptions.TopMargin = 0;
   rasterizeDocumentLoadOptions.RightMargin = 0;
   rasterizeDocumentLoadOptions.BottomMargin = 0;

   // The PDF file we are testing. This could be an XPS, RTF, TXT or XLS file as well
   string srcFileName = @"Assets\Leadtools.pdf";

   // Show the file information
   StorageFile loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   using (CodecsImageInfo imageInfo = await codecs.GetInformationAsync(LeadStreamFactory.Create(loadFile), true, 1))
   {
      CodecsDocumentImageInfo documentImageInfo = imageInfo.Document;

      // If this is a document file, show the document information
      if (documentImageInfo.IsDocumentFile)
      {
         Debug.WriteLine("Document file");
         Debug.WriteLine("  Original size is: {0} by {1} {2}",
            documentImageInfo.PageWidth, documentImageInfo.PageHeight, documentImageInfo.Unit);

         Debug.WriteLine("  Using current rasterization, load size will be: {0} by {1} pixels at {2} by {3}",
            imageInfo.Width, imageInfo.Height, imageInfo.XResolution, imageInfo.YResolution);
      }
      else
      {
         // Regular raster image, show the image information
         Debug.WriteLine("Raster file");
         Debug.WriteLine("  Original size is: {0} by {1} pixels at {2} by {3}",
            imageInfo.Width, imageInfo.Height, imageInfo.XResolution, imageInfo.YResolution);
      }
   }

   // Example 1. Load at original document size at 300 DPI
   rasterizeDocumentLoadOptions.SizeMode = CodecsRasterizeDocumentSizeMode.None;
   rasterizeDocumentLoadOptions.XResolution = 300;
   rasterizeDocumentLoadOptions.YResolution = 300;

   loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   using (RasterImage srcImage = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile), 0, CodecsLoadByteOrder.Bgr, 1, 1))
   {
      ShowResult(codecs, srcImage);
   }

   // Example 2. Fit the document at 640 by 480 pixels at 96 DPI keeping the aspect ratio
   rasterizeDocumentLoadOptions.SizeMode = CodecsRasterizeDocumentSizeMode.Fit;
   rasterizeDocumentLoadOptions.PageWidth = 640;
   rasterizeDocumentLoadOptions.PageHeight = 480;
   rasterizeDocumentLoadOptions.Unit = CodecsRasterizeDocumentUnit.Pixel;
   rasterizeDocumentLoadOptions.XResolution = 96;
   rasterizeDocumentLoadOptions.YResolution = 96;

   loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   using (RasterImage srcImage = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile), 0, CodecsLoadByteOrder.Bgr, 1, 1))
   {
      ShowResult(codecs, srcImage);
   }

   // Example 3. Fit the document at 8.5 by 11 inches at 96 DPI keeping the aspect ratio
   rasterizeDocumentLoadOptions.SizeMode = CodecsRasterizeDocumentSizeMode.Fit;
   rasterizeDocumentLoadOptions.PageWidth = 8.5;
   rasterizeDocumentLoadOptions.PageHeight = 11;
   rasterizeDocumentLoadOptions.Unit = CodecsRasterizeDocumentUnit.Inch;
   rasterizeDocumentLoadOptions.XResolution = 300;
   rasterizeDocumentLoadOptions.YResolution = 300;

   loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   using (RasterImage srcImage = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile), 0, CodecsLoadByteOrder.Bgr, 1, 1))
   {
      ShowResult(codecs, srcImage);
   }

   // Example 4. Stretch the image to always be 4 by 4 inches at 150 DPI. Aspect ratio may differ
   rasterizeDocumentLoadOptions.SizeMode = CodecsRasterizeDocumentSizeMode.Stretch;
   rasterizeDocumentLoadOptions.PageWidth = 4;
   rasterizeDocumentLoadOptions.PageHeight = 4;
   rasterizeDocumentLoadOptions.Unit = CodecsRasterizeDocumentUnit.Inch;
   rasterizeDocumentLoadOptions.XResolution = 150;
   rasterizeDocumentLoadOptions.YResolution = 150;

   loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   using (RasterImage srcImage = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile), 0, CodecsLoadByteOrder.Bgr, 1, 1))
   {
      ShowResult(codecs, srcImage);
   }

   codecs.Dispose();
}

private static void ShowResult(RasterCodecs codecs, RasterImage image)
{
   CodecsRasterizeDocumentLoadOptions rasterizeDocumentLoadOptions = codecs.Options.RasterizeDocument.Load;

   Debug.WriteLine("Showing result..");
   Debug.WriteLine("  Current rasterization options:");
   Debug.WriteLine("    Size mode is: {0}", rasterizeDocumentLoadOptions.SizeMode);
   Debug.WriteLine("    Page size is {0} by {1} {2}",
      rasterizeDocumentLoadOptions.PageWidth, rasterizeDocumentLoadOptions.PageHeight, rasterizeDocumentLoadOptions.Unit);
   Debug.WriteLine("    Resolution is {0} by {1}",
      rasterizeDocumentLoadOptions.XResolution, rasterizeDocumentLoadOptions.YResolution);

   Debug.WriteLine("  Loaded raster image size is: {0} by {1} at {2} by {3}",
      image.ImageWidth, image.ImageHeight, image.XResolution, image.YResolution);

   // Code to verify our results

   // Get the suggested page width and height in pixels
   double pageWidthInPixels;
   double pageHeightInPixels;

   switch (rasterizeDocumentLoadOptions.Unit)
   {
      case CodecsRasterizeDocumentUnit.Inch:
         pageWidthInPixels = rasterizeDocumentLoadOptions.PageWidth * rasterizeDocumentLoadOptions.XResolution;
         pageHeightInPixels = rasterizeDocumentLoadOptions.PageHeight * rasterizeDocumentLoadOptions.YResolution;
         break;

      case CodecsRasterizeDocumentUnit.Millimeter:
         pageWidthInPixels = rasterizeDocumentLoadOptions.PageWidth * rasterizeDocumentLoadOptions.XResolution * 25.400000025908000026426160026955;
         pageHeightInPixels = rasterizeDocumentLoadOptions.PageHeight * rasterizeDocumentLoadOptions.YResolution * 25.400000025908000026426160026955;
         break;

      case CodecsRasterizeDocumentUnit.Pixel:
      default:
         pageWidthInPixels = rasterizeDocumentLoadOptions.PageWidth;
         pageHeightInPixels = rasterizeDocumentLoadOptions.PageHeight;
         break;
   }

   // Verify
   switch (rasterizeDocumentLoadOptions.SizeMode)
   {
      case CodecsRasterizeDocumentSizeMode.Fit:
      case CodecsRasterizeDocumentSizeMode.FitAlways:
         // The image width/height must not be greater than suggested page width/height
         Debug.WriteLine("Image width/height must be less than or equal to page width/height");
         Assert.IsTrue(image.ImageWidth <= pageWidthInPixels);
         Assert.IsTrue(image.ImageHeight <= pageHeightInPixels);
         break;

      case CodecsRasterizeDocumentSizeMode.FitWidth:
         // The image width must be equal to the suggested page width
         Debug.WriteLine("Image width must be equal to page width");
         Assert.IsTrue(image.ImageWidth == pageWidthInPixels);
         break;

      case CodecsRasterizeDocumentSizeMode.Stretch:
         // The image width/height must be equal to the suggested page width/height
         Debug.WriteLine("Image width/height must be equal to suggested page width/height");
         Assert.IsTrue(image.ImageWidth == pageWidthInPixels);
         Assert.IsTrue(image.ImageHeight == pageHeightInPixels);
         break;

      case CodecsRasterizeDocumentSizeMode.None:
      default:
         Debug.WriteLine("Loading at original document page size");
         // No checking
         break;
   }
}