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 )

where

x1,y1, x2, y2 are world coordinate values and may be expressed as numbers or strings.

nAngle is the returned angle, neasured in degrees.

bSuccess is the returned success code. On success it is true, otherwise false.

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