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.

Syntax

sRaHms, sDegDms = CImage:XyToWcs( x, y )

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

bullet.gif    sRaHms and sDegDms are world coordinate strings in units of HMS and DMS.

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

bullet.gif    On failure, this method returns two empty strings.

Remarks

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:

bullet.gif    Right ascension may be converted to decimal degrees using HmsToDeg.

bullet.gif    Declination may be converted to decimal degrees using DmsToDeg.

Related Topics

CImage class, XyToWcs, WcsToXy, 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.