convertPoints Method

Summary

Converts an array of LeadPointD from one coordinates to the other.

Syntax

JavaScript Syntax
ImageViewer.prototype.convertPoints = function(item, fromType, toType, points) 
TypeScript Syntax
convertPoints(item: ImageViewerItem, fromType: ImageViewerCoordinateType, toType: ImageViewerCoordinateType, points: LeadPointD[]): void; 

Parameters

item

The reference item. This value can be null.

fromType

Original coordinates of points.

toType

Desired target coordinates.

points

Array of points to convert.

Remarks

Use ConvertPoint to convert a single point and ConvertPoints to convert an array of points at once. The viewer needs to create temporary matrices for the conversion, so if you have multiple points, convert them all at once for optimal performance.

Use ConvertRect to convert a rectangle.

The values of item, fromType and toType controls how the point is converted as described below. If the conversion uses an item and the value of item is null, then the viewer will use ActiveItem to support point conversion in a single-view mode.

fromType toType item Description
ImageViewerCoordinateType.Control ImageViewerCoordinateType.View Not used Converts a point from control coordinates such as a mouse event in relation to the view
ImageViewerCoordinateType.View ImageViewerCoordinateType.Control Not used Converts a point from view coordinates to control. The reverse of the previous operation
ImageViewerCoordinateType.Control ImageViewerCoordinateType.Item Used Converts a point from control coordinates such as a mouse event in relation to the whole of the item
ImageViewerCoordinateType.Item ImageViewerCoordinateType.Control Used Converts a point from item to control. The reverse of the previous operation
ImageViewerCoordinateType.Control ImageViewerCoordinateType.Content Used Converts a point from control coordinates such as a mouse event in relation to the content area of the item
ImageViewerCoordinateType.Content ImageViewerCoordinateType.Control Used Converts a point from content to control. The reverse of the previous operation
ImageViewerCoordinateType.Control ImageViewerCoordinateType.Image Used Converts a point from control coordinates such as a mouse event in relation to the image of the item
ImageViewerCoordinateType.Image ImageViewerCoordinateType.Control Used Converts a point from image to control. The reverse of the previous operation
ImageViewerCoordinateType.Control ImageViewerCoordinateType.Floater Used Converts a point from control coordinates such as a mouse event in relation to the floater image of the item
ImageViewerCoordinateType.Floater ImageViewerCoordinateType.Control Used Converts a point from image floater to control. The reverse of the previous operation

For more information refer to Image Viewer Layouts, Image Viewer Appearance, Image Viewer Items, Image Viewer Transformation, and Image Viewer Bounds and Transform.

Example

For an example, refer to ConvertPoint.

Requirements

Target Platforms

Help Version 19.0.2017.10.18
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Controls Assembly