im_invalidate(3)
marks all caches related to the image as invalid and requring recalculation.
It needs to be called if an image changes after being made: for example, after
a paint action, or perhaps after a new frame has arrived from a video source.
Any invalidate callbacks registered on any of the affected images are
triggered.