Skip to content

Files

This branch is 336 commits behind libgd/libgd:master.

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Aug 20, 2021
Aug 20, 2021
Mar 22, 2020
Jun 22, 2018
Jun 28, 2013
Mar 22, 2020
Aug 24, 2021
Sep 8, 2018
Aug 21, 2021
Jun 22, 2018
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

To build GD using CMake, all you need is (add the cmake options if you need any
or if the default libs and include paths are not the default) :

In a sub directory of the top level:
$ mkdir bld
$ cd bld
$ cmake -DBUILD_TEST=1 <options> ..
$ make

The available options are:
ENABLE_GD_FORMATS=1
ENABLE_PNG=1
ENABLE_LIQ=1
ENABLE_JPEG=1
ENABLE_TIFF=1
ENABLE_ICONV=1
ENABLE_FREETYPE=1
ENABLE_FONTCONFIG=1
ENABLE_XPM=1
ENABLE_WEBP=1
ENABLE_AVIF=1
ENABLE_RAQM=1

You can optionally run our tests suite using:
$ ctest .

Or if you like to build in the source tree:
$ cmake -DBUILD_TEST=1 .
$ make
$ ctest .

Add "-DCMAKE_BUILD_TYPE=DEBUG" if you like to have a debug version.

To install, just run:
$ make install
Or to to install to a different path:
$ make install DESTDIR=/some/other/place

Typical usage with only PNG enabled:

This command generates VS7 project files and add some custom libraries and
includes directories (libpng in this case):

cmake -DCMAKE_GENERATOR="Visual Studio 7 .NET 2003"
 -DENABLE_PNG=1 -DCMAKE_LIBRARY_PATH=c:\gd_build\gd_deps\lib 
 -DCMAKE_INCLUDE_PATH=c:\gd_build\gd_deps\include c:\libgd_src

A typical CMake call to build using the MinGW tools:

cmake -G"MinGW Makefiles" -DCMAKE_LIBRARY_PATH=c:\mingw\lib -DCMAKE_INCLUDE_PATH=c:\MinGW\include -DENABLE_JPEG=On -DBUILD_TEST=On -DCMAKE_RELEASE_TYPE=DEBUG ..\libgd_head

Given that your MinGW install is under c:\mingw and that you install all libraries using the /usr prefix

vcpkg support add dependencies and library on Windows (or Linux/Mac/etc)
------------------------------------------------------------------------

Inside the development console, in the desired mode (see https://docs.microsoft.com/en-us/cpp/build/building-on-the-command-line?view=msvc-160), to install 
the required libraries, vcpkg can install them automatically. The steps are:

1. Install vcpkg, see https://vcpkg.io/en/getting-started.html
2. Choose the vcpkg architecture
   SET VCPKG_DEFAULT_TRIPLET="x64-windows" (or add pkgname:x64-windows)
3. install the dependencies needed for the build. F.e.
   C:\vcpkg\vcpkg.exe install libpng libjpeg-turbo freetype tiff libheif libwebp
4. add  -DCMAKE_TOOLCHAIN_FILE=[path to c:\path\to\vcpkg]\scripts\buildsystems\vcpkg.cmake
   with the other desired cmake options

It is then not needed to manually add CMAKE_INCLUDE_PATH or CMAKE_LIBRARY_PATH as options.

See the https://vcpkg.io for more informations about vcpkg and how to customize an install.