|[ < ]||[ > ]||[ << ]||[ Up ]||[ >> ]||[Top]||[Contents]||[Index]||[ ? ]|
SDL_Surface *IMG_Load(const char *file)
Load file for use as an image in a new surface. This actually calls
IMG_LoadTyped_RW, with the file extension used as the type string. This can load all supported image files, including TGA as long as the filename ends with ".tga". It is best to call this outside of event loops, and rather keep the loaded images around until you are really done with them, as disk speed and image conversion to a surface is not that speedy. Don't forget to SDL_FreeSurface the returned surface pointer when you are through with it.
Returns: a pointer to the image as a new
SDL_Surface. NULL is returned on errors, such as no support built for the image, or a file reading error.
3.1.2 IMG_Load_RW, 3.1.3 IMG_LoadTyped_RW