BurnToRectWithDpi Method

Summary

Burns the annotation objects in Container to the destination context and destination rectangle at the specified resolution.

Syntax

Objective-C

C++/CLI

Java

Python

public void BurnToRectWithDpi( 
   LeadRectD destinationRect, 
   double sourceDpiX, 
   double sourceDpiY, 
   double targetDpiX, 
   double targetDpiY 
)

- (void)burnToRectWithDpi:(LeadRectD)destinationRect sourceDpiX:(double)sourceDpiX sourceDpiY:(double)sourceDpiY targetDpiX:(double)targetDpiX targetDpiY:(double)targetDpiY NS_SWIFT_NAME(burn(to:sourceDpiX:sourceDpiY:targetDpiX:targetDpiY:));

public void burnToRectWithDpi( 
   LeadRectD destinationRect, 
   double sourceDpiX, 
   double sourceDpiY, 
   double targetDpiX, 
   double targetDpiY 
)

public:  
   void BurnToRectWithDpi( 
      LeadRectD^ destinationRect, 
      double sourceDpiX, 
      double sourceDpiY, 
      double targetDpiX, 
      double targetDpiY 
   )

def BurnToRectWithDpi(self,destinationRect,sourceDpiX,sourceDpiY,targetDpiX,targetDpiY):

Parameters

destinationRect
The destination rectangle in container coordinates.

sourceDpiX
Horizontal source (image) DPI.

sourceDpiY
Vertical source (image) DPI.

targetDpiX
Horizontal target (screen) DPI.

targetDpiY
Vertical target (screen) DPI.

Remarks

All visible objects in this container will be drawn into the current context.

This method uses the resolution (DPI) values specified and not the values stored in the container. Use this method when burning the container objects into any context.

To burn a container into the context of the image being automated, use Burn.

Example

This example will create a container, add a couple of objects and then burn it into the viewer

using Leadtools.Annotations.Automation; 
using Leadtools.Annotations.Engine; 
using Leadtools.Annotations.Rendering; 
using Leadtools.Codecs; 
using Leadtools.Annotations; 
using Leadtools.WinForms; 
 
public void AnnRenderingEngine_BurnToRectWithDpi(/*RasterImage image*/) 
{ 
   // _viewer is ImageViewer _automation is working on 
 
   // Get the container 
   AnnContainer container = _automation.Container; 
   RasterImage image = _viewer.Image; 
 
   double inch = 720.0; 
 
   // Add a red line object, from 1in 1in to 2in 2in 
   AnnPolylineObject lineObj = new AnnPolylineObject(); 
   lineObj.Points.Add(LeadPointD.Create(1 * inch, 1 * inch)); 
   lineObj.Points.Add(LeadPointD.Create(2 * inch, 2 * inch)); 
   lineObj.Stroke = AnnStroke.Create(AnnSolidColorBrush.Create("Red"), LeadLengthD.Create(1)); 
   container.Children.Add(lineObj); 
 
   // Add a blue on yellow rectangle from 3in 3in to 4in 4in 
   AnnRectangleObject rectObj = new AnnRectangleObject(); 
   rectObj.Rect = LeadRectD.Create(3 * inch, 3 * inch, 1 * inch, 1 * inch); 
   rectObj.Stroke = AnnStroke.Create(AnnSolidColorBrush.Create("Blue"), LeadLengthD.Create(1)); 
   rectObj.Fill = AnnSolidColorBrush.Create("Yellow"); 
   container.Children.Add(rectObj); 
 
   IAnnAutomationControl annAutomationControl = _automation.AutomationControl; 
 
   RasterColor[] colors = image.GetPalette(); 
   IntPtr hDC = Leadtools.Drawing.RasterImagePainter.CreateLeadDC(image); 
   if (hDC != null) 
   { 
      using (Graphics g = Graphics.FromHdc(hDC)) 
      { 
         // Create a new rendering engine for this container and context 
         AnnWinFormsRenderingEngine renderingEngine = new AnnWinFormsRenderingEngine(container, g); 
 
         // Set the resolution 
         double dpiX = g.DpiX; 
         double dpiY = g.DpiY; 
         double xRes = annAutomationControl.AutomationDpiX; 
         double yRes = annAutomationControl.AutomationDpiY; 
 
         // Burn it 
         renderingEngine.BurnToRectWithDpi(LeadRectD.Empty, dpiX, dpiY, xRes, yRes); 
      } 
 
      Leadtools.Drawing.RasterImagePainter.DeleteLeadDC(hDC); 
   } 
 
   // Delete the objects we added 
   _automation.SelectObjects(container.Children); 
   _automation.DeleteSelectedObjects(); 
 
   // Invalidate to see the burned objects 
   _automation.Invalidate(LeadRectD.Empty); 
}

Requirements

Target Platforms

Reference

AnnRenderingEngine Class

AnnRenderingEngine Members

Download our FREE evaluation

Help Version 22.0.2023.7.31

Leadtools.Annotations.Engine Assembly

Introduction

Getting Started

Namespaces

Leadtools.Annotations.Engine Namespace

Assemblies