CImageView:SetCursorPosWcs

The SetCursorPosWcs method sets the center position of the image cursor in the CImageView using world coordinates, rather than pixel coordinates. See the Remarks below regarding World Coordinate Systems and angular coordinates. Your script may use whichever units are appropriate, but you must use numeric degrees when sending or receiving coordinates between a script and Mira.

Syntax

CImageView:SetCursorPosWcs( x, y )

The x and y values specify the target position in world coordinates, and may be numbers or strings.

Remarks

Angular coordinates require a specific format, as defined by the FITS Format. See Angle Measurement Definition.

Note the following requirements for using angular coordinates:

If you specify angular coordinates using numbers, the coordinates must be specified in decimal degrees.

If the angular coordinates are specifed as a string, then you must use the string equivalent, i.e., you can use either -35.4216 or "-35.4216".

You may find coordinate conversions useful for sending and receiving world coordinates. See Date, Time, and Angle Functions.

This method uses the world coordinate calibration from the current image to compute the pixel position in the image window. This requires that a WCS calibration exist for the current displayed image. If no WCS calibration exists, Mira uses the specifiedcoordinates as pixel coordinates.

Syntax

Remarks

Related Topics