CImage:XyToWcs


The XyToWcs method converts a pixel coordinate to a world coordinate system position If the World coordinate system uses celestial coordinates, then the values returned are right ascension and declination in units of degrees expressed as numbers. See the related CImage: XyToWcsStr.

Syntax

nRaDeg, nDecDeg = CImage:XyToWcs( x, y )

bullet.gif    x and y are pixel coordinates in pixel units and may be numbers or strings.

bullet.gif    nRaDeg and nDecDeg are world coordinates in units of degrees.

bullet.gif    On success, this method returns 2 numbers.

bullet.gif    On failure, this method returns 0,0.

Remarks

The right ascension and declination are both returned in units of degrees to according to the FITS standard for these coordinate units. Time and angles may be converted to degrees as follows:

bullet.gif    Right ascension (or longitude or time) specified in degrees may be converted to a string in hours, minutes, and seconds using DegToHms.

bullet.gif    Declination specified in degrees may be converted to a string in degrees, minutes, and seconds using DegToDms.

Related Topics

CImage class, XyToWcsStr, WcsToXy, GetWcsType, WcsIsEq, Image Coordinate System, Subpixel Coordinate Definition, Date, Time, and Angle Functions


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