This module contains functions to transfer images in and out
of Surfaces. At the minimum the included load() function will
support BMP files. If SDL_image is properly installed when
pygame is installed, it will support all the formats included
with SDL_image. You can call the get_extended() function to test
if the SDL_image support is available.
Some functions that communicate with other libraries will require
that those libraries are properly installed. For example, the save()
function can only save OPENGL surfaces if pyopengl is available.
The flipped argument will cause the output string to have
it's contents flipped vertically.
The format argument is a string representing which type of
string data you need. It can be one of the following, \"P\"
for 8bit palette indices. \"RGB\" for 24bit RGB data, \"RGBA\"
for 32bit RGB and alpha, or \"RGBX\" for 32bit padded RGB colors.
These flags are a subset of the formats supported the PIL
Python Image Library. Note that the \"P\" format only will
work for 8bit Surfaces.
If you ask for the \"RGBA\" format and the image only has
colorkey data. An alpha channel will be created from the
colorkey values.