autoCreateCanvas Property

Summary

Indicates whether to automatically create the HTML5 Canvas Element when the image is updated.

Syntax
TypeScript
JavaScript
Object.defineProperty(ImageViewer.prototype, 'autoCreateCanvas', 
	get: function(), 
	set: function(value) 
) 
autoCreateCanvas: boolean; 

Property Value

true to automatically create the canvas when the image is updated; otherwise, false. Default value is false.

Remarks

This is a helper property for applications that use ImageViewer in single item mode. It is a shortcut to AutoCreateCanvas of ActiveItem. For more information, refer to Image Viewer in Single Item Mode.

Example
AutoCreateCanvas.ts
ImageViewer.ts
AutoCreateCanvas.js
ImageViewer.js
AutoCreateCanvas.html
import { ImageViewer_Example } from "../ImageViewer"; 
 
export class ImageViewerItem_AutoCreateCanvasExample { 
   private viewerExample; 
   constructor() { 
      this.viewerExample = new ImageViewer_Example(this.run); 
   } 
 
   private run = (viewer: lt.Controls.ImageViewer) => { 
      // Setup: clear the old item 
      viewer.items.clear(); 
 
      // Create the image to pass in 
      const img = document.createElement("img"); 
      img.onload = () => { 
         // Loaded 
 
         const item: lt.Controls.ImageViewerItem = new lt.Controls.ImageViewerItem(); 
         // Now either add the item to the viewer first, or set item.autoCreateCanvas to true 
         item.autoCreateCanvas = true; 
         item.image = img; 
         viewer.items.add(item); 
 
         // Now, it is a canvas 
         const canvas = item.canvas as HTMLCanvasElement; 
         const output = document.getElementById("output"); 
         output.innerHTML = "Is Canvas: " + (!!canvas && canvas instanceof HTMLCanvasElement); 
 
         // Draw to it 
         const context: CanvasRenderingContext2D = canvas.getContext("2d"); 
         context.fillStyle = "rgba(255, 0, 0, .8)"; 
         context.fillRect(25, 25, 325, 325); 
 
         // Invalidate so we see the change (or just pan or zoom to see) 
         viewer.invalidateItem(item); 
      }; 
      img.src = "https://demo.leadtools.com/images/png/pngimage.png"; 
   } 
} 
export class ImageViewer_Example { 
   // LEADTOOLS ImageViewer to be used with this example 
   protected imageViewer: lt.Controls.ImageViewer = null; 
   // Generic state value used by the examples 
   public timesClicked: number = 0; 
 
   constructor(callback?: (viewer: lt.Controls.ImageViewer) => void) { 
      // Set the LEADTOOLS license. Replace this with your actual license file 
      lt.RasterSupport.setLicenseUri("https://demo.leadtools.com/licenses/js/LEADTOOLSEVAL.txt", "EVAL", null); 
 
      // Create an image viewer inside the imageViewerDiv element 
      const imageViewerDiv = document.getElementById("imageViewerDiv"); 
      const createOptions: lt.Controls.ImageViewerCreateOptions = new lt.Controls.ImageViewerCreateOptions(imageViewerDiv); 
      this.imageViewer = new lt.Controls.ImageViewer(createOptions); 
      this.imageViewer.viewVerticalAlignment = lt.Controls.ControlAlignment.center; 
      this.imageViewer.viewHorizontalAlignment = lt.Controls.ControlAlignment.center; 
      this.imageViewer.autoCreateCanvas = true; 
 
      // Add Pan/Zoom interactive mode 
      // Click and drag to pan, CTRL-Click and drag to zoom in and out 
      this.imageViewer.interactiveModes.add(new lt.Controls.ImageViewerPanZoomInteractiveMode()); 
 
      // Load an image 
      this.imageViewer.imageUrl = "https://demo.leadtools.com/images/jpeg/cannon.jpg"; 
 
      this.imageViewer.zoom(lt.Controls.ControlSizeMode.fit, .9, this.imageViewer.defaultZoomOrigin); 
 
      const exampleButton = document.getElementById("exampleButton"); 
      exampleButton.addEventListener("click", () => { 
         this.timesClicked++; 
         // Run the example 
         if (callback) 
            callback(this.imageViewer); 
      }); 
   } 
} 
import { ImageViewer_Example } from "../ImageViewer"; 
 
export class ImageViewerItem_AutoCreateCanvasExample { 
   viewerExample; 
   constructor() { 
      this.viewerExample = new ImageViewer_Example(this.run); 
   } 
 
   run = (viewer) => { 
      // Setup: clear the old item 
      viewer.items.clear(); 
 
      // Create the image to pass in 
      const img = document.createElement("img"); 
      img.onload = () => { 
         // Loaded 
 
         const item = new lt.Controls.ImageViewerItem(); 
         // Now either add the item to the viewer first, or set item.autoCreateCanvas to true 
         item.autoCreateCanvas = true; 
         item.image = img; 
         viewer.items.add(item); 
 
         // Now, it is a canvas 
         const canvas = item.canvas; 
         const output = document.getElementById("output"); 
         output.innerHTML = "Is Canvas: " + (!!canvas && canvas instanceof HTMLCanvasElement); 
 
         // Draw to it 
         const context = canvas.getContext("2d"); 
         context.fillStyle = "rgba(255, 0, 0, .8)"; 
         context.fillRect(25, 25, 325, 325); 
 
         // Invalidate so we see the change (or just pan or zoom to see) 
         viewer.invalidateItem(item); 
      }; 
      img.src = "https://demo.leadtools.com/images/png/pngimage.png"; 
   } 
} 
export class ImageViewer_Example { 
   // LEADTOOLS ImageViewer to be used with this example 
   imageViewer = null; 
   // Generic state value used by the examples 
   timesClicked = 0; 
 
   constructor(callback) { 
      // Set the LEADTOOLS license. Replace this with your actual license file 
      lt.RasterSupport.setLicenseUri("https://demo.leadtools.com/licenses/js/LEADTOOLSEVAL.txt", "EVAL", null); 
 
      // Create an image viewer inside the imageViewerDiv element 
      const imageViewerDiv = document.getElementById("imageViewerDiv"); 
      const createOptions = new lt.Controls.ImageViewerCreateOptions(imageViewerDiv); 
      this.imageViewer = new lt.Controls.ImageViewer(createOptions); 
      this.imageViewer.viewVerticalAlignment = lt.Controls.ControlAlignment.center; 
      this.imageViewer.viewHorizontalAlignment = lt.Controls.ControlAlignment.center; 
      this.imageViewer.autoCreateCanvas = true; 
 
      // Add Pan/Zoom interactive mode 
      // Click and drag to pan, CTRL-Click and drag to zoom in and out 
      this.imageViewer.interactiveModes.add(new lt.Controls.ImageViewerPanZoomInteractiveMode()); 
 
      // Load an image 
      this.imageViewer.imageUrl = "https://demo.leadtools.com/images/jpeg/cannon.jpg"; 
 
      this.imageViewer.zoom(lt.Controls.ControlSizeMode.fit, .9, this.imageViewer.defaultZoomOrigin); 
 
      const exampleButton = document.getElementById("exampleButton"); 
      exampleButton.addEventListener("click", () => { 
         this.timesClicked++; 
         // Run the example 
         if (callback) 
            callback(this.imageViewer); 
      }); 
   } 
} 
<!doctype html> 
<html lang="en"> 
<title>Controls Example | AutoCreateCanvas</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> 
   <style> 
      body { 
         font-family: 'Segoe UI', sans-serif; 
      } 
 
      #imageViewerDiv { 
         border: 1px solid #888; 
         width: 500px; 
         height: 500px; 
         background-color: #eee; 
      } 
   </style> 
 
   <!-- All demo files are bundled and appended to the window --> 
   <script src="../../bundle.js" type="text/javascript"></script> 
</head> 
 
<body> 
   <p>Press and drag on the image to pan.</p> 
   <p>Hold down the control key and press and drag on the image or pinch with two fingers to zoom in and out.</p> 
   <div> 
      <button type="button" id="exampleButton">Run Example</button> 
   </div> 
   <div id="imageViewerDiv"></div> 
   <div id="output"></div> 
</body> 
 
<script> 
   window.onload = () => { 
      const example = new window.examples.ImageViewerItem.AutoCreateCanvas(); 
 
   }; 
</script> 
</html> 
Requirements

Target Platforms

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

Leadtools.Controls Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.