New page in the docs: https://output.circle-artifacts.com/output/job/4a00a38f-319f-44c6-bb1b-f12494152fc1/artifacts/0/doc/build/html/api/toolkits/mplot3d/view_angles.html

I think that it is possible to store an svg-file and use that? (There's been a similar case in SymPy reducing the file size from MBs to kb... I do not know if any specific settings are required. But most browsers can render svg anyway?)

But the image looks good!

PNG size can be reduced by factors if put through a compressor like https://tinypng.com/. I think if applied to both images, sizes are reasonable small. The real advantage of SVG would be that we could adapt it later on, but I'm ok with PNG if that's what you can generate.

Content:

1. The view direction line changes from green to black, which looks weird to me:
   

2. I find the view plane a bit hard to understand, though after thinking about it, I believe it's correct.
   Would it be helpful to add the camera position and view cone similar to
   
   (don't need the fancy camera picture necessarily :))

PNGs are smaller, thanks for the site. The issue with svg is that different browsers render differently, and we actually have a great example right here. In the screenshot of the svg image for @timhoffm it looks like the arrows are not present for some reason, whereas I see arrows colored black in the previews, and when I open in inkscape the arrows colored the same as their lines (what I intended and what the png shows). Tim, do the arrows there resolve the overlaying lines looking weird?

Updated to add a little camera cone, I think I like it better even if it makes the plot a bit busier.

Wondering if for this PR or a follow on, the section in the 3D FAQ can be added/consolidated into the doc?

Are you asking for the view angles to be added to the FAQ, or the FAQ info to be interspersed elsewhere where it makes sense?

If the relevant parts of the FAQ can be incorporated into the new document so that information isn't spread across two.

I don't see anything in the FAQ that I think it makes sense to pull out to the new page, but I'm happy to just put all the new info into the existing FAQ.

Then just forget my suggestion, (sorry) since I like this is a standalone & think it's more discoverable that way (I'm not a big fan of FAQs)

Decided to test the claim that you could print out and fold the primary planes image into a box:

The camera looks good and the arrow also resolves my line issue 👍.

One additional idea for decluttering: How about only indicating the roll direction:

Technically, that's a bit different than the azimuth/elevation arrows, which show magnitude, but I think people still understand what roll is.

Maybe even show the viewing plane for roll=0, which again may be easier to comprehend as the user has less angles to process. The roll arrow then just indicates "this is the direction roll would apply to"

OK! I get the size and rendering issue, but wouldn't it make sense to have the "box" as svg so that it can easily be resized when printing? (Given that the size is not completely off. Or generate that image on the fly? I assume it is generate with mpl?)

Ok, addressed those comments. I didn't totally go with Tim's suggestion since I think showing the roll angle zero reference is important, but I did take out two of the other lines there that weren't adding much. And to Oscar's suggestion, I made the unfolded box plot a gallery example with the generating code right there. I think it all looks good!

Built docs API page: https://output.circle-artifacts.com/output/job/0162ce41-cee3-47e2-a5a8-61aa17145914/artifacts/0/doc/build/html/api/toolkits/mplot3d/view_angles.html
Built docs gallery example: https://output.circle-artifacts.com/output/job/0162ce41-cee3-47e2-a5a8-61aa17145914/artifacts/0/doc/build/html/gallery/mplot3d/view_planes_3d.html

@scottshambaugh thanks!