Ver 5.4.0 (2025-08-10)

- Wrapped widget enhancements

  - added methods and callbacks for expansion and collapse of rows in TreeView
  - ability to set color of Button widgets
  - add ColorDialog, a color selection dialog
  - add FileDialog, a file/directory dialog (can replace FileSelection)
  - fixed an issue with custom styling being inherited unnecessarily

- Fixed a bug where FITS loader preference on command line options
  or configuration file was not working
- Add ability to dynamically reload separately distributed plugins
  using the Command plugin (with reload_local or reload_global commands)
- Changed default port for Remote Control plugin and made a command line
  switch (--rcport) to allow launch time changing of the port
- Fixed an spurious error when closing Ginga after shutting down the RC
  plugin manually
- A fix for the Tk widget on Windows and Mac OSX to allow proper scrolling
- Better formatting of cuts and plot limits (limit excessive decimals)
- Fixed an error in reference viewer with detection of Gtk toolkits
- Gtk4 backend support is much improved
- Enhancements to the thread pool, with dynamic adding of threads when
  busy and stopping of threads when they have been idle

Ginga v5.3.0

- Fixed an issue with editing objects in the Pick plugin
- Fixed an issue where image metadata not always loaded correctly with
  Pillow for RGB images
- Added support for Apple HEIF (.HEIC) RGB images if pillow-heif is installed
- Fixed an issue with circular import of loader entry points under python 3.12
- Updates of minimum required versions of support packages

Ginga version v5.2.0

- Substituted puremagic package for python-magic (works better across
  platforms).
- Fixed an issue with the mouse wheel event scrolling MDI workspaces.
- Fixed a spurious warning when moving the cursor in the Pan plugin
  window and a table or plot viewer is running in the channel
- Made the enter_focus property default to False

  - Viewer windows will not steal the keyboard focus if the mouse moves
    over them

- Added alternate versions of installed fonts to the default font set
  (bold, italic, light)
- Some minor bug fixes for TreeView in Gtk3 backend
- Enhanced Plot viewer can plot 1D images or from tables via Table viewer

  - Toolbar and Info (Synopsis) bars change GUIs according to which
    viewer is active in the channel

- Text canvas type gets new attributes: bgcolor, bgalpha, bordercolor,
  borderpadding, borderalpha, borderlinewidth
- Deprecate Gtk.Table from GTK3 backend (switch to Gtk.Grid)
- Added experimental support for GTK4 backend
- Fixed an issue with toggling CheckBoxes in Qt6
- Closing a workspace now doesn't require closing all windows first

Ginga v5.1.0

- Fixed an issue where --modules option did not start a global plugin
  automatically
- Improved error checking on contains_pts() method for canvas items
- Removed references to distutils module, deprecated in python 3.12
- Made menubar a plugin; this allows very flexible menu configuration
  for users implementing their own variations on the reference viewer;
  NOTE: if you don't see Ginga menus, delete your $HOME/.ginga/layout*
- Added default antialiasing to cairo renderer
- Fixed drawing of dimension labels for rectangles specified in WCS
  coordinates
- Fixed drawing of Crosshair canvas object in opengl backend
- Fixed drawing of XRange and YRange in non-data coordinates
- Refactoring of rendering primitives; simplifies renderer implementation

  - "Text" objects now have linewidth (default: 0), fill (default: True),
    fillcolor (default: None) and fillalpha (default: 1.0) attributes.
    Default behavior if fillcolor isn't specified is to default to the
    "color" attribute, thus preserving backward-compatible behavior.

- Fixed broken WCS compass in Pan plugin
- Fixed broken Close button in FBrowser and ColorMapPicker when activated
  as global plugins
- Fixed a bug in PixTable plugin where it would report a table for X and Y
  values outside the image
- Fixed bokeh back end to be up to date with recent bokeh changes

Ginga v5.0.1

- Fixed an issue where --modules option did not start a global plugin automatically
- Improved error checking on contains_pts() method for canvas items
- Removed references to distutils module, deprecated in python 3.12
- Added default antialiasing to cairo renderer
- Fixed drawing of dimension labels for rectangles specified in WCS coordinates
- Fixed drawing of Crosshair canvas object in opengl backend
- Fixed drawing of XRange and YRange in non-data coordinates

Ginga v5.0.0

- Add Contrast and Brightness adjustments in "Preferences" plugin
- Modifications to PIL backend

  - support pillow v10.0
  - now supports linewidth attribute

- Add support for VizieR catalog sources
- Fixed an issue with programatically setting selections in TreeView
  (qt backend)
- Added a quit confirmation dialog to the reference viewer
  (can be overridden with a setting in general.cfg)
- Fix for mouse scrolling in histogram plot via Histogram plugin
- Fix for ScreenShot plugin with pyside6, qt6 backends
- Fix for context menu pop up in pyside2
- Fix for a logger annoyance message when mousing over far edge of image
- Updates for deprecations in numpy 2.0
- Fix for missing menubar on some versions of Qt and Mac OS X
- Fix for importing mpl colormaps with recent versions of matplotlib
- Fix for utcnow(), deprecated in Python 3.12
- Renamed mode "freepan" to "zoom" (bindings and activation are the
  same as before) to better reflect what the mode does
- Changed icons and cursors from PNG (bitmap) to SVG (vector) format
- Added color distribution ("stretch") control to Info plugin
- Added LoaderConfig plugin; allows setting of loader priorities for
  various MIME types
- Fixed an issue with the "none-move" event, affected Crosshair plugin
  and "hover" event on canvas items
- Added an internationalization framework (see "Internationalization"
  chapter in the Ginga manual).  Not yet enabled for reference viewer
- Added button in Toolbar plugin to activate cmap (colormap) mode
- Added mode help; type 'h' in the viewer window when you are in a mode
  to display a help tab for that mode (reference viewer only)
- Better support for touchpad gestures in modes
- Better support for RGB files

  - Support additional types (ico/icns/tga/bmp)
  - RGB video files can be opened (with OpenCv loader) and examined with
    MultiDim plugin or naxis mode (video frames is treated as axis 3)

- Added PluginConfig plugin; allows configuration of all Ginga plugins
  graphically; can enable/disable, change menu categories, etc.
- Removed --profile and --debug command-line options
- Fix a number of issues with the help system to make it simpler and
  more robust; removed WBrowser plugin, handle URLs with Python webbrowser
  module
- Number of threads can be configured in general settings file
- Fixes to various examples for third-party package changes
  (particularly matplotlib backend examples)
- Fixes for event handler treatment of return boolean values

Ginga v4.1.1

Maintenance release.  Backporting of some fixes to development branch.

- Fixed a bug with the remove() method in GridBox widget
- Fix for pillow backend for pillow >= 10.0
- Fix for delete_row() in GridBox widgets
- Fix for TextEntry widget in pg backend

Ginga v4.1.0

- change implementation of splash banner to a pop-up modal dialog
  with version string
- fixed menubar integration on Mac OS X
- fixed an issue with auto cuts saved parameters not being loaded
  correctly
- fixed an issue with certain auto cuts methods not getting enough
  samples when the image size is very small
- removed old, deprecated StandardPixelRenderer
- RGB mapping has been refactored to use a pipeline
- Removed deprecated preload feature
- Fix for focusing plugins that have no GUI
- Added feature to reset viewer attributes between images (can be
  used synergistically with the "remember" feature). See "Reset (Viewer)"
  and "Remember (Image)" settings in the "Preferences" plugin.
- Fixed bug with pg backend loading icons
- Pick plugin settings now has options to set the autozoom and autocuts
  settings for the "Image" and "Contour" viewers (see "plugin_Pick.cfg"
  file in .../ginga/examples/configs)
- Fixed an issue with readout of values under the cursor when an image
  is plotted at a non-zero origin

Ginga v4.0.1

- fixed a DeprecationWarning with jupyterw back end
- fixed a bug for Toolbar plugin that prevented N-E and N-W orientation
  from working as well as contrast restore
- fixes a bug in exporting ginga canvas objects to astropy regions objects
  and the test suite for it

Ginga v4.0.0

- fixed getattr functionality in Bunch
- removed the "mock" backend; use "pil" backend for similar purposes
- fixed a longstanding issue where events registered on a canvas could
  be masked by default key/cursor bindings (not associated with a mode).
  This meant, for example, that only certain keystrokes could be
  captured by an event handler registered on a ginga canvas, because any
  keystrokes that had a default binding would take precedence.
  Now such bindings are only executed if the event is not handled by any
  active canvas bindings.
- Removed the "Quick Mode" and "From Peak" options in the Pick plugin
  to simplify operation.
- Many deprecated camelcase (non-PEP8) methods were removed. Use the
  "snake-case" names instead.
- Fixed an issue with setting the scale manually in the Preferences plugin
- Fixed a bug that can cause an incorrect cropping of image when the window
  is resized
- Refactor modes from Bindings module into separate modules:

  - modes can now be written and understood as having a very similar
    structure to a plugin.
  - mode docstrings can be written and maintained better to document the
    modes and the code implementing a mode is much easier to understand
    since it is encapsulated rather than all mixed together in one huge
    file.

- Added an AutoLoad plugin that can monitor a folder for new files and
  load them.
- Fixed a bug in the Overlays plugin where the overlay value was
  reported as the value under the cursor rather than the data value
- Fixed an issue with loading RGB images with opencv-python
- Fixed an issue where manual cut levels changes weren't reflected in
  the Thumbs icon
- ScreenShot now correctly captures the background color of the viewer
- Fixed a DeprecationWarning related to use of entry points
- File loaders are now discoverable under the "ginga_loaders" entry point.
  Loaders can be registered for MIME types and a ``mime.types`` file can be
  added to your ``$HOME/.ginga`` to identify types by file extension.
- ColorMapPicker plugin can now be launched as a local or global plugin