|
1 |
| -Figure now has draw_without_rendering method |
2 |
| --------------------------------------------- |
| 1 | +Figure now has ``draw_without_rendering`` method |
| 2 | +------------------------------------------------ |
3 | 3 |
|
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