60 lines
3.1 KiB
Markdown
60 lines
3.1 KiB
Markdown
# GD Graphics (Draw) Library
|
|
|
|
[![Build Status](https://travis-ci.org/libgd/libgd.svg?branch=master)](https://travis-ci.org/libgd/libgd)
|
|
[![Build Status](https://scan.coverity.com/projects/3810/badge.svg)](https://scan.coverity.com/projects/libgd)
|
|
[![Chat](https://badges.gitter.im/libgd/libgd.svg)](https://gitter.im/libgd/libgd)
|
|
[![codecov.io](https://codecov.io/github/libgd/libgd/coverage.svg?branch=master)](https://codecov.io/github/libgd/libgd/)
|
|
|
|
GD is an open source code library for the dynamic creation of images by
|
|
programmers.
|
|
|
|
GD is written in C, and "wrappers" are available for Perl, PHP and other
|
|
languages. GD can read and write many different image formats. GD is commonly
|
|
used to generate charts, graphics, thumbnails, and most anything else, on the
|
|
fly.
|
|
|
|
The most common applications of GD involve website development, although it
|
|
can be used with any standalone application!
|
|
|
|
The library was originally developed by Thomas Boutell and is now maintained
|
|
by many contributors (see the [CONTRIBUTORS](CONTRIBUTORS) file) under the
|
|
umbrella of PHP.net.
|
|
|
|
If you like to contribute, report bugs, see [how to contribute document](CONTRIBUTING.md)
|
|
|
|
For security related issues, please contact us at security@libgd.org
|
|
|
|
## Downloads/etc...
|
|
|
|
Please visit our [homepage](http://www.libgd.org/) for more details.
|
|
|
|
## Supported Image Formats
|
|
|
|
GD has builtin support for:
|
|
|
|
* [BMP](https://en.wikipedia.org/wiki/BMP_file_format)
|
|
* [GIF](https://en.wikipedia.org/wiki/GIF)
|
|
* [TGA](https://en.wikipedia.org/wiki/Truevision_TGA)
|
|
* [WBMP](https://en.wikipedia.org/wiki/Wireless_Application_Protocol_Bitmap_Format)
|
|
|
|
It also has optional support for more formats via external libraries:
|
|
|
|
* [AVIF](https://en.wikipedia.org/wiki/AV1#AV1_Image_File_Format_(AVIF)) via [libavif](https://github.com/AOMediaCodec/libavif)
|
|
* [HEIF](https://en.wikipedia.org/wiki/High_Efficiency_Image_File_Format) via [libheif](https://github.com/strukturag/libheif/)
|
|
* This includes [AVIF](https://en.wikipedia.org/wiki/AV1#AV1_Image_File_Format_%28AVIF%29) read support if your system's `libheif` has AV1 decoding.
|
|
* [JPEG](https://en.wikipedia.org/wiki/JPEG) via [IJG/libjpeg](http://www.ijg.org/) or [libjpeg-turbo](http://libjpeg-turbo.virtualgl.org/)
|
|
* Does not include [JPEG 2000](https://en.wikipedia.org/wiki/JPEG_2000)
|
|
* [PNG](https://en.wikipedia.org/wiki/Portable_Network_Graphics) via [libpng](http://www.libpng.org/)
|
|
* [TIFF](https://en.wikipedia.org/wiki/Tagged_Image_File_Format) via [libtiff](http://www.libtiff.org/)
|
|
* [WebP](https://en.wikipedia.org/wiki/WebP) via [libwebp](https://developers.google.com/speed/webp/)
|
|
* [XPM](https://en.wikipedia.org/wiki/X_PixMap) via [libXpm](http://xorg.freedesktop.org/)
|
|
|
|
Besides that, GD depends on some external libraries, which are all optional
|
|
and disabled by default:
|
|
|
|
* [FreeType](https://freetype.org) for rendering fonts
|
|
* [Fontconfig](https://fontconfig.org) for configuring and customizing font access
|
|
* [libraqm](https://github.com/HOST-Oman/libraqm) for complex text layout
|
|
* [libimagequant](https://pngquant.org/lib) for conversion of RGBA images to 8-bit indexed-color images
|
|
* **NOTE** libimagequant is dual-licensed: GPLv3 and commercial license
|