Skip to content

Commit 1a9f0a2

Browse files
committed
DOC: re-word the whats new entry
1 parent 5821a24 commit 1a9f0a2

File tree

1 file changed

+11
-9
lines changed

1 file changed

+11
-9
lines changed
Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
1-
Figure now has draw_without_rendering method
2-
--------------------------------------------
1+
Figure now has ``draw_without_rendering`` method
2+
------------------------------------------------
33

4-
Rarely, the user will want to trigger a draw without making output to
5-
either the screen or a file. This is useful for determining the final
6-
position of artists on the figure that require a draw, like text artists.
7-
This could be accomplished via ``fig.canvas.draw()`` but has side effects,
8-
sometimes requires an open file, and is documented on an object most users
9-
do not need to access. The `.Figure.draw_without_rendering` is provided to trigger
10-
a draw without pushing to the final output, and with fewer side effects.
4+
Rarely, the user will want to trigger a draw without rendering to either the
5+
screen or a file. This is useful for determining the final position of artists
6+
on the figure that require a draw, like text artists, or resolve deferred
7+
computation like automatic data limits. This can be done by
8+
``fig.canvas.draw()``, which forces a full draw and rendering, however this has
9+
side effects, sometimes requires an open file, and is doing more work than is
10+
needed. The `.Figure.draw_without_rendering` method is provided to run the
11+
code in Matplotlib that updates values that are computed at draw-time and get
12+
accurate dimensions of the Artists more efficiently.

0 commit comments

Comments
 (0)