Use imageio intersphinx links

[adeak]

We have the imageio intersphinx inventory located in doc/conf.py, but we weren't actually using it. This is a quick fix for this.

However, there's a related can of worms here: the links are kind of stale now, because

1. there's a v2 to v3 API migration
2. get_writer is no longer documented online
3. its docstring doesn't actually say much about kwargs which are plugin-specific.

Any recommendation of what we should do on our side? Upgrade our pointers to v3? Can we use a better link for explaining gif/mp4 writer kwargs?

[codecov]

Codecov Report

Merging #2489 (52f316d) into main (6bb517c) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #2489   +/-   ##
=======================================
  Coverage   93.70%   93.70%           
=======================================
  Files          75       75           
  Lines       16072    16072           
=======================================
  Hits        15061    15061           
  Misses       1011     1011           

[MatthewFlamm]

Is this the documentation for get_writer here:

https://imageio.readthedocs.io/en/stable/reference/userapi.html#imageio.v2.get_writer

I'm not too familiar with how it chooses which writer, but assuming it is ffmpeg, the documented kwargs are here

https://imageio.readthedocs.io/en/stable/_autosummary/imageio.plugins.ffmpeg.html

[adeak]

Is this the documentation for get_writer here:

https://imageio.readthedocs.io/en/stable/reference/userapi.html#imageio.v2.get_writer

Thanks @MatthewFlamm, I forgot that I found that on the page eventually... I could now fix our links by using imageio.v2.get_writer in the link but printing it as imageio.get_writer().

I'm not too familiar with how it chooses which writer, but assuming it is ffmpeg, the documented kwargs are here

https://imageio.readthedocs.io/en/stable/_autosummary/imageio.plugins.ffmpeg.html

I don't know it either. And we also have open_gif which might use another backend. That's kind of my point: I'm wondering if we could get a better pointer for users. Something like "Do reader = imageio.get_writer(filename); help(reader)" (if that works!) might also be an option...

[adeak]

I won't have bandwidth to figure out something better for this in the near future, so we should consider these changes for merging.

[MatthewFlamm]

I'm okay with the changes. I agree that it would be great to figure out how to point users to the exact kwargs to use, but it doesn't seem straightforward.