# SDL_image 3.0

This is the SDL3 wiki. SDL2 is [over here](/SDL2_image)!

## What is it?

This is a simple library to load images of various formats as SDL surfaces.
It can load BMP, GIF, JPEG, LBM, PCX, PNG, PNM (PPM/PGM/PBM), QOI, TGA, XCF, XPM, and simple SVG format images. It can also load AVIF, JPEG-XL, TIFF, and WebP images, depending on build options.

This library is distributed under the [zlib license](https://www.libsdl.org/license.php). This license allows you to use it freely in any software.

## Getting and installing SDL_image

- The latest release is available on [GitHub](https://github.com/libsdl-org/SDL_image/releases).
- [Installation](https://github.com/libsdl-org/SDL_image/blob/main/INSTALL.md): How to install SDL_image on your platform of choice
  and link your program against it.

## API Documentation

- [API quick reference](QuickReference)
- [Complete API index](CategoryAPI)
- [Hello World](https://github.com/libsdl-org/SDL_image/blob/main/docs/hello.c) example, with build instructions for your development environment in the [installation instructions](https://github.com/libsdl-org/SDL_image/blob/main/INSTALL.md)

## Other sources of information

- [SDL 2.0 Migration Guide](https://github.com/libsdl-org/SDL_image/blob/main/docs/README-migration.md)
- [Forums/mailing lists](https://discourse.libsdl.org/) and of course [a Discord server](https://discord.gg/BwpFGBWsv8). Both are great places
  to keep up with the latest news, help other users out, and ask questions.

## Other stuff

We hope you find everything you are looking for and enjoy using SDL_image!

If anything is not addressed somewhere here, feel free to
[open an issue](https://github.com/libsdl-org/SDL_image/issues) or
[submit a pull request](https://github.com/libsdl-org/SDL_image/pulls).

**Enjoy!**
