FindGDAL

Deprecated since version 4.0: GDAL 3.5 and above provide a GDALConfig.cmake package configuration file. Call find_package(GDAL CONFIG) to find it directly and avoid using this find module. For further details, see GDAL's documentation on CMake integration.

Finds Geospatial Data Abstraction Library (GDAL):

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

Imported Targets

This module provides the following Imported Targets:

GDAL::GDAL

Added in version 3.14.

Target encapsulating the GDAL usage requirements, available only if GDAL has been found.

Result Variables

This module defines the following variables:

GDAL_FOUND

Boolean indicating whether (the requested version of) GDAL is found.

GDAL_VERSION

Added in version 3.14.

The version of GDAL found.

GDAL_INCLUDE_DIRS

Include directories for GDAL headers.

GDAL_LIBRARIES

Libraries to link to GDAL.

Cache Variables

The following cache variables may also be set:

GDAL_INCLUDE_DIR

The directory containing <gdal.h>.

GDAL_LIBRARY

The libgdal library file.

Hints

The following variables may be set to modify the search strategy:

GDAL_DIR or GDAL_ROOT

Set one of these environment variables to specify the GDAL installation prefix.

FindGDAL_SKIP_GDAL_CONFIG

If set, gdal-config will not be used. This can be useful if there are GDAL libraries built with autotools (which provide the tool) and CMake (which do not) in the same environment.

GDAL_ADDITIONAL_LIBRARY_VERSIONS

Extra versions of library names to search for.

Examples

Finding GDAL in config mode without using this module and linking its imported target to a project target:

find_package(GDAL CONFIG)
target_link_libraries(example PRIVATE GDAL::GDAL)