Package: addcopyfighandler
addcopyfighandler: Add a Ctrl+C / Cmd+C handler to matplotlib figures for copying the figure to the clipboardImporting this module (after importing matplotlib or pyplot) will add a handler
to all subsequently-created matplotlib figures
so that pressing Ctrl+C (or Cmd+C on MacOS) with a matplotlib figure window selected will copy
the figure to the clipboard as an image.  The copied image is generated through
matplotlib.pyplot.savefig(), and thus is affected by the relevant rcParams
settings (savefig.dpi, savefig.format, etc.).Uses code & concepts from:https://stackoverflow.com/questions/31607458/how-to-add-clipboard-support-to-matplotlib-figureshttps://stackoverflow.com/questions/34322132/copy-image-to-clipboard-in-python3Windows-specific behavior:addcopyfighandler should work regardless of which graphical backend is being used by matplotlib
(tkagg, gtk3agg, qtagg, etc.).Ifmatplotlib.rcParams['savefig.format']is'svg', the figure will be copied to the clipboard
as an SVG.If Pillow is installed, all non-SVG format specifiers will be overridden, and the
figure will be copied to the clipboard as a Device-Independant Bitmap.If Pillow is not installed, the supported format specifiers are'png','jpg','jpeg', and'svg'.
All other format specifiers will be overridden, and the figure will be copied to the clipboard as PNG data.Linux-specific behavior:Requires either Qt or GTK libraries for clipboard interaction. Automatically detects which is being used frommatplotlib.get_backend().Qt support requiresPyQt5,PyQt6,PySide2orPySide6.GTK support requirespycairo,PyGObjectandPILorpillowto be installed.Only GTK 3 is supported, as GTK 4 has totally changed the way clipboard data is handled and I can't figure
it out. I'm totally open to someone else solving this and submitting a PR if they want. I don't use GTK.The figure will be copied to the clipboard as a PNG, regardless ofmatplotlib.rcParams['savefig.format']. Alas, SVG output is not currently supported. Pull requests that enable SVG support would be welcomed.MacOS-specific behavior:- Requires Qt, whether PyQt5/6 or PySide2/6.
- The figure will be copied to the clipboard as a PNG, regardless of matplotlib.rcParams['savefig.format'].Releases3.2.0: 2024-02-13Added MacOS support (thanks @orlp!). No SVG support, same as Linux.3.1.1: 2024-02-13Wrap matplotlib.pyploy.figure appropriately to maintain docstring (thanks @eendebakpt!)3.1.0: 2024-02-13Add support for PyQt6 and PySide6 on Linux (already supported on Windows)3.0.0: 2021-03-28Add Linux support (tested on Ubuntu). Requires PyQt5, PySide2, or PyObject libraries; relevant library chosen based on matplotlib graphical backend in use. No SVG support.On Windows, non SVG-formats will now use the Pillow library if installed, storing the figure to the clipboard as a device-indepenent bitmap (as previously handled in v2.0). This is compatible with a wider range of Windows applications.2.1.0: 2020-08-27Remove Pillow.Add support for png & svg file formats.2.0.0: 2019-06-07Remove Qt requirement. Now use Pillow to grab the figure image, and win32clipboard to manage the Windows clipboard.1.0.2: 2018-11-27Force use of Qt4Agg or Qt5Agg. Some installs will default to TkAgg backend, which this module
doesn't support. Forcing the backend to switch when loading this module saves the user from having
to manually specify one of the Qt backends in every analysis.1.0.1: 2018-11-27Improve setup.py: remove need for importing module, add proper installation dependenciesChange readme from ReST to Markdown1.0: 2017-08-09Initial release