[gdk-pixbuf] docs: Fill out the README file
- From: Emmanuele Bassi <ebassi src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gdk-pixbuf] docs: Fill out the README file
- Date: Mon, 30 Apr 2018 17:17:42 +0000 (UTC)
commit 5cbed24fc4f28dc2f158388e4e073ac8a0b1614f
Author: Emmanuele Bassi <ebassi gnome org>
Date: Thu Apr 26 14:27:32 2018 +0100
docs: Fill out the README file
It's desolate, at the moment, and free software projects without a
decent README are a bit sad.
README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 70 insertions(+), 0 deletions(-)
---
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b1e5818
--- /dev/null
+++ b/README.md
@@ -0,0 +1,70 @@
+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
+ - 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:
+
+```sh
+$ meson _build .
+$ cd _build
+$ ninja
+# ninja install
+```
+
+You can use the `--prefix` argument to control the installation prefix.
+
+You can also use `meson configure` from within the build directory to
+check the current build configuration, and change its options.
+
+## License
+
+GdkPixbuf is released under the terms of the GNU Library General Public
+License version 2, or, at your option, any later version. See the
+[COPYING](./COPYING) file for further details.
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]