document get_desktop_sizes

[robertpfeiffer]

This function has been in PyGame 2.0.0, and does what people want list_modes to do, so it's high time we document it on pygame.org

[zoldalma999]

There is a part in the display docs that look like this:

Pygame can only have a single display active at any time. Creating a new one with pygame.display.set_mode() will close the previous display. If precise control is needed over the pixel format or display resolutions, use the functions pygame.display.mode_ok(), pygame.display.list_modes(), and pygame.display.Info() to query information about the display.

It should probably be changed to mention get_desktop_sizes.

Apart from these it looks good to me!

[robertpfeiffer]

Thanks for the feedback. Today, precise control over pixel format and display resolution is almost never the right idea, because we do not use CRTs any more. As for having a single display active at a time, that is also not true any more if you use pygame._sdl2.

I'll try to find a diplomatic way to phrase this, but the easiest way to explain all this would be mentioning that SDL1.2 was made in the age of CRTs, before flat screens, and before GPUs in every PC. With SDL2, you can just assume that every platform supports at least 32bit RGBA.

[illume]

👍 🎉 thanks!