1
2API Changes in 2.0.1
3====================
4
5Extensions to `matplotlib.backend_bases.GraphicsContextBase`
6------------------------------------------------------------
7
8To better support controlling the color of hatches, the method
9`matplotlib.backend_bases.GraphicsContextBase.set_hatch_color` was
10added to the expected API of ``GraphicsContext`` classes.  Calls to
11this method are currently wrapped with a ``try:...except Attribute:``
12block to preserve back-compatibility with any third-party backends
13which do not extend `~matplotlib.backend_bases.GraphicsContextBase`.
14
15This value can be accessed in the backends via
16`matplotlib.backend_bases.GraphicsContextBase.get_hatch_color` (which
17was added in 2.0 see :ref:`gc_get_hatch_color_wn`) and should be used
18to color the hatches.
19
20In the future there may also be ``hatch_linewidth`` and
21``hatch_density`` related methods added.  It is encouraged, but not
22required that third-party backends extend
23`~matplotlib.backend_bases.GraphicsContextBase` to make adapting to
24these changes easier.
25
26
27``afm.get_fontconfig_fonts`` returns a list of paths and does not check for existence
28-------------------------------------------------------------------------------------
29
30``afm.get_fontconfig_fonts`` used to return a set of paths encoded as a
31``{key: 1, ...}`` dict, and checked for the existence of the paths.  It now
32returns a list and dropped the existence check, as the same check is performed
33by the caller (``afm.findSystemFonts``) as well.
34
35
36``bar`` now returns rectangles of negative height or width if the corresponding input is negative
37-------------------------------------------------------------------------------------------------
38
39`.pyplot.bar` used to normalize the coordinates of the rectangles that it
40created, to keep their height and width positives, even if the corresponding
41input was negative.  This normalization has been removed to permit a simpler
42computation of the correct `.Artist.sticky_edges` to use.
43
44
45Do not clip line width when scaling dashes
46------------------------------------------
47
48The algorithm to scale dashes was changed to no longer clip the
49scaling factor: the dash patterns now continue to shrink at thin line widths.
50If the line width is smaller than the effective pixel size, this may result in
51dashed lines turning into solid gray-ish lines.  This also required slightly
52tweaking the default patterns for '--', ':', and '.-' so that with the default
53line width the final patterns would not change.
54
55There is no way to restore the old behavior.
56
57
58Deprecate 'Vega' colormaps
59--------------------------
60
61The "Vega" colormaps are deprecated in Matplotlib 2.0.1 and will be
62removed in Matplotlib 2.2. Use the "tab" colormaps instead: "tab10",
63"tab20", "tab20b", "tab20c".
64