FindSDL_gfx

Finds the SDL_gfx library that provides graphics support in SDL (Simple DirectMedia Layer) applications:

find_package(SDL_gfx [<version>] [...])

Imported Targets

This module provides the following Imported Targets:

SDL::SDL_gfx

Target encapsulating the SDL_gfx library usage requirements, available if SDL_gfx is found.

Result Variables

This module defines the following variables:

SDL_gfx_FOUND

Boolean indicating whether the (requested version of) SDL_gfx library was found.

SDL_gfx_VERSION

Added in version 4.2.

The human-readable string containing the version of SDL_gfx found.

Cache Variables

The following cache variables may also be set:

SDL_GFX_INCLUDE_DIRS

The directory containing the headers needed to use SDL_gfx.

SDL_GFX_LIBRARIES

The path to the SDL_gfx library needed to link against to use SDL_gfx.

Hints

This module accepts the following variables:

SDLDIR

Environment variable that can be set to help locate an SDL library installed in a custom location. It should point to the installation destination that was used when configuring, building, and installing SDL library: ./configure --prefix=$SDLDIR.

Deprecated Variables

The following variables are provided for backward compatibility:

SDL_GFX_FOUND

Deprecated since version 4.2: Use SDL_gfx_FOUND, which has the same value.

Boolean indicating whether the (requested version of) SDL_gfx library was found.

SDL_GFX_VERSION_STRING

Deprecated since version 4.2: Use the SDL_gfx_VERSION.

The human-readable string containing the version of SDL_gfx found.

Examples

Finding SDL_gfx library and linking it to a project target:

find_package(SDL_gfx)
target_link_libraries(project_target PRIVATE SDL::SDL_gfx)

See Also

• The FindSDL module to find the main SDL library.