In This Topic ▼

rasterImageFormat Property

Summary

Output format to use for raster conversion.

Syntax

TypeScript

JavaScript

Object.defineProperty(DocumentConverterJobData.prototype, 'rasterImageFormat', 
   get: function(), 
   set: function(value) 
)

rasterImageFormat: RasterImageFormat;

Property Value

The output format to use for raster conversion.

Remarks

Jobs can be converted using document or raster formats for the output. To convert to a document format (using LEADTOOLS Document Writer), set DocumentFormat to the desired DocumentFormat value and set RasterImageFormat to RasterImageFormat.Unknown.

To convert to a raster format (using LEADTOOLS Raster Codecs), set RasterImageFormat to the desired RasterImageFormat value and set DocumentFormat to DocumentFormat.User.

Therefore, one of DocumentFormat and RasterImageFormat is used during the conversion, otherwise, an exception will be thrown.

Use RasterImageBitsPerPixel to set the bits/pixel value to use for the output document when using raster conversion.

Optimized TIFF or PDF output:

TIFF and PDF files support different raster compression per page and this can be used to greatly decrease the size of the output file. The user can take advantage of this by using the special values described below.

When RasterImageFormat is either RasterImageFormat.Tif (by default, means uncompressed TIFF) or RasterImageFormat.RasPdf (by default, means uncompressed raster PDF) and RasterImageBitsPerPixel is 0 (the default value), then the converter will deduce that the user wishes to convert to a raster TIFF or PDF with optimized compression depending on the bits per pixel value of the image of each input page.

The values used for PDF are obtained from the current PdfDocumentOptions properties of oneBitImageCompression (default value of jbig2) and coloredImageCompression (default value of jpeg). These values are translated to the equivalent RasterImageFormat value during conversion.

For instance, if the input is a TIFF or PDF file with page 1, a monochrome 1 bit per pixel image, and page 2, a color 24 bits per pixel image, then using the values described above the converter will generate the following:

RasterImageFormat.rasPdf and 0 for rasterImageBitsPerPixel: Page 1 will be compressed using the value set in the oneBitImageCompression property of the PdfDocumentOptions object. If this value is the default of jbig2 for instance, then RasterImageFormat.rasPdfJbig2 will be used. Page 2 will be compressed using the value set in the coloredImageCompression property. If this value is the default of jpeg, then RasterImageFormat.rasPdfJpeg411 will be used.

RasterImageFormat.tif and 0 for rasterImageBitsPerPixel: Page 1 will be compressed using RasterImageFormat.ccittGroup4 and page 2 will be compressed using RasterImageFormat.tifJpeg411.

In either case, set the quality factor value for JPEG compression as usual in CodecsJpegSaveOptions.QualityFactor used by RasterCodecs instance on the service.

Any other value means the user has set the format or bits per pixel to a specific value and the auto-optimization technique will not be used.

Example

Convert.ts

DocumentHelper.ts

Convert.js

DocumentHelper.js

Convert.html

import { DocumentHelper } from "../../utilities/DocumentHelper"; 
 
export class LEADDocument_ConvertExample { 
   public constructor() { 
      lt.RasterSupport.setLicenseUri("https://demo.leadtools.com/licenses/js/LEADTOOLSEVAL.txt", "EVAL", null); 
      DocumentHelper.initFactory(); 
   } 
 
   public run = (buttonID: string) => { 
      const exampleButton = document.getElementById(buttonID); 
      exampleButton.onclick = this.convert; 
   } 
 
   /** 
     * Converts a LEADDocument 
     */ 
   convert = () => { 
      const url = "https://demo.leadtools.com/images/pdf/leadtools.pdf"; 
      const loadDocumentOptions = new lt.Document.LoadDocumentOptions(); 
 
      DocumentHelper.log("Loading document..."); 
      lt.Document.DocumentFactory.loadFromUri(url, loadDocumentOptions) 
         .done((document: lt.Document.LEADDocument) => { 
            DocumentHelper.log("Loaded, converting..."); 
            const jobData = new lt.Document.DocumentConverterJobData(); 
            jobData.documentFormat = lt.Document.Writer.DocumentFormat.docx; 
            jobData.rasterImageFormat = lt.Document.RasterImageFormat.unknown; 
 
            // Set document options 
            const docxOptions = new lt.Document.Writer.DocxDocumentOptions(); 
            docxOptions.textMode = lt.Document.Writer.DocumentTextMode.auto; 
            jobData.documentOptions = docxOptions; 
 
            document.convert(jobData) 
               .done((result: any) => { 
                  // This is generic code, we know the result is in "document" since DOCX supports that 
                  // But this code checks if the results have been archived into a ZIP file if this 
                  // example was converting to, say SVG 
                  const resultDocument = result.document != null ? result.document.url : result.archive.url; 
                  const link = window.document.createElement("a"); 
                  const url = lt.Document.DocumentFactory.serviceUri + "/" + resultDocument; 
                  link.href = url; 
                  link.innerHTML = url; 
                  link.target = "_default"; 
                  DocumentHelper.log("Converted: " + url, url); 
 
               }) 
               .fail(DocumentHelper.showServiceError); 
         }) 
         .fail(DocumentHelper.showServiceError); 
   } 
}

export class DocumentHelper { 
   static showServiceError = (jqXHR, statusText, errorThrown) => { 
      alert("Error returned from service. See the console for details."); 
      const serviceError = lt.Document.ServiceError.parseError(jqXHR, statusText, errorThrown); 
      console.error(serviceError); 
   } 
 
   static log = (message: string, data?: any) => { 
      const outputElement = document.getElementById("output"); 
      if (outputElement) { 
         const time = (new Date()).toLocaleTimeString(); 
         const textElement = document.createElement("p"); 
         textElement.innerHTML = (outputElement.childElementCount + 1) + " [" + time + "]: " + message; 
         outputElement.insertBefore(textElement, outputElement.firstChild); 
      } 
 
      if (!data) 
         console.log(message); 
      else 
         console.log(message, data); 
   } 
 
   static initFactory = () => { 
      // To communicate with the DocumentsService, it must be running! 
      // Change these parameters to match the path to the service. 
      lt.Document.DocumentFactory.serviceHost = "http://localhost:40000"; 
      lt.Document.DocumentFactory.servicePath = ""; 
      lt.Document.DocumentFactory.serviceApiPath = "api"; 
   } 
}

import { DocumentHelper } from "../../utilities/DocumentHelper"; 
 
export class LEADDocument_ConvertExample { 
   constructor() { 
      lt.RasterSupport.setLicenseUri("https://demo.leadtools.com/licenses/js/LEADTOOLSEVAL.txt", "EVAL", null); 
      DocumentHelper.initFactory(); 
   } 
 
   run = (buttonID) => { 
      const exampleButton = document.getElementById(buttonID); 
      exampleButton.onclick = this.convert; 
   } 
 
   /** 
     * Converts a LEADDocument 
     */ 
   convert = () => { 
      const url = "https://demo.leadtools.com/images/pdf/leadtools.pdf"; 
      const loadDocumentOptions = new lt.Document.LoadDocumentOptions(); 
 
      DocumentHelper.log("Loading document..."); 
      lt.Document.DocumentFactory.loadFromUri(url, loadDocumentOptions) 
         .done((document) => { 
            DocumentHelper.log("Loaded, converting..."); 
            const jobData = new lt.Document.DocumentConverterJobData(); 
            jobData.documentFormat = lt.Document.Writer.DocumentFormat.docx; 
            jobData.rasterImageFormat = lt.Document.RasterImageFormat.unknown; 
 
            // Set document options 
            const docxOptions = new lt.Document.Writer.DocxDocumentOptions(); 
            docxOptions.textMode = lt.Document.Writer.DocumentTextMode.auto; 
            jobData.documentOptions = docxOptions; 
 
            document.convert(jobData) 
               .done((result) => { 
                  // This is generic code, we know the result is in "document" since DOCX supports that 
                  // But this code checks if the results have been archived into a ZIP file if this 
                  // example was converting to, say SVG 
                  const resultDocument = result.document != null ? result.document.url : result.archive.url; 
                  const link = window.document.createElement("a"); 
                  const url = lt.Document.DocumentFactory.serviceUri + "/" + resultDocument; 
                  link.href = url; 
                  link.innerHTML = url; 
                  link.target = "_default"; 
                  DocumentHelper.log("Converted: " + url, url); 
 
               }) 
               .fail(DocumentHelper.showServiceError); 
         }) 
         .fail(DocumentHelper.showServiceError); 
   } 
}

export class DocumentHelper { 
   static showServiceError = (jqXHR, statusText, errorThrown) => { 
      alert("Error returned from service. See the console for details."); 
      const serviceError = lt.Document.ServiceError.parseError(jqXHR, statusText, errorThrown); 
      console.error(serviceError); 
   } 
 
   static log = (message, data) => { 
      const outputElement = document.getElementById("output"); 
      if (outputElement) { 
         const time = (new Date()).toLocaleTimeString(); 
         const textElement = document.createElement("p"); 
         textElement.innerHTML = (outputElement.childElementCount + 1) + " [" + time + "]: " + message; 
         outputElement.insertBefore(textElement, outputElement.firstChild); 
      } 
 
      if (!data) 
         console.log(message); 
      else 
         console.log(message, data); 
   } 
 
   static initFactory = () => { 
      // To communicate with the DocumentsService, it must be running! 
      // Change these parameters to match the path to the service. 
      lt.Document.DocumentFactory.serviceHost = "http://localhost:40000"; 
      lt.Document.DocumentFactory.servicePath = ""; 
      lt.Document.DocumentFactory.serviceApiPath = "api"; 
   } 
}

<!doctype html> 
<html lang="en"> 
<title>Document Example | Convert</title> 
 
<head> 
   <script src="https://code.jquery.com/jquery-2.2.4.min.js" 
      integrity="sha256-BbhdlvQf/xTY9gja0Dq3HiwQF8LaCRTXxZKRutelT44=" crossorigin="anonymous"></script> 
 
   <script src="../../LT/Leadtools.js"></script> 
   <script src="../../LT/Leadtools.Controls.js"></script> 
   <script src="../../LT/Leadtools.Annotations.Engine.js"></script> 
   <script src="../../LT/Leadtools.Annotations.Designers.js"></script> 
   <script src="../../LT/Leadtools.Annotations.Rendering.Javascript.js"></script> 
   <script src="../../LT/Leadtools.Annotations.Automation.js"></script> 
   <script src="../../LT/Leadtools.ImageProcessing.Main.js"></script> 
   <script src="../../LT/Leadtools.ImageProcessing.Color.js"></script> 
   <script src="../../LT/Leadtools.ImageProcessing.Core.js"></script> 
   <script src="../../LT/Leadtools.ImageProcessing.Effects.js"></script> 
   <script src="../../LT/Leadtools.Document.js"></script> 
   <script src="../../LT/Leadtools.Document.Viewer.js"></script> 
   <link rel="stylesheet" type="text/css" href="../../css/examples.css"> 
 
   <!-- All demo files are bundled and appended to the window --> 
   <script src="../../bundle.js" type="text/javascript"></script> 
</head> 
 
<body> 
   <div> 
      <button type="button" id="exampleButton">Run Example</button> 
   </div> 
   <div id="output"></div> 
   <div> 
      <img id="img" /> 
   </div> 
</body> 
 
<script> 
   window.onload = () => { 
      const example = new window.examples.LEADDocument.Convert(); 
      example.run("exampleButton"); 
   }; 
</script> 
</html>