python-pillow/Pillow
1
1
Fork 0
mirror of https://github.com/python-pillow/Pillow.git synced 2025-02-12 01:20:53 +03:00
Code Issues Packages Projects Releases Wiki Activity
3386a9ce02
Pillow/src/thirdparty/raqm
History
nulano 3386a9ce02 replace tabs in thirdparty libs
2021-01-05 00:06:29 +11:00
..
AUTHORS add Raqm license and readme 2021-01-05 00:03:52 +11:00
COPYING add Raqm license and readme 2021-01-05 00:03:52 +11:00
NEWS add Raqm license and readme 2021-01-05 00:03:52 +11:00
raqm-version.h replace tabs in thirdparty libs 2021-01-05 00:06:29 +11:00
raqm.c add option to statically link fribidi, version info 2021-01-05 00:06:29 +11:00
raqm.h add raqm to thirdparty directory 2021-01-04 23:57:31 +11:00
README add Raqm license and readme 2021-01-05 00:03:52 +11:00

README

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Raqm
====

[![Linux & macOS build](https://travis-ci.org/HOST-Oman/libraqm.svg?branch=master)](https://travis-ci.org/HOST-Oman/libraqm)
[![Windows build](https://img.shields.io/appveyor/ci/HOSTOman/libraqm/master.svg)](https://ci.appveyor.com/project/HOSTOman/libraqm)

Raqm is a small library that encapsulates the logic for complex text layout and
provides a convenient API.

It currently provides bidirectional text support (using [FriBiDi][1]), shaping
(using [HarfBuzz][2]), and proper script itemization. As a result,
Raqm can support most writing systems covered by Unicode.

The documentation can be accessed on the web at:
> http://host-oman.github.io/libraqm/

Raqm (Arabic: رَقْم) is writing, also number or digit and the Arabic word for
digital (رَقَمِيّ) shares the same root, so it is a play on “digital writing”.

Building
--------

Raqm depends on the following libraries:
* [FreeType][3]
* [HarfBuzz][2]
* [FriBiDi][1]

To build the documentation you will also need:
* [GTK-Doc][4]

To install dependencies on Fedora:

    sudo dnf install freetype-devel harfbuzz-devel fribidi-devel gtk-doc

To install dependencies on Ubuntu:

    sudo apt-get install libfreetype6-dev libharfbuzz-dev libfribidi-dev \
                         gtk-doc-tools

On Mac OS X you can use Homebrew:

    brew install freetype harfbuzz fribidi gtk-doc
    export XML_CATALOG_FILES="/usr/local/etc/xml/catalog" # for the docs

Once you have the source code and the dependencies, you can proceed to build.
To do that, run the customary sequence of commands in the source code
directory:

    $ ./configure
    $ make
    $ make install

To build the documentation, pass `--enable-gtk-doc` to the `configure` script.

To run the tests:

    $ make check

Contributing
------------

Once you have made a change that you are happy with, contribute it back, we’ll
be happy to integrate it! Just fork the repository and make a pull request.

Projects using Raqm
-------------------

1. [ImageMagick](https://github.com/ImageMagick/ImageMagick)
2. [LibGD](https://github.com/libgd/libgd)
3. [FontView](https://github.com/googlei18n/fontview)
4. [Pillow](https://github.com/python-pillow)
5. [mplcairo](https://github.com/anntzer/mplcairo)

The following projects have patches to support complex text layout using Raqm:

2. SDL_ttf: https://bugzilla.libsdl.org/show_bug.cgi?id=3211
3. Pygame: https://bitbucket.org/pygame/pygame/pull-requests/52
4. Blender: https://developer.blender.org/D1809



[1]: http://fribidi.org
[2]: http://harfbuzz.org
[3]: https://www.freetype.org
[4]: https://www.gtk.org/gtk-doc