| |
CImage:DistanceWcs
The DistanceWcs method calculates the distance in WCS units between 2 image points measured in world coordinates. The related Distance method computes the distance for pixel coordinates.
|
nDistance = CImage:DistanceWcs( x1, y1, x2, y2) |
wherex1,
y1,x2,
y2 are world coordinate
values and may be numbers or strings.
On success,
this method returns nDistance as a
number (see Remarks)
On failure,
this method returns 0.
The DistanceWcs method returns a distance in world coordinate units. For angular coordinate systems, this would be measured in degrees. If the image does not contain a world coordinate calibration, then Mira interprets the values as pixel coordinates and the distance is reported in distance units. If the coordinate calibration is in equatorial form, you can retrieve distance in string format using DistanceWcsStr.
Assume an image is displayed and attached to a CImageView named V. The following script fragment measures the distance between between 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 |
|
D = I:DistanceWcs(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 |
|
D = I:DistanceWcs(x1,y1,x2,y2) |
-- make the measurement |
CImage, Distance, DistanceWcsStr, Image Coordinate System, Subpixel Coordinate Definition