ContentsΒΆ

Contents plugin

The Contents plugin provides a table of contents-like interface for all the images viewed since the program was started. Unlike Thumbs, Contents is sorted by channel. The contents also shows some configurable metadata from the image.

Plugin Type: Global

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

Usage

Click on a column heading to sort the table by that column; Click again to sort the other way.

Note

The columns and their values are drawn from the FITS header, if applicable. This can be customized by setting the “columns” parameter in the “plugin_Contents.cfg” settings file.

The active image in the currently focused channel will normally be highlighted. Double-click on an image will force that image to be shown in the associated channel. Single-click on any image to activate the buttons at the bottom of the UI:

  • “Display”: Make the image the active image.
  • “Move”: Move the image to another channel.
  • “Copy”: Copy the image to another channel.
  • “Remove”: Remove the image from the channel.

If “Move” or “Copy” is done on an image that has been modified in Ginga (which would have an entry under ChangeHistory, if used), the modification history will be retained as well. Removing an image from a channel destroys any unsaved changes.

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

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

# columns to show from metadata -- NAME and MODIFIED recommended
# format: [(col header, keyword1), ... ]
columns = [ ('Name', 'NAME'), ('Object', 'OBJECT'), ('Filter', 'FILTER01'), ('Date', 'DATE-OBS'), ('Time UT', 'UT'), ('Modified', 'MODIFIED')]

# If set to True, will always expand the tree in Contents when new entries are added
always_expand = True

# Option to highlight images that are displayed in channels.
# If set to True this option will only highlight the image that is in the
# channel with the keyboard focus
highlight_tracks_keyboard_focus = False

# If True, color every other row in alternating shades to improve
# readability of long tables
color_alternate_rows = True

# Highlighted row colors (in addition to bold text)
row_font_color = 'green'

# Maximum number of rows that will turn off auto column resizing (for speed)
max_rows_for_col_resize = 100