Documentation Link
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_facecolor
Problem
I found the documentation of the function set_facecolors() wasn't quite clear to me as in my recent issue I realize set_facecolors() wasn't actually the same as directly modifying get_facecolors() (And the only major difference for me was setting stale=True, probably because we can't set methods to const in Python).
#27216
Suggested improvement
I think it would be wise to explicitly state that the set_* functions mark the elements/axes or anything as "stale" which trigger redrawing when next draw() is invoked.
I was looking into how to add it myself but as it turns out there were a lot of set_* functions. So I might as well ask if this is a good or stupid idea before I do it.
Documentation Link
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_facecolor
Problem
I found the documentation of the function
set_facecolors()wasn't quite clear to me as in my recent issue I realizeset_facecolors()wasn't actually the same as directly modifyingget_facecolors()(And the only major difference for me was settingstale=True, probably because we can't set methods toconstin Python).#27216
Suggested improvement
I think it would be wise to explicitly state that the
set_*functions mark the elements/axes or anything as "stale" which trigger redrawing when nextdraw()is invoked.I was looking into how to add it myself but as it turns out there were a lot of
set_*functions. So I might as well ask if this is a good or stupid idea before I do it.