CImage:AngleWcs


The AngleWcs method calculates the angle in degrees between a line formed by 2 image points and the world coordinate system. The related Angle method computes the angle for pixel coordinates.

Syntax

nAngle = CImage:AngleWcs( x1, y1, x2, y2)

Remarks

The AngleWcs method returns an angle in degrees. If the image does not contain a world coordinate calibration, then Mira interprets the values as pixel coordinates. If the coordinate calibration is in equatorial form, then right ascension and declination would be passed as strings in units of hours and degrees, respectively.

Example

Assume an image is displayed and attached to a CImageView named V. The following script measures the angle formed by two points (x1,y1) and (x2,y2) when the coordinates are in distance units (pixels, mm, microns, etc.):

 

I = V:GetImage()

-- load the image from a

x1 = 442.5 ; y1 = 220.44

-- point 1

x2 = 1.554 ; y2 = 20.552

-- point 2

A = I:AngleWcs(x1,y1,x2,y2)

-- make the measurement

Alternatively, the following example supposes an astronomical image with an equatorial calibration and that the points are expressed in angular units:

 

V:GetImage()

-- load the image from a

x1 = "05:42:15.52" ; y1 = "20:40:12.5"

-- point 1

x2 = "05:42:44.12" ; y2 = "20:42:42.1"

-- point 2

A = I:AngleWcs(x1,y1,x2,y2)

-- make the measurement

Related Topics

CImage class, Angle, Angle Measurement Definition


Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.