Cursor plugin

The Cursor plugin displays a summary line of text that changes as the user moves the cursor around an image. In the standard reference viewer configuration, it appears as a line containing green text just below the Colorbar plugin.

Plugin Type: Global

Cursor is a global plugin. Only one instance can be opened.


Cursor simply tracks the cursor as it moves around an image and displays information about the pixel coordinates, WCS coordinates (if available) and the value of the pixel under the cursor.

There is no associated configuration GUI.


Pixel coordinates are affected by the general setting “pixel_coords_offset” which can be set in the “general.cfg” configuration file for ginga. The default is value for this setting is 1.0, which means pixel coordinates are reported from an origin of 1, as per the FITS standard.

It is customizable using ~/.ginga/plugin_Cursor.cfg, where ~ is your HOME directory:

# Cursor plugin preferences file
# Place this in file under ~/.ginga with the name "plugin_Cursor.cfg"

# Set to a particular font if you like one
font_name = 'fixed'

# Set to a point size if you have a preference
font_size = None