CImage:XyToWcsStr
The XyToWcsStr 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 but expressed as strings. See the related CImage: XyToWcs.
sRaHms, sDegDms = CImage:XyToWcs( x, y ) |
x and y are pixel coordinates in pixel units and may be numbers or strings.
sRaHms and sDegDms are world coordinate strings in units of HMS and DMS.
On success, this method returns 2 strings.
On failure, this method returns two empty strings.
The right ascension in hours, minutes, and seconds is formatted as "HH:MM:SS.SSS". The declination in degrees, minutes, and seconds is formatted as "-DD:MM:SS.SSS" where the - sign is used of the angle is negative. The right ascension and declination strings may be converted to degrees as follows:
Right ascension may be converted to decimal degrees using HmsToDeg.
Declination may be converted to decimal degrees using DmsToDeg.
CImage class, XyToWcs, WcsToXy, Image Coordinate System, Subpixel Coordinate Definition, Date, Time, and Angle Functions
Mira Pro x64 Script User's Guide, Copyright Ⓒ 2024 Mirametrics,
Inc. All Rights Reserved.