In This Topic ▼

convertPoints Method

Summary

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

Syntax

TypeScript

JavaScript

ImageViewer.prototype.convertPoints = function( 
   item, 
   fromType, 
   toType, 
   points 
)

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