Archive

libarchive is a library that supports a varietyof archive and compression formats. It might be used since GDAL 3.7 to enablethe/vsi7z/ virtual file system.

ARCHIVE_INCLUDE_DIR

Path to an include directory with thearchive.h header file.

ARCHIVE_LIBRARY

Path to a shared or static library file.

GDAL_USE_ARCHIVE=ON/OFF

Control whether to use libarchive. Defaults to ON when libarchive is found.

Armadillo

TheArmadillo C++ library is used to speed up computations related to theThin Plate Spline transformer. Seehttps://cmake.org/cmake/help/latest/module/FindArmadillo.htmlfor details.On Windows builds using Conda-Forge dependencies, the following packages may alsoneed to be installed:blasblas-devellibblaslibcblasliblapackliblapacke

GDAL_USE_ARMADILLO=ON/OFF

Control whether to use Armadillo. Defaults to ON when Armadillo is found.

Arrow

TheApache Arrow C++ <https://github.com/apache/arrow/tree/master/cpp> libraryis required for the(Geo)Arrow IPC File Format / Stream and(Geo)Parquet drivers.Specify install prefix in theCMAKE_PREFIX_PATH variable.

GDAL_USE_ARROW=ON/OFF

Control whether to use Arrow. Defaults to ON when Arrow is found.

ARROW_USE_STATIC_LIBRARIES=ON/OFF

Control whether to use statically built Arrow libraries. Defaults to OFF when Arrow is found.

basisu

TheBasis Universal <https://github.com/rouault/basis_universal/tree/cmake> libraryis required for theBASISU -- Basis Universal andKTX2 drivers.Specify install prefix in theCMAKE_PREFIX_PATH variable orbasisu_ROOT variable.

GDAL_USE_BASISU=ON/OFF

Control whether to use basisu. Defaults to ON when basisu is found.

Blosc

Blosc is a library which offersa meta-compression, with different backends (LZ4, Snappy, Zlib, Zstd, etc.).It is used by theZarr driver.

BLOSC_INCLUDE_DIR

Path to an include directory with theblosc.h header file.

BLOSC_LIBRARY

Path to a shared or static library file.

GDAL_USE_BLOSC=ON/OFF

Control whether to use Blosc. Defaults to ON when Blosc is found.

BRUNSLI

TheBrunsli JPEG repacking library, usedby theMRF -- Meta Raster Format driver.

BRUNSLI_INCLUDE_DIR

Path to an include directory with thebrunsli/decode.h andbrunsli\encode.h header files.

BRUNSLI_ENC_LIB

Path to the brunslienc-c library file.

BRUNSLI_DEC_LIB

Path to the brunslidec-c library file.

GDAL_USE_BRUNSLI=ON/OFF

Control whether to use BRUNSLI. Defaults to ON when Brunsli is found.

CFITSIO

TheC FITS I/O library is required for theFITS -- Flexible Image Transport System driver.It can be detected with pkg-config.

CFITSIO_INCLUDE_DIR

Path to an include directory with thefitsio.h header file.

CFITSIO_LIBRARY

Path to a shared or static library file.

GDAL_USE_CFITSIO=ON/OFF

Control whether to use CFITSIO. Defaults to ON when CFITSIO is found.

Crnlib

Crnlib / crunch isrequired for theDDS -- DirectDraw Surface driver.

Crnlib_INCLUDE_DIR

Path to Crnlib include directory withcrunch/crnlib.h header.

Crnlib_LIBRARY

Path to Crnlib library to be linked.

GDAL_USE_CRNLIB=ON/OFF

Control whether to use Crnlib. Defaults to ON when Crnlib is found.

CURL

libcurl is required for all network accesses (HTTP, etc.).

CURL_INCLUDE_DIR

Path to an include directory with thecurl directory.

CURL_LIBRARY_RELEASE

Path to a shared or static library file, such aslibcurl.so,libcurl.lib, or other name.

CURL_USE_STATIC_LIBS=ON/OFF

Added in version 3.7.1.

Must be set to ON when linking against a static build of Curl.

GDAL_USE_CURL=ON/OFF

Control whether to use Curl. Defaults to ON when Curl is found.

CryptoPP

TheCrypto++ library can be used for the RSA SHA256 signingfunctionality used by some authentication methods of Google Cloud. It might berequired to use theEEDAI - Google Earth Engine Data API Image images or use the/vsigs/ virtual filesystem.It is also required for the/vsicrypt/ virtual file system.

CRYPTOPP_INCLUDE_DIR

Path to the base include directory.

CRYPTOPP_LIBRARY_RELEASE

Path to a shared or static library file. A similar variableCRYPTOPP_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

CRYPTOPP_USE_ONLY_CRYPTODLL_ALG=ON/OFF

Defaults to OFF. Might be required to set to ON when linking againstcryptopp.dll

GDAL_USE_CRYPTOPP=ON/OFF

Control whether to use CryptoPP. Defaults to ON when CryptoPP is found.

Deflate

libdeflate is a compression librarywhich offers the lossless Deflate/Zip compression algorithm.It offers faster performance than ZLib, but is not a full replacement for it,consequently it must be used as a complement to ZLib.

Deflate_INCLUDE_DIR

Path to an include directory with thelibdeflate.h header file.

Deflate_LIBRARY_RELEASE

Path to a shared or static library file. A similar variableDeflate_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_USE_DEFLATE=ON/OFF

Control whether to use Deflate. Defaults to ON when Deflate is found.

ECW

The Hexagon ECW SDK (closed source/proprietary) is required for theECW -- Enhanced Compressed Wavelets (.ecw) driver.Currently only support for ECW SDK 3.3 and 5.5 is offered.

For ECW SDK 5.5, ECW_ROOT or CMAKE_PREFIX_PATH should point to the directoryinto which there are include and lib subdirectories, typicallyending with ERDAS-ECW_JPEG_2000_SDK-5.5.0/Desktop_Read-Only.

ECW_INCLUDE_DIR

Path to the include directory with theNCSECWClient.h header file.

ECW_LIBRARY

Path to library file libNCSEcw

ECWnet_LIBRARY

Path to library file libNCSCnet (only needed for SDK 3.3)

ECWC_LIBRARY

Path to library file libNCSEcwC (only needed for SDK 3.3)

NCSUtil_LIBRARY

Path to library file libNCSUtil (only needed for SDK 3.3)

GDAL_USE_ECW=ON/OFF

Control whether to use ECW. Defaults to ON when ECW is found.

EXPAT

Expat is a stream-oriented XML parserlibrary which is required to enable XML parsing capabilities in an importantnumber of OGR drivers (GML, GeoRSS, GPX, KML, LVBAG, OSM, ODS, SVG, WFS, XSLX, etc.).It is strongly recommended. Other driver such as ILI or GMLAS may also requirethe XercesC library.

EXPAT_INCLUDE_DIR

Path to the include directory with theexpat.h header file.

EXPAT_LIBRARY

Path to a shared or static library file.

EXPAT_USE_STATIC_LIBS=ON/OFF

Added in version 3.7.1.

Must be set to ON when linking against a static build of Expat.

GDAL_USE_EXPAT=ON/OFF

Control whether to use EXPAT. Defaults to ON when EXPAT is found.

ExprTk

ExprTk is amathematical expression parser and evaluation engine. It can be used by theVRT -- GDAL Virtual Format driver. Building with ExprTk may increase the size of theGDAL library by several megabytes.

GDAL_USE_EXPRTK=ON/OFF

Control whether to use ExprTk. Defaults to OFF even if ExprTk is found.

EXPRTK_INCLUDE_DIR

Path to the include directory with theexprtk.hpp header file.

FileGDB

TheFileGDB SDK (closed source/proprietary)is required for theESRI File Geodatabase (FileGDB) driver (not to be confused withtheESRI File Geodatabase vector (OpenFileGDB) driver that has no external requirements)

FileGDB_ROOT or CMAKE_PREFIX_PATH should point to the directory of the SDK.

FileGDB_INCLUDE_DIR

Path to the include directory with theFileGDBAPI.h header file.

FileGDB_LIBRARY

Path to library file

FileGDB_LIBRARY_RELEASE

Path to Release library file (only used on Windows)

FileGDB_LIBRARY_DEBUG

Path to Debug library file (only used on Windows)

GDAL_USE_FILEGDB=ON/OFF

Control whether to use FileGDB. Defaults to ON when FileGDB is found.

FreeXL

TheFreeXL library is requiredfor theXLS - MS Excel format driver.

FREEXL_INCLUDE_DIR

Path to an include directory with thefreexl.h header file.

FREEXL_LIBRARY

Path to a shared or static library file.

GDAL_USE_FREEXL=ON/OFF

Control whether to use FreeXL. Defaults to ON when FreeXL is found.

FYBA

TheOpenFyba libraries are needed to build theNorwegian SOSI Standard driver.

FYBA_INCLUDE_DIR

Path to an include directory with thefyba.h header file.

FYBA_FYBA_LIBRARY

Path to a library filefyba

FYBA_FYGM_LIBRARY

Path to a library filefygm

FYBA_FYUT_LIBRARY

Path to a library filefyut

GDAL_USE_FYBA=ON/OFF

Control whether to use FYBA. Defaults to ON when FYBA is found.

GEOTIFF

It is required for theGTiff -- GeoTIFF File Format drivers, and a few other drivers.If not found, an internal copy of libgeotiff can be used.

GEOTIFF_INCLUDE_DIR

Path to an include directory with the libgeotiff header files.

GEOTIFF_LIBRARY_RELEASE

Path to a shared or static library file, such aslibgeotiff.so,geotiff.lib, or other name. A similar variableGEOTIFF_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_USE_GEOTIFF=ON/OFF

Control whether to use external libgeotiff. Defaults to ON when external libgeotiff is found.

GDAL_USE_GEOTIFF_INTERNAL=ON/OFF

Control whether to use internal libgeotiff copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_GEOTIFF=ON

GEOS

GEOS is a C++ library for performing operationson two-dimensional vector geometries. It is used as the backend for most geometryprocessing operations available in OGR (intersection, buffer, etc.).Thegeos-config program can be used to detect it.

GEOS_INCLUDE_DIR

Path to an include directory with thegeos_c.h header file.

GEOS_LIBRARY

Path to a shared or static library file (libgeos_c).

GDAL_USE_GEOS=ON/OFF

Control whether to use GEOS. Defaults to ON when GEOS is found.

GIF

giflib is required for theGIF -- Graphics Interchange Format driver.If not found, an internal copy can be used.

GIF_INCLUDE_DIR

Path to an include directory with thegif_lib.h header file.

GIF_LIBRARY

Path to a shared or static library file.

GDAL_USE_GIF=ON/OFF

Control whether to use external giflib. Defaults to ON when external giflib is found.

GDAL_USE_GIF_INTERNAL=ON/OFF

Control whether to use internal giflib copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_GIF=ON

GTA

TheGTA library is required for theGTA - Generic Tagged Arrays driver.

GTA_INCLUDE_DIR

Path to an include directory with thegta/gta.h header file.

GTA_LIBRARY

Path to a shared or static library file.

GDAL_USE_GTA=ON/OFF

Control whether to use GTA. Defaults to ON when GTA is found.

HEIF

TheHEIF (>= 1.1) library used by theHEIF / HEIC -- ISO/IEC 23008-12 High Efficiency Image File Format driver.It can be detected with pkg-config.

HEIF_INCLUDE_DIR

Path to an include directory with thelibheif/heif.h header file.

HEIF_LIBRARY

Path to a shared or static library file.

GDAL_USE_HEIF=ON/OFF

Control whether to use HEIF. Defaults to ON when HEIF is found.

HDF4

TheHDF4 C library is neededfor theHDF4 -- Hierarchical Data Format Release 4 (HDF4) driver.

HDF4_INCLUDE_DIR

Path to an include directory with thehdf.h header file.

HDF4_df_LIBRARY_RELEASE

Path to a shared or staticdfalt ordf library file. A similar variableHDF4_df_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

HDF4_mfhdf_LIBRARY_RELEASE

Path to a shared or staticmfhdfalt ormfhdf library file. A similar variableHDF4_mfhdf_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

HDF4_xdr_LIBRARY_RELEASE

Path to a shared or staticxdr library file. A similar variableHDF4_xdr_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.It is generally not needed for Linux builds

HDF4_szip_LIBRARY_RELEASE

Path to a shared or staticszip library file. A similar variableHDF4_szip_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.It is generally not needed for Linux builds

HDF4_COMPONENTS

The value of this option is a list which defaults todf;mfhdf;xdr;szip.It may be customized if the linking of HDF4 require different libraries,in which case HDF4_{comp_name}_LIBRARY_[RELEASE/DEBUG] variables will beavailable to configure the library file.

GDAL_USE_HDF4=ON/OFF

Control whether to use HDF4. Defaults to ON when HDF4 is found.

HDF5

TheHDF5 C library is needed for theHDF5 -- Hierarchical Data Format Release 5 (HDF5) andBAG -- Bathymetry Attributed Grid drivers.The HDF5 CXX library is needed for theKEA driver.Thehttps://cmake.org/cmake/help/latest/module/FindHDF5.html module is used todetect the HDF5 library.

GDAL_USE_HDF5=ON/OFF

Control whether to use HDF5. Defaults to ON when HDF5 is found.

GDAL_ENABLE_HDF5_GLOBAL_LOCK=ON/OFF

Control whether to add a global lock around calls to HDF5 library. This isneeded if the HDF5 library is not built with thread-safety enabled and ifthe HDF5 driver is used in a multi-threaded way. On Unix, a heuristicstry to detect if the HDF5 library has been built with thread-safety enabledwhen linking against a HDF5 library. In other situations, the setting mustbe manually set when needed.

HDFS

TheHadoop File System native library is neededfor the/vsihdfs/ virtual file system.

HDFS_INCLUDE_DIR

Path to an include directory with thehdfs.h header file.

HDFS_LIBRARY

Path to a shared or statichdfs library file.

GDAL_USE_HDFS=ON/OFF

Control whether to use HDFS. Defaults to ON when HDFS is found.

Iconv

TheIconv library is used to converttext from one encoding to another encoding.It is generally available as a system library for Unix-like systems. On Windows,GDAL can leverage the API of the operating system for a few base conversions,but using Iconv will provide additional capabilities.

Iconv_INCLUDE_DIR

Path to an include directory with theiconv.h header file.

Iconv_LIBRARY

Path to a shared or static library file.

GDAL_USE_ICONV=ON/OFF

Control whether to use Iconv. Defaults to ON when Iconv is found.

IDB

The Informix DataBase Client SDK (closed source/proprietary) is needed to buildtheIDB driver.IDB_ROOT or CMAKE_PREFIX_PATH should point to the directory of the SDK.

IDB_INCLUDE_DIR

Path to an include directory (typically ending withincl) with thec++/it.h header file.

IDB_IFCPP_LIBRARY

Path to a library fileifc++ (typically in thelib/c++ sub directory)

IDB_IFDMI_LIBRARY

Path to a library fileifdmi (typically in thelib/dmi sub directory)

IDB_IFSQL_LIBRARY

Path to a library fileifsql (typically in thelib/esql sub directory)

IDB_IFCLI_LIBRARY

Path to a library fileifcli (typically in thelib/cli sub directory)

GDAL_USE_IDB=ON/OFF

Control whether to use IDB. Defaults to ON when IDB is found.

JPEG

libjpeg is required for theJPEG -- JPEG JFIF File Format driver, and may be used by a fewother drivers (GPKG -- GeoPackage raster,MRF -- Meta Raster Format, internal libtiff, etc.)If not found, an internal copy of libjpeg (6b) can be used.Usinglibjpeg-turbo is highlyrecommended to get best performance.Seehttps://cmake.org/cmake/help/latest/module/FindJPEG.html for more detailson how the library is detected.

JPEG_INCLUDE_DIR

Path to an include directory with thejpeglib.h header file.

JPEG_LIBRARY_RELEASE

Path to a shared or static library file. A similar variableJPEG_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_USE_JPEG=ON/OFF

Control whether to use external libjpeg. Defaults to ON when external libjpeg is found.

GDAL_USE_JPEG_INTERNAL=ON/OFF

Control whether to use internal libjpeg copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_JPEG=ON

EXPECTED_JPEG_LIB_VERSION=number

Used with external libjpeg. number is for example 80, for libjpeg 8 ABI.This can be used to check a build time that the expected JPEG library isthe one that is included by GDAL.

JPEG12

libjpeg-12 bit can be used by theJPEG -- JPEG JFIF File Format,GTiff -- GeoTIFF File Format (when using internal libtiff),JPEG -- JPEG JFIF File Format,MRF -- Meta Raster Format andNITF -- National Imagery Transmission Format drivers to handleJPEG images with a 12 bit depth. It is only supported with the internal libjpeg (6b).This can be used independently of if for regular 8 bit JPEG an external or internallibjpeg is used.

GDAL_USE_JPEG12_INTERNAL=ON/OFF

Control whether to use internal libjpeg-12 copy. Defaults to ON.

JSON-C

Thejson-c library is required to read andwrite JSON content.It can be detected with pkg-config.If not found, an internal copy of json-c can be used.

JSONC_INCLUDE_DIR

Path to an include directory with thejson.h header file.

JSONC_LIBRARY

Path to a shared or static library file.

GDAL_USE_JSONC=ON/OFF

Control whether to use JSON-C. Defaults to ON when JSON-C is found.

GDAL_USE_JSONC_INTERNAL=ON/OFF

Control whether to use internal JSON-C copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_JSONC=ON

JXL

Thelibjxl <https://github.com/libjxl/libjxl> library used by theGTiff -- GeoTIFF File Format driver, when built against internal libtiff.It can be detected with pkg-config.

JXL_INCLUDE_DIR

Path to an include directory with thejxl/decode.h header file.

JXL_LIBRARY

Path to a shared or static library file.

GDAL_USE_JXL=ON/OFF

Control whether to use JXL. Defaults to ON when JXL is found.

KDU

The Kakadu library (proprietary) is required for theJP2KAK -- JPEG 2000 (based on Kakadu SDK) andJPIPKAK - JPIP Streaming drivers.There is no standardized installation layout, nor fixed library file names, so findingKakadu artifacts is a bit challenging. Currently automatic finding of it fromthe KDU_ROOT variable is only implemented for Linux, Mac and Windows x86_64builds. For other platforms, users need to manually specify the KDU_LIBRARYand KDU_AUX_LIBRARY variable.

KDU_INCLUDE_DIR

Path to the root of the Kakadu build tree, from which thecoresys/common/kdu_elementary.h header file should be found.

KDU_LIBRARY

Path to a shared library file whose name is like libkdu_vXYR.so on Unixor kdu_vXYR.lib on Windows, where X.Y is the Kakadu version.

KDU_AUX_LIBRARY

Path to a shared library file whose name is like libkdu_aXYR.so on Unixor kdu_aXYR.lib on Windows, where X.Y is the Kakadu version.

GDAL_USE_KDU=ON/OFF

Control whether to use KDU. Defaults to ON when KDU is found.

KEA

TheKEA library is required for theKEAdriver. The HDF5 CXX library is also required.

KEA_INCLUDE_DIR

Path to an include directory with thelibkea/KEACommon.h header file.

KEA_LIBRARY

Path to a shared or static library file.

GDAL_USE_KEA=ON/OFF

Control whether to use KEA. Defaults to ON when KEA is found.

LERC

LERC is an open-source image or raster formatwhich supports rapid encoding and decoding for any pixel type (not just RGB or Byte).Users set the maximum compression error per pixel while encoding, so the precisionof the original input image is preserved (within user defined error bounds).

LERC_INCLUDE_DIR

Path to an include directory with theLerc_c_api.h header file.

LERC_LIBRARY

Path to a shared or static library file.

GDAL_USE_LERC=ON/OFF

Control whether to use LERC. Defaults to ON when LERC is found.

GDAL_USE_LERC_INTERNAL=ON/OFF

Control whether to use the LERC internal library. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_LERC=ON

LIBAEC

libaec is a compression library which offersthe extended Golomb-Rice coding as defined in the CCSDS recommended standard 121.0-B-3.It is used by theGRIB -- WMO General Regularly-distributed Information in Binary form driver.

LIBAEC_INCLUDE_DIR

Path to an include directory with thelibaec.h header file.

LIBAEC_LIBRARY

Path to a shared or static library file.

GDAL_USE_LIBAEC=ON/OFF

Control whether to use LIBAEC. Defaults to ON when LIBAEC is found.

LibKML

LibKML is required for theLIBKML Driver (.kml .kmz) driver.It can be detected with pkg-config.

LIBKML_INCLUDE_DIR

Path to the base include directory.

LIBKML_BASE_LIBRARY

Path to a shared or static library file forkmlbase

LIBKML_DOM_LIBRARY

Path to a shared or static library file forkmldom

LIBKML_ENGINE_LIBRARY

Path to a shared or static library file forkmlengine

LIBKML_MINIZIP_LIBRARY

Path to a shared or static library file forminizip

LIBKML_URIPARSER_LIBRARY

Path to a shared or static library file foruriparser

GDAL_USE_LIBKML=ON/OFF

Control whether to use LibKML. Defaults to ON when LibKML is found.

LibLZMA

LibLZMA is a compression library which offersthe lossless LZMA2 compression algorithm.It is used by the internal libtiff library or theZarr driver.

LIBLZMA_INCLUDE_DIR

Path to an include directory with thelzma.h header file.

LIBLZMA_LIBRARY

Path to a shared or static library file.

GDAL_USE_LIBLZMA=ON/OFF

Control whether to use LibLZMA. Defaults to ON when LibLZMA is found.

libOpenDRIVE

libOpenDRIVE in version >= 0.6.0 is required for theXODR -- OpenDRIVE Road Description Format driver.

OpenDrive_DIR

Path to libOpenDRIVE CMake configuration directory<installDir>/cmake/. Thecmake/ path is usually automatically created when installing libOpenDRIVE and contains the necessary configuration files for inclusion into other project builds.

GDAL_USE_OPENDRIVE=ON/OFF

Control whether to use libOpenDRIVE. Defaults to ON when libOpenDRIVE is found.

LibQB3

TheQB3 compression, usedby theMRF -- Meta Raster Format driver.

GDAL_USE_LIBQB3=ON/OFF

Control whether to use LibQB3. Defaults to ON when LibQB3 is found.

LibXml2

TheLibXml2 processing library is used to do validation of XML files againsta XML Schema (.xsd) in a few drivers (PDF, GMLAS, GML OGR VRT) and for advancedcapabilities in GMLJP2v2 generation.

LIBXML2_INCLUDE_DIR

Path to the base include directory.

LIBXML2_LIBRARY

Path to a shared or static library file.

GDAL_USE_LIBXML2=ON/OFF

Control whether to use LibXml2. Defaults to ON when LibXml2 is found.

LZ4

LZ4 is a compression library which offersthe lossless LZ4 compression algorithm.It is used by theZarr driver.

LZ4_INCLUDE_DIR

Path to an include directory with thelz4.h header file.

LZ4_LIBRARY_RELEASE

Path to a shared or static library file. A similar variableLZ4_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_USE_LZ4=ON/OFF

Control whether to use LZ4. Defaults to ON when LZ4 is found.

MONGOCXX

TheMongoCXX and BsonCXX librariesare needed to build theMongoDBv3 driver.They can be detected with pkg-config.

MONGOCXX_INCLUDE_DIR

Path to an include directory with themongocxx/client.hpp header file.

BSONCXX_INCLUDE_DIR

Path to an include directory with thebsoncxx/config/version.hpp header file.

MONGOCXX_LIBRARY

Path to a library filemongocxx

BSONCXX_LIBRARY

Path to a library filebsoncxx

GDAL_USE_MONGOCXX=ON/OFF

Control whether to use MONGOCXX. Defaults to ON when MONGOCXX is found.

MRSID

The MRSID Raster DSDK (closed source/proprietary) is required for theMrSID -- Multi-resolution Seamless Image Database driver.

MRSID_ROOT or CMAKE_PREFIX_PATH should point to the directory of the SDK ending withRaster_DSDK. Note that on Linux, its lib subdirectory should be in theLD_LIBRARY_PATH so that the linking of applications succeeds and libtbb.so canbe found.

MRSID_INCLUDE_DIR

Path to the include directory with thelt_base.h header file.

MRSID_LIBRARY

Path to library file libltidsdk

GDAL_ENABLE_DRIVER_JP2MRSID

Whether to enable JPEG2000 support through the MrSID SDK. The default valueof this option is OFF.

GDAL_USE_MRSID=ON/OFF

Control whether to use MRSID. Defaults to ON when MRSID is found.

MSSQL_NCLI

The Microsoft SQL Native Client Library (closed source/proprietary) is requiredto enable bulk copy in theMSSQLSpatial - Microsoft SQL Server Spatial Database driver.If both MSSQL_NCLI and MSSQL_ODBC are found and enabled, MSSQL_ODBC will be used.The library is normally found if installed in standard location, and at version 11.

MSSQL_NCLI_VERSION

Major version of the Native Client, typically 11

MSSQL_NCLI_INCLUDE_DIR

Path to include directory withsqlncli.h header.

MSSQL_NCLI_LIBRARY

Path to library to be linked.

GDAL_USE_MSSQL_NCLI=ON/OFF

Control whether to use MSSQL_NCLI. Defaults to ON when MSSQL_NCLI is found.

MSSQL_ODBC

The Microsoft SQL Native ODBC driver Library (closed source/proprietary) is requiredto enable bulk copy in theMSSQLSpatial - Microsoft SQL Server Spatial Database driver.If both MSSQL_NCLI and MSSQL_ODBC are found and enabled, MSSQL_ODBC will be used.The library is normally found if installed in standard location, and at version 17.

MSSQL_ODBC_VERSION

Major version of the Native Client, typically 17

MSSQL_ODBC_INCLUDE_DIR

Path to include directory withmsodbcsql.h header.

MSSQL_ODBC_LIBRARY

Path to library to be linked.

GDAL_USE_MSSQL_ODBC=ON/OFF

Control whether to use MSSQL_ODBC. Defaults to ON when MSSQL_ODBC is found.

muparser

muparser is a mathematical expressionparser and evaluation engine. It can be used by theVRT -- GDAL Virtual Format driver.

GDAL_USE_MUPARSER=ON/OFF

Control whether to use muparser. Defaults to ON when muparser is found.

MUPARSER_INCLUDE_DIR

Path to directory with muparser headers.

MUPARSER_LIBRARY

Path to library to be linked.

MYSQL

The MySQL or MariaDB client library is required to enable theMySQLdriver.

MYSQL_INCLUDE_DIR

Path to include directory withmysql.h header file.

MYSQL_LIBRARY

Path to library to be linked.

GDAL_USE_MYSQL=ON/OFF

Control whether to use MYSQL. Defaults to ON when MYSQL is found.

NetCDF

ThenetCDF is required to enable theNetCDF: Network Common Data Form driver.Thenc-config program can be used to detect it.

NETCDF_INCLUDE_DIR

Path to an include directory with thenetcdf.h header file.

NETCDF_LIBRARY

Path to a shared or static library file.

GDAL_USE_NETCDF=ON/OFF

Control whether to use netCDF. Defaults to ON when netCDF is found.

ODBC

ODBC is required for various drivers:ODBC RDBMS,ESRI Personal GeoDatabase,SAP HANA andMSSQLSpatial - Microsoft SQL Server Spatial Database.It is normally automatically found in system directories on Unix and Windows.

ODBC_INCLUDE_DIR

Path to ODBC include directory withsql.h header.

ODBC_LIBRARY

Path to ODBC library to be linked.

GDAL_USE_ODBC=ON/OFF

Control whether to use ODBC. Defaults to ON when ODBC is found.

ODBC-CPP

Theodbc-cpp-wrapper library is required fortheSAP HANA driver.

ODBCCPP_INCLUDE_DIR

Path to an include directory with theodbc/Environment.h header file.

ODBCCPP_LIBRARY

Path to a shared or static library file.

GDAL_USE_ODBCCPP=ON/OFF

Control whether to use ODBC-CPP. Defaults to ON when ODBC-CPP is found.

OpenCAD

libopencad is required for theCAD -- AutoCAD DWGdriver. If not found, an internal copy can be used.

OPENCAD_INCLUDE_DIR

Path to an include directory with theopencad.h header file.

OPENCAD_LIBRARY

Path to a shared or static library file.

GDAL_USE_OPENCAD=ON/OFF

Control whether to use external libopencad. Defaults to ON when external libopencad is found.

GDAL_USE_OPENCAD_INTERNAL=ON/OFF

Control whether to use internal libopencad copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_OPENCAD=ON

OpenEXR

OpenEXR is required for theEXR -- Extended Dynamic Range Image File Format driver

SpecifyOpenEXR_ROOT variable pointing to the parent directory of/lib and /include subdirectories, i.e. /DEV/lib/openexr-3.0.For OpenEXR >= 3 additionally specifyImath_ROOT as this is aseparate library now, i.e. /DEV/lib/imath-3.1.3

or

Specify root directory adding to theCMAKE_PREFIX_PATH variable to find OpenEXR's pkgconfig.For example -DCMAKE_PREFIX_PATH=/DEV/lib/openexr-3.0;/DEV/lib/imath-3.1.3

or

Get real specific and setOpenEXR_INCLUDE_DIR,Imath_INCLUDE_DIR,OpenEXR_LIBRARY,OpenEXR_UTIL_LIBRARY,OpenEXR_HALF_LIBRARY,OpenEXR_IEX_LIBRARYexplicitly

GDAL_USE_OPENEXR=ON/OFF

Control whether to use OpenEXR. Defaults to ON when OpenEXR is found.

OpenJPEG

TheOpenJPEG library is an open-sourceJPEG-2000 codec written in C language. It is required for theJP2OpenJPEG -- JPEG2000 driver based on OpenJPEG library driver, or other drivers that use JPEG-2000 functionality.

OPENJPEG_INCLUDE_DIR

Path to an include directory with theopenjpeg.h header file.

OPENJPEG_LIBRARY

Path to a shared or static library file.

GDAL_USE_OPENJPEG=ON/OFF

Control whether to use OpenJPEG. Defaults to ON when OpenJPEG is found.

GDAL_FIND_PACKAGE_OpenJPEG_MODE=MODULE/CONFIG/emptystring

Added in version 3.9.

Control the mode used for find_package(OpenJPEG). Defaults to MODULEfor compatibility with OpenJPEG < 2.5.1. If set to CONFIG, only Config modesearch is attempted. If set to empty string, default CMake logic(https://cmake.org/cmake/help/latest/command/find_package.html) applies.

OpenSSL

The Crypto component of theOpenSSL librarycan be used for the RSA SHA256 signing functionality used by some authenticationmethods of Google Cloud. It might be required to use theEEDAI - Google Earth Engine Data API Imageimages or use the/vsigs/ virtual file system.

Seehttps://cmake.org/cmake/help/latest/module/FindOpenSSL.html for details onhow to configure the library. For static linking, the following options maybe needed: -DOPENSSL_USE_STATIC_LIBS=TRUE -DOPENSSL_MSVC_STATIC_RT=TRUE

GDAL_USE_OPENSSL=ON/OFF

Control whether to use OpenSSL. Defaults to ON when OpenSSL is found.

Oracle

The Oracle Instant Client SDK (closed source/proprietary) is required for theOracle Spatial and theOracle Spatial GeoRaster drivers

Oracle_ROOT

Path to the root directory of the Oracle Instant Client SDK.

GDAL_USE_ORACLE=ON/OFF

Control whether to use Oracle. Defaults to ON when Oracle is found.

Parquet

The Parquet component of theApache Arrow C++ <https://github.com/apache/arrow/tree/master/cpp>library is required for the(Geo)Parquet driver.Specify install prefix in theCMAKE_PREFIX_PATH variable.

GDAL_USE_PARQUET=ON/OFF

Control whether to use Parquet. Defaults to ON when Parquet is found.

ARROW_USE_STATIC_LIBRARIES=ON/OFF

Control whether to use statically built Arrow libraries. Defaults to OFF when Parquet is found.

PCRE2

PCRE2 implements Perl-compatibleRegular Expressions support. It is used for the REGEXP operator in drivers using SQLite3.

PCRE2_INCLUDE_DIR

Path to an include directory with thepcre2.h header file.

PCRE2_LIBRARY

Path to a shared or static library file with "pcre2-8" in its name.

GDAL_USE_PCRE2=ON/OFF

Control whether to use PCRE2. Defaults to ON when PCRE2 is found.

PDFIUM

ThePDFium library is oneof the possible backends for thePDF -- Geospatial PDF driver.

PDFIUM_INCLUDE_DIR

Path to an include directory with thepublic/fpdfview.h header file.

PDFIUM_LIBRARY

Path to a shared or static library file.

GDAL_USE_PDFIUM=ON/OFF

Control whether to use PDFIUM. Defaults to ON when PDFIUM is found.

PNG

libpng is required for thePNG -- Portable Network Graphicsdriver, and may be used by a few other drivers (GRIB -- WMO General Regularly-distributed Information in Binary form,GPKG -- GeoPackage raster, etc.)If not found, an internal copy of libpng can be used.Seehttps://cmake.org/cmake/help/latest/module/FindPNG.html for more detailson how the library is detected.

PNG_PNG_INCLUDE_DIR

Path to an include directory with thepng.h header file.

PNG_LIBRARY_RELEASE

Path to a shared or static library file. A similar variablePNG_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_USE_PNG=ON/OFF

Control whether to use external libpng. Defaults to ON when external libpng is found.

GDAL_USE_PNG_INTERNAL=ON/OFF

Control whether to use internal libpng copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_PNG=ON

Poppler

ThePoppler library is oneof the possible backends for thePDF -- Geospatial PDF driver.

Note that GDAL requires Poppler private headers, that are only installedif configuring Poppler with -DENABLE_UNSTABLE_API_ABI_HEADERS.

Poppler_INCLUDE_DIR

Path to an include directory with thepoppler-config.h header file.

Poppler_LIBRARY

Path to a shared or static library file.

GDAL_USE_POPPLER=ON/OFF

Control whether to use Poppler. Defaults to ON when Poppler is found.

PostgreSQL

ThePostgreSQL client library is required forthePostgreSQL / PostGIS andPostGISRaster -- PostGIS Raster driver drivers.

PostgreSQL_INCLUDE_DIR

Path to an include directory with thelibpq-fe.h header file.

PostgreSQL_LIBRARY_RELEASE

Path to a shared or static library filepq /libpq. A similar variablePostgreSQL_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_USE_POSTGRESQL=ON/OFF

Control whether to use PostgreSQL. Defaults to ON when PostgreSQL is found.

PROJ

PROJ >= 6.3 is arequired dependency for GDAL.

PROJ_INCLUDE_DIR

Path to an include directory with theproj.h header file.

PROJ_LIBRARY_RELEASE

Path to a shared or static library file, such aslibproj.so,proj.lib, or other name. A similar variablePROJ_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_FIND_PACKAGE_PROJ_MODE=CUSTOM/MODULE/CONFIG/emptystring

Added in version 3.9.

Control the mode used for find_package(PROJ).Alters how the default CMake search logic(https://cmake.org/cmake/help/latest/command/find_package.html) applies.Defaults to CUSTOM, where the CONFIG mode is applied for PROJ >= 8, andfallbacks to default MODULE mode otherwise.Other values are passed directly to find_package()

QHULL

TheQHULL library is used for the linearinterpolation of gdal_grid. If not found, an internal copy can be used.

QHULL_PACKAGE_NAME

Name of the pkg-config package, typicallyqhull_r orqhullstatic_r. Defaults toqhull_r

QHULL_INCLUDE_DIR

Path to an include directory with thelibqhull_r/libqhull_r.h header file.

QHULL_LIBRARY

Path to a shared or static library file to the reentrant library.

GDAL_USE_QHULL=ON/OFF

Control whether to use QHULL. Defaults to ON when QHULL is found.

GDAL_USE_QHULL_INTERNAL=ON/OFF

Control whether to use internal QHULL copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_QHULL=ON

RASTERLITE2

TheRasterLite2 (>= 1.1.0)library used by theRasterLite2 - Rasters in SQLite DB driver.It can be detected with pkg-config.

RASTERLITE2_INCLUDE_DIR

Path to an include directory with therasterlite2/rasterlite2.h header file.

RASTERLITE2_LIBRARY

Path to a shared or static library file.

GDAL_USE_RASTERLITE2=ON/OFF

Control whether to use RasterLite2. Defaults to ON when RasterLite2 is found.

SPATIALITE

TheSpatialite libraryused by theSQLite / Spatialite RDBMS andGPKG -- GeoPackage vector drivers, and theSQL SQLite dialect.It can be detected with pkg-config.

SPATIALITE_INCLUDE_DIR

Path to an include directory with thespatialite.h header file.

SPATIALITE_LIBRARY

Path to a shared or static library file.

GDAL_USE_SPATIALITE=ON/OFF

Control whether to use Spatialite. Defaults to ON when Spatialite is found.

SQLite3

TheSQLite3 library is required for theSQLite / Spatialite RDBMS andGPKG -- GeoPackage vector drivers (and also used by other drivers),and theSQL SQLite dialect.

SQLite3_INCLUDE_DIR

Path to an include directory with thesqlite3.h header file.

SQLite3_LIBRARY

Path to a shared or static library file, such aslibsqlite3.so,sqlite3.lib or other name.

GDAL_USE_SQLITE3=ON/OFF

Control whether to use SQLite3. Defaults to ON when SQLite3 is found.

SFCGAL

SFCGAL is a geometry library whichsupports ISO 19107:2013 and OGC Simple Features Access 1.2 for 3D operations(PolyhedralSurface, TINs, ...)

SFCGAL_INCLUDE_DIR

Path to the base include directory.

SFCGAL_LIBRARY_RELEASE

Path to a shared or static library file. A similar variableSFCGAL_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_USE_SFCGAL=ON/OFF

Control whether to use SFCGAL. Defaults to ON when SFCGAL is found.

SWIG

SWIG is a software development tool that connectsprograms written in C and C++ with a variety of high-level programming languages.It is used for the Python, Java and CSharp bindings.

SWIG_EXECUTABLE

Path to the SWIG executable.

Note that setting it explicitly might be needed, and that putting thedirectory of the installed binary into the PATH might not be sufficient.The reason is that when building from source, a "swig" binary will begenerated, but FindSWIG will prefer a "swig-4.0" binary if found elsewherein the PATH.

TEIGHA

The TEIGHA / Open Design Alliance libraries (closed source/proprietary) arerequired for theAutoCAD DWG andMicrostation DGN v8 drivers.Note that on Linux, with a SDK consisting of shared libraries,the bin/{platform_name} subdirectory of the SDK should be in the LD_LIBRARY_PATHso that the linking of applications succeeds.The TEIGHA_ROOT variable must be set.

TEIGHA_ROOT

Path to the base directory where the Kernel and Drawings package must beextracted.

TEIGHA_ACTIVATION_FILE_DIRECTORY

Path to a directory where aOdActivationInfo file is located. If thefile is somewhere under TEIGHA_ROOT, it will be automatically discovered.Otherwise this variable must be set for recent SDK versions (at least with2021 and later).

GDAL_USE_TEIGHA=ON/OFF

Control whether to use TEIGHA. Defaults to ON when TEIGHA is found.

TIFF

libtiff is required for theGTiff -- GeoTIFF File Format drivers, and a few other drivers.If not found, an internal copy of libtiff can be used.

TIFF_INCLUDE_DIR

Path to an include directory with thetiff.h header file.

TIFF_LIBRARY_RELEASE

Path to a shared or static library file, such aslibtiff.so,tiff.lib, or other name. A similar variableTIFF_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

GDAL_USE_TIFF=ON/OFF

Control whether to use external libtiff. Defaults to ON when external libtiff is found.

GDAL_USE_TIFF_INTERNAL=ON/OFF

Control whether to use internal libtiff copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_TIFF=ON

TileDB

TheTileDB <https://github.com/TileDB-Inc/TileDB> library is required for theTileDB - TileDB raster driver.Specify install prefix in theCMAKE_PREFIX_PATH variable.

TileDB >= 2.15 is required since GDAL 3.9

GDAL_USE_TILEDB=ON/OFF

Control whether to use TileDB. Defaults to ON when TileDB is found.

WebP

WebP is a image compression library.It is required for theWEBP - WEBP driver, and may be used by theGPKG -- GeoPackage raster and the internal libtiff library.

WEBP_INCLUDE_DIR

Path to an include directory with thewebp/encode.h header file.

WEBP_LIBRARY

Path to a shared or static library file.

GDAL_USE_WEBP=ON/OFF

Control whether to use WebP. Defaults to ON when WebP is found.

XercesC

Xerces-C is a stream-oriented XML parserlibrary which is required to enable XML parsing capabilities in theNAS - ALKIS,"INTERLIS 1" and "INTERLIS 2" drivers andGMLAS - Geography Markup Language (GML) driven by application schemas drivers.It can also be used as an alternative to Expat for the GML driver.

XercesC_INCLUDE_DIR

Path to the base include directory.

XercesC_LIBRARY

Path to a shared or static library file.

GDAL_USE_XERCESC=ON/OFF

Control whether to use XercesC. Defaults to ON when XercesC is found.

ZLIB

ZLib is a compression library which offersthe lossless Deflate/Zip compression algorithm.

ZLIB_INCLUDE_DIR

Path to an include directory with thezlib.h header file.

ZLIB_LIBRARY_RELEASE

Path to a shared or static library file. A similar variableZLIB_LIBRARY_DEBUG can also be specified to a similar library forbuilding Debug releases.

ZLIB_IS_STATIC

Link to static external ZLIB directory.Only used if GDAL_USE_ZLIB_INTERNAL=OFF and MSVC.

GDAL_USE_ZLIB=ON/OFF

Control whether to use ZLIB. Defaults to ON when ZLIB is found.

GDAL_USE_ZLIB_INTERNAL=ON/OFF

Control whether to use internal zlib copy. Defaults depends on GDAL_USE_INTERNAL_LIBS. When setto ON, has precedence over GDAL_USE_ZLIB=ON

ZSTD

ZSTD is a compression library which offersthe lossless ZStd compression algorithm (faster than Deflate/ZIP, but incompatiblewith it). It is used by the internal libtiff library or theZarr driver.

ZSTD_INCLUDE_DIR

Path to an include directory with thezstd.h header file.

ZSTD_LIBRARY

Path to a shared or static library file.

GDAL_USE_ZSTD=ON/OFF

Control whether to use ZSTD. Defaults to ON when ZSTD is found.

How do I get PROJ ?

PROJ is the only required build-time dependency of GDAL that is not vendorizedin the GDAL source code tree. Consequently, the PROJ header and library must be availablewhen configuring GDAL's CMake. ConsultPROJ installation.

Conflicting PROJ libraries

If using a custom PROJ build (that is a PROJ build that does not come froma distribution channel), it can sometimes happen that this custom PROJ buildconflicts with packaged dependencies, such as spatialite or libgeotiff, thatthemselves link to another copy of PROJ.

The clean way to solve this is to rebuild from sources those other librariesagainst the custom PROJ build.For Linux based systems, given that C API/ABI has been preserved in thePROJ 6, 7, 8, 9 series, if the custom PROJ build is more recent than thePROJ used by those other libraries, doing aliases of the olderlibproj.so.XXname to the newerlibproj.so.YY (withln-s) should work, although it isdefinitely not recommended to use this solution in a production environment.

In any case, iflddlibgdal.so|greplibproj reports more than one line,crashes will occur at runtime (often at process termination with amalloc_consolidate():invalidchunksize and/orAborted(coredumped) error message)