4f77481934 | ||
---|---|---|
build-aux | ||
contrib/gdk-pixbuf-xlib | ||
debian | ||
docs | ||
gdk-pixbuf | ||
po | ||
subprojects | ||
tests | ||
thumbnailer | ||
CONTRIBUTING.md | ||
COPYING | ||
NEWS | ||
README.md | ||
README.msvc | ||
gdk-pixbuf.doap | ||
meson.build | ||
meson_options.txt |
README.md
GdkPixbuf: Image loading library
GdkPixbuf is a library that loads image data in various formats and stores it as linear buffers in memory. The buffers can then be scaled, composited, modified, saved, or rendered.
GdkPixbuf can load image data encoded in different formats, such as:
- PNG
- JPEG
- TIFF
- TGA
- GIF
Additionally, you can write a GdkPixbuf loader module and install it into a well-known location, in order to load a file format.
GdkPixbuf is used by the GTK toolkit for loading graphical assets.
Building GdkPixbuf
Requirements
In order to build GdkPixbuf you will need to have installed:
- Meson
- A C99-compliant compiler and toolchain
- GLib's development files
Depending on the image formats you want to support you will also need:
- libpng's development files
- libjpeg's development files
- libtiff's development files
- libjasper's development files
Additionally, you may need:
- shared-mime-info
- GObject Introspection
- GTK-Doc
- Xlib's development files
- mediaLib's development files
Building and installing
You should use Meson to configure GdkPixbuf's build, and depending on the platform you will be able to use Ninja, Visual Studio, or XCode to build the project; typically, on most platforms, you should be able to use the following commands to build and install GdkPixbuf in the default prefix:
$ meson _build .
$ cd _build
$ ninja
$ sudo ninja install
You can use Meson's --prefix
argument to control the installation prefix
at configuration time.
You can also use meson configure
from within the build directory to
check the current build configuration, and change its options.
Build options
You can specify the following options in the command line to meson
:
-Djasper=true
- Enable support for JPEG2000. This requires libjasper's development files to be installed.-Ddocs=true
- Build the API reference documentation. This requiresgtk-doc
to be installed.-Drelocatable=true
- Enable application bundle relocation support.
For a complete list of build-time options, see the file
meson_options.txt
. You can read about Meson
options in general in the Meson manual.
Running tests
You can run the test suite by running meson test -C _build
, where
_build
is the build directory you used during the build stage.
License
GdkPixbuf is released under the terms of the GNU Lesser General Public License version 2.1, or, at your option, any later version. See the COPYING file for further details.