Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit dbe2486

Browse filesBrowse files
committed
update backend faq
Closes #5793
1 parent bcaa6f6 commit dbe2486
Copy full SHA for dbe2486

File tree

Expand file treeCollapse file tree

1 file changed

+27
-5
lines changed
Filter options
Expand file treeCollapse file tree

1 file changed

+27
-5
lines changed

‎doc/faq/usage_faq.rst

Copy file name to clipboardExpand all lines: doc/faq/usage_faq.rst
+27-5Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -417,14 +417,16 @@ a file:
417417
============ ================================================================
418418
Backend Description
419419
============ ================================================================
420-
GTKAgg Agg rendering to a :term:`GTK` 2.x canvas (requires PyGTK_)
421-
GTK3Agg Agg rendering to a :term:`GTK` 3.x canvas (requires PyGObject_)
420+
GTKAgg Agg rendering to a :term:`GTK` 2.x canvas (requires PyGTK_ and
421+
pycairo_ or cairocffi_; Python2 only)
422+
GTK3Agg Agg rendering to a :term:`GTK` 3.x canvas (requires PyGObject_
423+
and pycairo_ or cairocffi_)
422424
GTK GDK rendering to a :term:`GTK` 2.x canvas (not recommended)
423-
(requires PyGTK_)
425+
(requires PyGTK_ and pycairo_ or cairocffi_; Python2 only)
424426
GTKCairo Cairo rendering to a :term:`GTK` 2.x canvas (requires PyGTK_
425-
and pycairo_)
427+
and pycairo_ or cairocffi_; Python2 only)
426428
GTK3Cairo Cairo rendering to a :term:`GTK` 3.x canvas (requires PyGObject_
427-
and pycairo_)
429+
and pycairo_ or cairocffi_)
428430
WXAgg Agg rendering to to a :term:`wxWidgets` canvas
429431
(requires wxPython_)
430432
WX Native :term:`wxWidgets` drawing to a :term:`wxWidgets` Canvas
@@ -446,11 +448,31 @@ macosx Cocoa rendering in OSX windows
446448
.. _PyGTK: http://www.pygtk.org
447449
.. _PyGObject: https://live.gnome.org/PyGObject
448450
.. _pycairo: http://www.cairographics.org/pycairo/
451+
.. _cairocffi: https://pythonhosted.org/cairocffi/
449452
.. _wxPython: http://www.wxpython.org/
450453
.. _TkInter: http://wiki.python.org/moin/TkInter
451454
.. _PyQt4: http://www.riverbankcomputing.co.uk/software/pyqt/intro
452455
.. _PyQt5: http://www.riverbankcomputing.co.uk/software/pyqt/intro
453456

457+
WX backends
458+
===========
459+
460+
At present the release version of `wxPython` (also known as wxPython classic)
461+
does not support python3. A work in progress redesigned version known as
462+
wxPython-Phoenix_ does support python3.
463+
Matplotlib should work with both versions.
464+
465+
.. _wxPython-Phoenix: http://wxpython.org/Phoenix/docs/html/main.html
466+
467+
GTK and Cairo
468+
=============
469+
470+
Both `GTK2` and `GTK3` have implicit dependencies on PyCairo regardless of the
471+
specific Matplotlib backend used. Unfortunatly the latest release of PyCairo
472+
for Python3 does not implement the Python wrappers needed for the `GTK3Agg`
473+
backend. `Cairocffi` can be used as a replacement which implements the correct
474+
wrapper.
475+
454476
How do I select PyQt4 or PySide?
455477
========================================
456478

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.