added rcParam['legend.scatterpoints']

Author: Thomas A Caswell

lib/matplotlib/legend.py

@@ -135,7 +135,7 @@ def __init__(self, parent, handles, labels,
                  numpoints=None,    # the number of points in the legend line
                  markerscale=None,  # the relative size of legend markers
                                     # vs. original
-                 scatterpoints=3,    # TODO: may be an rcParam
+                 scatterpoints=None,    # TODO: may be an rcParam
                  scatteryoffsets=None,
                  prop=None,          # properties for the legend texts
                  fontsize=None,        # keyword to set font size directly

lib/matplotlib/rcsetup.py

@@ -511,6 +511,7 @@ def __call__(self, s):
     'legend.loc'         : ['upper right',validate_legend_loc], # at some point, this should be changed to 'best'
     'legend.isaxes'      : [True,validate_bool],  # this option is internally ignored - it never served any useful purpose
     'legend.numpoints'   : [2, validate_int],     # the number of points in the legend line
+    'legend.scatterpoints' : [3, validate_int],     # the number of points in the legend line for scatter
     'legend.fontsize'    : ['large', validate_fontsize],
     'legend.markerscale' : [1.0, validate_float], # the relative size of legend markers vs. original
     'legend.shadow'        : [False, validate_bool],

matplotlibrc.template

@@ -295,6 +295,7 @@ text.hinting_factor : 8 # Specifies the amount of softness for hinting in the
 #legend.columnspacing : 2.    # the border between the axes and legend edge in fraction of fontsize
 #legend.shadow        : False
 #legend.frameon       : True   # whether or not to draw a frame around legend
+#legend.scatterpoints : 3 # number of scatter points
 
 ### FIGURE
 # See http://matplotlib.org/api/figure_api.html#matplotlib.figure.Figure