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 )

bullet.gif    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:

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

bullet.gif    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".

bullet.gif    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.

Related Topics

CImageView, SetCursorPos, GetCursorPos, Image Coordinate System, Subpixel Coordinate Definition, Angle Measurement Definition


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