Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 6a798f0

Browse files
tacaswelltacaswell
authored
Merge pull request #6582 from jenshnielsen/deprecategtkwxcocoaagg
API: Deprecate gtk, gdk and wx backends and remove Cocoaagg on 2.x
2 parents c0d4321 + 31837cc commit 6a798f0

File tree

17 files changed

+64
-1630
lines changed

17 files changed

+64
-1630
lines changed

‎doc/api/api_changes/2016-06-deprecate_backends.rst

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
GTK and GDK backends deprecated
2+
```````````````````````````````
3+
The untested and broken GDK and GTK backends have been deprecated.
4+
These backends allows figures to be rendered via the GDK api to
5+
files and GTK2 figures. They are untested, known to be broken and
6+
use have been discouraged for some time. The `GTKAgg` and `GTKCairo` backends
7+
provide better and more tested ways of rendering figures to GTK2 windows.
8+
9+
WX backend deprecated
10+
`````````````````````
11+
The untested WX backend has been deprecated.
12+
This backend allows figures to be rendered via the WX api to
13+
files and Wx figures. It is untested, and
14+
use have been discouraged for some time. The `WXAgg` backend
15+
provides a better and more tested way of rendering figures to WX windows.
16+
17+
CocoaAgg backend removed
18+
````````````````````````
19+
20+
The deprecated and not fully functional CocoaAgg backend has been removed

‎doc/faq/usage_faq.rst

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -370,10 +370,10 @@ renderer for user interfaces is ``Agg`` which uses the `Anti-Grain
370370
Geometry`_ C++ library to make a raster (pixel) image of the figure.
371371
All of the user interfaces except ``macosx`` can be used with
372372
agg rendering, e.g.,
373-
``WXAgg``, ``GTKAgg``, ``QT4Agg``, ``TkAgg``. In
373+
``WXAgg``, ``GTKAgg``, ``QT4Agg``, ``QT5Agg``, ``TkAgg``. In
374374
addition, some of the user interfaces support other rendering engines.
375375
For example, with GTK, you can also select GDK rendering (backend
376-
``GTK``) or Cairo rendering (backend ``GTKCairo``).
376+
``GTK`` deprecated in 2.0) or Cairo rendering (backend ``GTKCairo``).
377377

378378
For the rendering engines, one can also distinguish between `vector
379379
<http://en.wikipedia.org/wiki/Vector_graphics>`_ or `raster
@@ -404,7 +404,7 @@ SVG :term:`svg` :term:`vector graphics` --
404404
:term:`svg`
405405
...
406406
:term:`GDK` :term:`png` :term:`raster graphics` --
407-
:term:`jpg` the `Gimp Drawing Kit`_
407+
:term:`jpg` the `Gimp Drawing Kit`_ Deprecated in 2.0
408408
:term:`tiff`
409409
...
410410
============= ============ ================================================
@@ -421,16 +421,17 @@ GTKAgg Agg rendering to a :term:`GTK` 2.x canvas (requires PyGTK_ and
421421
pycairo_ or cairocffi_; Python2 only)
422422
GTK3Agg Agg rendering to a :term:`GTK` 3.x canvas (requires PyGObject_
423423
and pycairo_ or cairocffi_)
424-
GTK GDK rendering to a :term:`GTK` 2.x canvas (not recommended)
425-
(requires PyGTK_ and pycairo_ or cairocffi_; Python2 only)
424+
GTK GDK rendering to a :term:`GTK` 2.x canvas (not recommended and d
425+
eprecated in 2.0) (requires PyGTK_ and pycairo_ or cairocffi_;
426+
Python2 only)
426427
GTKCairo Cairo rendering to a :term:`GTK` 2.x canvas (requires PyGTK_
427428
and pycairo_ or cairocffi_; Python2 only)
428429
GTK3Cairo Cairo rendering to a :term:`GTK` 3.x canvas (requires PyGObject_
429430
and pycairo_ or cairocffi_)
430431
WXAgg Agg rendering to to a :term:`wxWidgets` canvas
431432
(requires wxPython_)
432433
WX Native :term:`wxWidgets` drawing to a :term:`wxWidgets` Canvas
433-
(not recommended) (requires wxPython_)
434+
(not recommended and deprecated in 2.0) (requires wxPython_)
434435
TkAgg Agg rendering to a :term:`Tk` canvas (requires TkInter_)
435436
Qt4Agg Agg rendering to a :term:`Qt4` canvas (requires PyQt4_ or ``pyside``)
436437
Qt5Agg Agg rendering in a :term:`Qt5` canvas (requires PyQt5_)

‎doc/users/screenshots.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -279,7 +279,7 @@ rendering of strings with the *usetex* option.
279279
EEG demo
280280
=========
281281

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

‎examples/README.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,6 @@ directories found here:
3838
* units - working with unit data an custom types in matplotlib
3939

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

4343
* widgets - Examples using interactive widgets

‎examples/event_handling/test_mouseclicks.py

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@
66
#matplotlib.use("TkAgg")
77
#matplotlib.use("GTKAgg")
88
#matplotlib.use("Qt4Agg")
9-
#matplotlib.use("CocoaAgg")
109
#matplotlib.use("MacOSX")
1110
import matplotlib.pyplot as plt
1211

‎examples/user_interfaces/README.txt

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,9 @@ Embedding matplotlib in graphical user interfaces
33

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

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

‎lib/matplotlib/backends/Matplotlib.nib/classes.nib

Lines changed: 0 additions & 59 deletions
This file was deleted.

‎lib/matplotlib/backends/Matplotlib.nib/info.nib

Lines changed: 0 additions & 16 deletions
This file was deleted.

0 commit comments

Comments
 (0)