Skip to content

[WIP] Deprecate gtk, gdk and wx backends and remove Cocoaagg on 2.x #6582

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Jun 29, 2016
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions doc/api/api_changes/2016-06-deprecate_backends.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
GTK and GDK backends deprecated
```````````````````````````````
The untested and broken GDK and GTK backends have been deprecated.
These backends allows figures to be rendered via the GDK api to
files and GTK2 figures. They are untested, known to be broken and
use have been discouraged for some time. The `GTKAgg` and `GTKCairo` backends
provide better and more tested ways of rendering figures to GTK2 windows.

WX backend deprecated
`````````````````````
The untested WX backend has been deprecated.
This backend allows figures to be rendered via the WX api to
files and Wx figures. It is untested, and
use have been discouraged for some time. The `WXAgg` backend
provides a better and more tested way of rendering figures to WX windows.

CocoaAgg backend removed
````````````````````````

The deprecated and not fully functional CocoaAgg backend has been removed
13 changes: 7 additions & 6 deletions doc/faq/usage_faq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -370,10 +370,10 @@ renderer for user interfaces is ``Agg`` which uses the `Anti-Grain
Geometry`_ C++ library to make a raster (pixel) image of the figure.
All of the user interfaces except ``macosx`` can be used with
agg rendering, e.g.,
``WXAgg``, ``GTKAgg``, ``QT4Agg``, ``TkAgg``. In
``WXAgg``, ``GTKAgg``, ``QT4Agg``, ``QT5Agg``, ``TkAgg``. In
addition, some of the user interfaces support other rendering engines.
For example, with GTK, you can also select GDK rendering (backend
``GTK``) or Cairo rendering (backend ``GTKCairo``).
``GTK`` deprecated in 2.0) or Cairo rendering (backend ``GTKCairo``).

For the rendering engines, one can also distinguish between `vector
<http://en.wikipedia.org/wiki/Vector_graphics>`_ or `raster
Expand Down Expand Up @@ -404,7 +404,7 @@ SVG :term:`svg` :term:`vector graphics` --
:term:`svg`
...
:term:`GDK` :term:`png` :term:`raster graphics` --
:term:`jpg` the `Gimp Drawing Kit`_
:term:`jpg` the `Gimp Drawing Kit`_ Deprecated in 2.0
:term:`tiff`
...
============= ============ ================================================
Expand All @@ -421,16 +421,17 @@ GTKAgg Agg rendering to a :term:`GTK` 2.x canvas (requires PyGTK_ and
pycairo_ or cairocffi_; Python2 only)
GTK3Agg Agg rendering to a :term:`GTK` 3.x canvas (requires PyGObject_
and pycairo_ or cairocffi_)
GTK GDK rendering to a :term:`GTK` 2.x canvas (not recommended)
(requires PyGTK_ and pycairo_ or cairocffi_; Python2 only)
GTK GDK rendering to a :term:`GTK` 2.x canvas (not recommended and d
eprecated in 2.0) (requires PyGTK_ and pycairo_ or cairocffi_;
Python2 only)
GTKCairo Cairo rendering to a :term:`GTK` 2.x canvas (requires PyGTK_
and pycairo_ or cairocffi_; Python2 only)
GTK3Cairo Cairo rendering to a :term:`GTK` 3.x canvas (requires PyGObject_
and pycairo_ or cairocffi_)
WXAgg Agg rendering to to a :term:`wxWidgets` canvas
(requires wxPython_)
WX Native :term:`wxWidgets` drawing to a :term:`wxWidgets` Canvas
(not recommended) (requires wxPython_)
(not recommended and deprecated in 2.0) (requires wxPython_)
TkAgg Agg rendering to a :term:`Tk` canvas (requires TkInter_)
Qt4Agg Agg rendering to a :term:`Qt4` canvas (requires PyQt4_ or ``pyside``)
Qt5Agg Agg rendering in a :term:`Qt5` canvas (requires PyQt5_)
Expand Down
2 changes: 1 addition & 1 deletion doc/users/screenshots.rst
Original file line number Diff line number Diff line change
Expand Up @@ -279,7 +279,7 @@ rendering of strings with the *usetex* option.
EEG demo
=========

You can embed matplotlib into pygtk, wx, Tk, FLTK, or Qt applications.
You can embed matplotlib into pygtk, wx, Tk, or Qt applications.
Here is a screenshot of an EEG viewer called `pbrain
<http://github.com/nipy/pbrain>`__.

Expand Down
2 changes: 1 addition & 1 deletion examples/README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,6 @@ directories found here:
* units - working with unit data an custom types in matplotlib

* user_interfaces - using matplotlib in a GUI application, e.g.,
TkInter, WXPython, pygtk, pyqt or FLTK widgets
TkInter, WXPython, pygtk, pyqt widgets

* widgets - Examples using interactive widgets
1 change: 0 additions & 1 deletion examples/event_handling/test_mouseclicks.py
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@
#matplotlib.use("TkAgg")
#matplotlib.use("GTKAgg")
#matplotlib.use("Qt4Agg")
#matplotlib.use("CocoaAgg")
#matplotlib.use("MacOSX")
import matplotlib.pyplot as plt

Expand Down
4 changes: 1 addition & 3 deletions examples/user_interfaces/README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,9 @@ Embedding matplotlib in graphical user interfaces

You can embed matplotlib directly into a user interface application by
following the embedding_in_SOMEGUI.py examples here. Currently
matplotlib supports wxpython, pygtk, tkinter, pyqt, fltk and cocoa.
matplotlib supports wxpython, pygtk, tkinter and pyqt4/5.

When embedding matplotlib in a GUI, you must use the matplotlib API
directly rather than the pylab/pyplot proceedural interface, so take a
look at the examples/api directory for some example code working with
the API.


59 changes: 0 additions & 59 deletions lib/matplotlib/backends/Matplotlib.nib/classes.nib

This file was deleted.

16 changes: 0 additions & 16 deletions lib/matplotlib/backends/Matplotlib.nib/info.nib

This file was deleted.

Loading