Add note on writing binary formats to stdout using savefig()

timhoffm · timhoffm · commit ef0d7cf5da5c · 2020-07-25T22:06:32.000+02:00
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -2199,6 +2199,10 @@ def savefig(self, fname, *, transparent=None, **kwargs):
             :rc:`savefig.format` and the appropriate extension is appended to
             *fname*.
 
+            To write a binary format like PNG to ``sys.stdout``, use the
+            underlying binary buffer
+            ``savefig(sys.stdout.buffer, format='png', ...)``.
+
         Other Parameters
         ----------------
         dpi : float or 'figure', default: :rc:`savefig.dpi`
