92 lines
2.9 KiB
Markdown
92 lines
2.9 KiB
Markdown
|
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](https://www.gtk.org) toolkit for loading
|
||
|
|
graphical assets.
|
||
|
|
|
||
|
|
## Building GdkPixbuf
|
||
|
|
|
||
|
|
### Requirements
|
||
|
|
|
||
|
|
In order to build GdkPixbuf you will need to have installed:
|
||
|
|
|
||
|
|
- [Meson](http://mesonbuild.com)
|
||
|
|
- A C99-compliant compiler and toolchain
|
||
|
|
- [GLib's development files](https://gitlab.gnome.org/GNOME/glib/)
|
||
|
|
|
||
|
|
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](https://freedesktop.org/wiki/Software/shared-mime-info/)
|
||
|
|
- [GObject Introspection](https://gitlab.gnome.org/GNOME/gobject-introspection/)
|
||
|
|
- [GTK-Doc](https://gitlab.gnome.org/GNOME/gtk-doc/)
|
||
|
|
- [Xlib's development files](https://cgit.freedesktop.org/xorg/lib/libX11/)
|
||
|
|
- 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:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
$ 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](http://www.ece.uvic.ca/~frodo/jasper/)
|
||
|
|
to be installed.
|
||
|
|
* `-Ddocs=true` - Build the API reference documentation. This
|
||
|
|
requires `gtk-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`](meson_options.txt). You can read about Meson
|
||
|
|
options in general [in the Meson manual](http://mesonbuild.com/Build-options.html).
|
||
|
|
|
||
|
|
## 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](./COPYING) file for further details.
|