FindSDL_gfx — CMake 4.4.1 Documentation

# FindSDL_gfx

Added in version 3.25.

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

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

Note

This module is for SDL_gfx version 1. For version 2 or newer usage refer to the upstream documentation.

## 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.