API: rename draw_no_output to draw_without_rendering

closes matplotlib#20001

Author: tacaswell

…rs/next_whats_new/fig_draw_no_output.rst …whats_new/fig_draw_without_rendering.rstdoc/users/next_whats_new/fig_draw_no_output.rst renamed to doc/users/next_whats_new/fig_draw_without_rendering.rst doc/users/next_whats_new/fig_draw_no_output.rst renamed to doc/users/next_whats_new/fig_draw_without_rendering.rst

@@ -1,10 +1,10 @@
-Figure now has draw_no_output method
-------------------------------------
+Figure now has draw_without_rendering method
+--------------------------------------------
 
-Rarely, the user will want to trigger a draw without making output to 
-either the screen or a file.  This is useful for determining the final 
+Rarely, the user will want to trigger a draw without making output to
+either the screen or a file.  This is useful for determining the final
 position of artists on the figure that require a draw, like text artists.
 This could be accomplished via ``fig.canvas.draw()`` but has side effects,
-sometimes requires an open file, and is documented on an object most users 
-do not need to access.  The `.Figure.draw_no_output` is provided to trigger 
-a draw without pushing to the final output, and with fewer side effects.
+sometimes requires an open file, and is documented on an object most users
+do not need to access.  The `.Figure.draw_without_rendering` is provided to trigger
+a draw without pushing to the final output, and with fewer side effects.

lib/matplotlib/backend_bases.py

@@ -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/backends/backend_pdf.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_pgf.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_ps.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_svg.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/figure.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/tests/test_axes.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_colorbar.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,

lib/matplotlib/tests/test_constrainedlayout.py

@@ -128,7 +128,7 @@ def test_constrained_layout7():
         for gs in gsl:
             fig.add_subplot(gs)
         # need to trigger a draw to get warning
-        fig.draw_no_output()
+        fig.draw_without_rendering()
 
 
 @image_comparison(['constrained_layout8.png'])
@@ -309,7 +309,7 @@ def test_constrained_layout18():
     ax2 = ax.twinx()
     example_plot(ax)
     example_plot(ax2, fontsize=24)
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     assert all(ax.get_position().extents == ax2.get_position().extents)
 
 
@@ -321,7 +321,7 @@ def test_constrained_layout19():
     example_plot(ax2, fontsize=24)
     ax2.set_title('')
     ax.set_title('')
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     assert all(ax.get_position().extents == ax2.get_position().extents)
 
 
@@ -341,11 +341,11 @@ def test_constrained_layout21():
     fig, ax = plt.subplots(constrained_layout=True)
 
     fig.suptitle("Suptitle0")
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     extents0 = np.copy(ax.get_position().extents)
 
     fig.suptitle("Suptitle1")
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     extents1 = np.copy(ax.get_position().extents)
 
     np.testing.assert_allclose(extents0, extents1)
@@ -355,11 +355,11 @@ def test_constrained_layout22():
     """#11035: suptitle should not be include in CL if manually positioned"""
     fig, ax = plt.subplots(constrained_layout=True)
 
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     extents0 = np.copy(ax.get_position().extents)
 
     fig.suptitle("Suptitle", y=0.5)
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     extents1 = np.copy(ax.get_position().extents)
 
     np.testing.assert_allclose(extents0, extents1)
@@ -407,7 +407,7 @@ def test_hidden_axes():
     # (as does a gridspec slot that is empty)
     fig, axs = plt.subplots(2, 2, constrained_layout=True)
     axs[0, 1].set_visible(False)
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     extents1 = np.copy(axs[0, 0].get_position().extents)
 
     np.testing.assert_allclose(
@@ -433,7 +433,7 @@ def test_colorbar_align():
         fig.set_constrained_layout_pads(w_pad=4 / 72, h_pad=4 / 72, hspace=0.1,
                                         wspace=0.1)
 
-        fig.draw_no_output()
+        fig.draw_without_rendering()
         if location in ['left', 'right']:
             np.testing.assert_allclose(cbs[0].ax.get_position().x0,
                                        cbs[2].ax.get_position().x0)
@@ -475,15 +475,15 @@ def test_colorbars_no_overlapH():
 def test_manually_set_position():
     fig, axs = plt.subplots(1, 2, constrained_layout=True)
     axs[0].set_position([0.2, 0.2, 0.3, 0.3])
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     pp = axs[0].get_position()
     np.testing.assert_allclose(pp, [[0.2, 0.2], [0.5, 0.5]])
 
     fig, axs = plt.subplots(1, 2, constrained_layout=True)
     axs[0].set_position([0.2, 0.2, 0.3, 0.3])
     pc = axs[0].pcolormesh(np.random.rand(20, 20))
     fig.colorbar(pc, ax=axs[0])
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     pp = axs[0].get_position()
     np.testing.assert_allclose(pp, [[0.2, 0.2], [0.44, 0.5]])
 
@@ -528,7 +528,7 @@ def test_align_labels():
 
     fig.align_ylabels(axs=(ax3, ax1, ax2))
 
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     after_align = [ax1.yaxis.label.get_window_extent(),
                    ax2.yaxis.label.get_window_extent(),
                    ax3.yaxis.label.get_window_extent()]
@@ -541,22 +541,22 @@ def test_align_labels():
 
 def test_suplabels():
     fig, ax = plt.subplots(constrained_layout=True)
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     pos0 = ax.get_tightbbox(fig.canvas.get_renderer())
     fig.supxlabel('Boo')
     fig.supylabel('Booy')
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     pos = ax.get_tightbbox(fig.canvas.get_renderer())
     assert pos.y0 > pos0.y0 + 10.0
     assert pos.x0 > pos0.x0 + 10.0
 
     fig, ax = plt.subplots(constrained_layout=True)
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     pos0 = ax.get_tightbbox(fig.canvas.get_renderer())
     # check that specifying x (y) doesn't ruin the layout
     fig.supxlabel('Boo', x=0.5)
     fig.supylabel('Boo', y=0.5)
-    fig.draw_no_output()
+    fig.draw_without_rendering()
     pos = ax.get_tightbbox(fig.canvas.get_renderer())
     assert pos.y0 > pos0.y0 + 10.0
     assert pos.x0 > pos0.x0 + 10.0