Merge pull request matplotlib#20931 from tacaswell/api_rename_draw_no_output

API: rename draw_no_output to draw_without_rendering

Author: timhoffm

doc/users/next_whats_new/fig_draw_no_output.rst

@@ -0,0 +1,12 @@
+Figure now has ``draw_without_rendering`` method
+------------------------------------------------
+
+Some aspects of a figure are only determined at draw-time, such as the exact
+position of text artists or deferred computation like automatic data limits.
+If you need these values, you can use ``figure.canvas.draw()`` to force a full
+draw. However, this has side effects, sometimes requires an open file, and is
+doing more work than is needed.
+
+The new `.Figure.draw_without_rendering` method runs all the updates that
+``draw()`` does, but skips rendering the figure. It's thus more efficient if you
+need the updated values to configure further aspects of the figure.

doc/users/next_whats_new/fig_draw_without_rendering.rst

@@ -1570,7 +1570,7 @@ def _draw(renderer): raise Done(renderer)
 def _no_output_draw(figure):
     # _no_output_draw was promoted to the figure level, but
     # keep this here in case someone was calling it...
-    figure.draw_no_output()
+    figure.draw_without_rendering()
 
 
 def _is_non_interactive_terminal_ipython(ip):

lib/matplotlib/backend_bases.py

@@ -2793,7 +2793,7 @@ def print_pdf(self, filename, *,
                 file.close()
 
     def draw(self):
-        self.figure.draw_no_output()
+        self.figure.draw_without_rendering()
         return super().draw()
 
 

lib/matplotlib/backends/backend_pdf.py

@@ -883,7 +883,7 @@ def get_renderer(self):
         return RendererPgf(self.figure, None)
 
     def draw(self):
-        self.figure.draw_no_output()
+        self.figure.draw_without_rendering()
         return super().draw()
 
 

lib/matplotlib/backends/backend_pgf.py

@@ -1119,7 +1119,7 @@ def _print_figure_tex(
             _move_path_to_path_or_stream(tmpfile, outfile)
 
     def draw(self):
-        self.figure.draw_no_output()
+        self.figure.draw_without_rendering()
         return super().draw()
 
 

lib/matplotlib/backends/backend_ps.py

@@ -1343,7 +1343,7 @@ def get_default_filetype(self):
         return 'svg'
 
     def draw(self):
-        self.figure.draw_no_output()
+        self.figure.draw_without_rendering()
         return super().draw()
 
 

lib/matplotlib/backends/backend_svg.py

@@ -2808,7 +2808,7 @@ def draw(self, renderer):
 
         self.canvas.draw_event(renderer)
 
-    def draw_no_output(self):
+    def draw_without_rendering(self):
         """
         Draw the figure with no output.  Useful to get the final size of
         artists that require a draw before their size is known (e.g. text).

lib/matplotlib/figure.py

@@ -4793,7 +4793,7 @@ def test_reset_ticks(fig_test, fig_ref):
             labelsize=14, labelcolor='C1', labelrotation=45,
             grid_color='C2', grid_alpha=0.8, grid_linewidth=3,
             grid_linestyle='--')
-        fig.draw_no_output()
+        fig.draw_without_rendering()
 
     # After we've changed any setting on ticks, reset_ticks will mean
     # re-creating them from scratch. This *should* appear the same as not

lib/matplotlib/tests/test_axes.py

@@ -613,7 +613,7 @@ def test_mappable_2d_alpha():
     # the original alpha array
     assert cb.alpha is None
     assert pc.get_alpha() is x
-    fig.draw_no_output()
+    fig.draw_without_rendering()
 
 
 def test_colorbar_label():
@@ -766,7 +766,7 @@ def test_inset_colorbar_layout():
     cax = ax.inset_axes([1.02, 0.1, 0.03, 0.8])
     cb = fig.colorbar(pc, cax=cax)
 
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     # make sure this is in the figure. In the colorbar swapping
     # it was being dropped from the list of children...
     np.testing.assert_allclose(cb.ax.get_position().bounds,
@@ -806,7 +806,7 @@ def test_aspects():
             pc = ax[mm, nn].pcolormesh(np.arange(100).reshape(10, 10))
             cb[nn][mm] = fig.colorbar(pc, ax=ax[mm, nn], orientation=orient,
                                       aspect=aspect, extend=extend)
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     # check the extends are right ratio:
     np.testing.assert_almost_equal(cb[0][1].ax.get_position().height,
                                    cb[0][0].ax.get_position().height * 0.9,