|
5 | 5 | `~.LayoutEngine` defined here (or *None* for no layout). At draw time |
6 | 6 | ``figure.get_layout_engine().execute()`` is called, the goal of which is |
7 | 7 | usually to rearrange Axes on the figure to produce a pleasing layout. This is |
8 | | -like a ``draw`` callback, however when printing we disable the layout engine |
9 | | -for the final draw and it is useful to know the layout engine while the figure |
10 | | -is being created, in particular to deal with colorbars. |
| 8 | +like a ``draw`` callback but with two differences. First, when printing we |
| 9 | +disable the layout engine for the final draw. Second, it is useful to know the |
| 10 | +layout engine while the figure is being created. In particular, colorbars are |
| 11 | +made differently with different layout engines (for historical reasons). |
11 | 12 |
|
12 | 13 | Matplotlib supplies two layout engines, `.TightLayoutEngine` and |
13 | 14 | `.ConstrainedLayoutEngine`. Third parties can create their own layout engine |
|