Merge pull request matplotlib#1221 from efiring/revert_1125_oo_helper

revert PR matplotlib#1125 and matplotlib#1201
closes matplotlib#1218 and matplotlib#1212

Author: efiring

doc/users/whats_new.rst

@@ -41,17 +41,6 @@ Features that depend on the Python Imaging Library, such as JPEG
 handling, do not work, since the version of PIL for Python 3.x is not
 sufficiently mature.
 
-Object-oriented interface
--------------------------
-
-Damon McDougall has reduced some of the boilerplate code needed to interact
-with the object-oriented interface. Now a figure canvas is set up by default::
-
-    >>> from matplotlib.figure import Figure
-    >>> fig = Figure()
-    >>> ax = fig.add_subplot(1, 1, 1)
-    >>> fig.savefig('figure.pdf')
-
 PGF/TikZ backend
 ----------------
 Peter Würtz wrote a backend that allows matplotlib to export figures as

lib/matplotlib/backends/backend_agg.py

@@ -515,5 +515,3 @@ def print_to_buffer(self):
                   (int(renderer.width), int(renderer.height)))
         renderer.dpi = original_dpi
         return result
-
-FigureCanvas = FigureCanvasAgg

lib/matplotlib/backends/backend_cairo.py

@@ -512,5 +512,3 @@ def _save (self, fo, format, **kwargs):
 
         ctx.show_page()
         surface.finish()
-
-FigureCanvas = FigureCanvasCairo

lib/matplotlib/backends/backend_cocoaagg.py

@@ -89,7 +89,7 @@ def stop_event_loop(self):
         FigureCanvasBase.stop_event_loop_default(self)
     stop_event_loop.__doc__=FigureCanvasBase.stop_event_loop_default.__doc__
 
-FigureCanvas = FigureCanvasCocoaAgg
+
 
 NibClassBuilder.extractClasses('Matplotlib.nib', mplBundle)
 

lib/matplotlib/backends/backend_emf.py

@@ -727,8 +727,6 @@ def print_emf(self, filename, dpi=300, **kwargs):
     def get_default_filetype(self):
         return 'emf'
 
-FigureCanvas = FigureCanvasEMF
-
 class FigureManagerEMF(FigureManagerBase):
     """
     Wrap everything up into a window for the pylab interface

lib/matplotlib/backends/backend_fltkagg.py

@@ -231,8 +231,6 @@ def stop_event_loop(self):
         FigureCanvasBase.stop_event_loop_default(self)
     stop_event_loop.__doc__=FigureCanvasBase.stop_event_loop_default.__doc__
 
-FigureCanvas = FigureCanvasFltkAgg
-
 def destroy_figure(ptr, figman):
     figman.window.hide()
     Fltk.Fl.wait(0)         # This is needed to make the last figure vanish.

lib/matplotlib/backends/backend_gdk.py

@@ -434,7 +434,7 @@ def new_figure_manager_given_figure(num, figure):
     return manager
 
 
-class FigureCanvasGDK(FigureCanvasBase):
+class FigureCanvasGDK (FigureCanvasBase):
     def __init__(self, figure):
         FigureCanvasBase.__init__(self, figure)
 
@@ -472,5 +472,3 @@ def _print_image(self, filename, format, *args, **kwargs):
                                  0, 0, 0, 0, width, height)
 
         pixbuf.save(filename, format)
-
-FigureCanvas = FigureCanvasGDK

lib/matplotlib/backends/backend_gtk.py

@@ -144,7 +144,7 @@ def _on_timer(self):
             return False
 
 
-class FigureCanvasGTK(gtk.DrawingArea, FigureCanvasBase):
+class FigureCanvasGTK (gtk.DrawingArea, FigureCanvasBase):
     keyvald = {65507 : 'control',
                65505 : 'shift',
                65513 : 'alt',
@@ -519,8 +519,6 @@ def stop_event_loop(self):
         FigureCanvasBase.stop_event_loop_default(self)
     stop_event_loop.__doc__=FigureCanvasBase.stop_event_loop_default.__doc__
 
-FigureCanvas = FigureCanvasGTK
-
 class FigureManagerGTK(FigureManagerBase):
     """
     Public attributes

lib/matplotlib/backends/backend_gtk3.py

@@ -98,7 +98,7 @@ def _on_timer(self):
             self._timer = None
             return False
 
-class FigureCanvasGTK3(Gtk.DrawingArea, FigureCanvasBase):
+class FigureCanvasGTK3 (Gtk.DrawingArea, FigureCanvasBase):
     keyvald = {65507 : 'control',
                65505 : 'shift',
                65513 : 'alt',

lib/matplotlib/backends/backend_gtk3agg.py

@@ -67,7 +67,6 @@ def print_png(self, filename, *args, **kwargs):
         agg = self.switch_backends(backend_agg.FigureCanvasAgg)
         return agg.print_png(filename, *args, **kwargs)
 
-FigureCanvas = FigureCanvasGTK3Agg
 
 class FigureManagerGTK3Agg(backend_gtk3.FigureManagerGTK3):
     pass

lib/matplotlib/backends/backend_gtk3cairo.py

@@ -34,7 +34,6 @@ def on_draw_event(self, widget, ctx):
 
         return False  # finish event propagation?
 
-FigureCanvas = FigureCanvasGTK3Cairo
 
 class FigureManagerGTK3Cairo(backend_gtk3.FigureManagerGTK3):
     pass

lib/matplotlib/backends/backend_gtkagg.py

@@ -111,7 +111,6 @@ def print_png(self, filename, *args, **kwargs):
         agg = self.switch_backends(FigureCanvasAgg)
         return agg.print_png(filename, *args, **kwargs)
 
-FigureCanvas = FigureCanvasGTKAgg
 
 """\
 Traceback (most recent call last):

lib/matplotlib/backends/backend_gtkcairo.py

@@ -55,7 +55,6 @@ def _renderer_init(self):
         if _debug: print('%s.%s()' % (self.__class__.__name__, _fn_name()))
         self._renderer = RendererGTKCairo (self.figure.dpi)
 
-FigureCanvas = FigureCanvasGTKCairo
 
 class FigureManagerGTKCairo(FigureManagerGTK):
     def _get_toolbar(self, canvas):

lib/matplotlib/backends/backend_macosx.py

@@ -352,7 +352,6 @@ def new_timer(self, *args, **kwargs):
         """
         return TimerMac(*args, **kwargs)
 
-FigureCanvas = FigureCanvasMac
 
 class FigureManagerMac(_macosx.FigureManager, FigureManagerBase):
     """

lib/matplotlib/backends/backend_pdf.py

@@ -2299,8 +2299,6 @@ def print_pdf(self, filename, **kwargs):
             else:            # we opened the file above; now finish it off
                 file.close()
 
-FigureCanvas = FigureCanvasPdf
-
 class FigureManagerPdf(FigureManagerBase):
     pass
 

lib/matplotlib/backends/backend_pgf.py

@@ -838,8 +838,6 @@ def _render_texts_pgf(self, fh):
     def get_renderer(self):
         return RendererPgf(self.figure, None)
 
-FigureCanvas = FigureCanvasPgf
-
 class FigureManagerPgf(FigureManagerBase):
     def __init__(self, *args):
         FigureManagerBase.__init__(self, *args)

lib/matplotlib/backends/backend_ps.py

@@ -1357,8 +1357,6 @@ def write(self, *kl, **kwargs):
             shutil.move(tmpfile, outfile)
             os.chmod(outfile, mode)
 
-FigureCanvas = FigureCanvasPS
-
 def convert_psfrags(tmpfile, psfrags, font_preamble, custom_preamble,
                     paperWidth, paperHeight, orientation):
     """

lib/matplotlib/backends/backend_qt.py

@@ -203,8 +203,6 @@ def stop_event_loop(self):
         FigureCanvasBase.stop_event_loop_default(self)
     stop_event_loop.__doc__=FigureCanvasBase.stop_event_loop_default.__doc__
 
-FigureCanvas = FigureCanvasQT
-
 class FigureManagerQT( FigureManagerBase ):
     """
     Public attributes

lib/matplotlib/backends/backend_qt4.py

@@ -377,8 +377,6 @@ def idle_draw(*args):
             self._idle = True
         if d: QtCore.QTimer.singleShot(0, idle_draw)
 
-FigureCanvas = FigureCanvasQT
-
 class FigureManagerQT( FigureManagerBase ):
     """
     Public attributes

lib/matplotlib/backends/backend_qt4agg.py

@@ -145,5 +145,3 @@ def blit(self, bbox=None):
     def print_figure(self, *args, **kwargs):
         FigureCanvasAgg.print_figure(self, *args, **kwargs)
         self.draw()
-
-FigureCanvas = FigureCanvasQTAgg

lib/matplotlib/backends/backend_qtagg.py

@@ -156,5 +156,3 @@ def blit(self, bbox=None):
     def print_figure(self, *args, **kwargs):
         FigureCanvasAgg.print_figure(self, *args, **kwargs)
         self.draw()
-
-FigureCanvas = FigureCanvasQTAgg

lib/matplotlib/backends/backend_svg.py

@@ -1143,8 +1143,6 @@ def _print_svg(self, filename, svgwriter, fh_to_close=None, **kwargs):
     def get_default_filetype(self):
         return 'svg'
 
-FigureCanvas = FigureCanvasSVG
-
 class FigureManagerSVG(FigureManagerBase):
     pass
 

lib/matplotlib/backends/backend_template.py

@@ -245,8 +245,6 @@ def print_foo(self, filename, *args, **kwargs):
     def get_default_filetype(self):
         return 'foo'
 
-FigureCanvas = FigureCanvasTemplate
-
 class FigureManagerTemplate(FigureManagerBase):
     """
     Wrap everything up into a window for the pylab interface

lib/matplotlib/backends/backend_tkagg.py

@@ -505,8 +505,6 @@ def stop_event_loop(self):
         FigureCanvasBase.stop_event_loop_default(self)
     stop_event_loop.__doc__=FigureCanvasBase.stop_event_loop_default.__doc__
 
-FigureCanvas = FigureCanvasTkAgg
-
 class FigureManagerTkAgg(FigureManagerBase):
     """
     Public attributes

lib/matplotlib/backends/backend_wx.py

@@ -1400,7 +1400,6 @@ def _onEnter(self, evt):
         """Mouse has entered the window."""
         FigureCanvasBase.enter_notify_event(self, guiEvent = evt)
 
-FigureCanvas = FigureCanvasWx
 
 ########################################################################
 #

lib/matplotlib/backends/backend_wxagg.py

@@ -105,8 +105,6 @@ def print_figure(self, filename, *args, **kwargs):
         if self._isDrawn:
             self.draw()
 
-FigureCanvas = FigureCanvasWxAgg
-
 class NavigationToolbar2WxAgg(NavigationToolbar2Wx):
     def get_canvas(self, frame, fig):
         return FigureCanvasWxAgg(frame, -1, fig)

lib/matplotlib/figure.py

@@ -318,7 +318,7 @@ def __init__(self,
         self.patch.set_aa(False)
 
         self._hold = rcParams['axes.hold']
-        self.canvas = self._setup_canvas()
+        self.canvas = None
 
         if subplotpars is None:
             subplotpars = SubplotParams()
@@ -330,14 +330,6 @@ def __init__(self,
         self.clf()
         self._cachedRenderer = None
 
-    def _setup_canvas(self):
-        """
-        Return the FigureCanvas instance defined by the currently loaded backend.
-        """
-        import matplotlib.backends as mbackends  # lazy import
-        backend_mod = mbackends.pylab_setup()[0]
-        return backend_mod.FigureCanvas(self)
-
     def show(self, warn=True):
         """
         If using a GUI backend with pyplot, display the figure window.