Link of "walkthrough of the example" broken

[sanketgarade]

In the main repo wiki, under user examples, i followed the below links to this repo and its walkthrough, but the later one is broken.

harfbuzz-tutorial, along with the walk-though accompanying that.

I searched on the flossmanuals website but didn't find anything related to "harfbuzz". I am trying to contact them to find out if they have the article and can restore it.

Meanwhile I was wondering if you guys have the walkthrough saved at some other place too? (I am trying to integrate harfbuzz into Organic Maps and wanted to study and understand some examples.)

[khaledhosny]

Meanwhile I was wondering if you guys have the walkthrough saved at some other place too? (I am trying to integrate harfbuzz into Organic Maps and wanted to study and understand some examples.)

Looks like you already use FreeType, so I recommend you give libraqm a try. Its decomentation has a small, standalone, example.

[sanketgarade]

so I recommend you give libraqm a try.

Hello

Thanks for the suggestion.
I'm very new to text processing and rendering etc. so I'm sorry but I have some basic questions.

• Does your library support all scripts that harfbuzz supports?
• What is the benefit of using your library instead of directly integrating harfbuzz into organic maps?
• Similarly are there demerits if any?
• Organic maps app work on Linux, macOS, windows, android, iOS. Does your library work on all these?

[khaledhosny]

To do proper text layout you need to segment text into script segments, segment text into directional segment, and finally shape each segment. HarfBuzz does the last step, Raqm handles everything and calls the relevant libraries including HarfBuzz. It is basically a glue layer so every application does not have to re-do the same things, plus other convenience APIs. It is a single file library, so you can also use it as an example on how to properly use HarfBuzz if you don’t want to use it directly.

[khaledhosny]

See also What does HarfBuzz do and What HarfBuzz doesn't do, Raqm does some of the things HarfBuzz doesn’t do.

[ldo]

FreeType is very low-level for text rendering. Something like Cairo makes it easier, and gives you more options. The basic procedure for rendering a line of bidirectional text can be something like

• Use FriBidi to split the line into unidirectional text runs
• Use HarfBuzz to “shape” each text run, choosing and positioning the right glyphs to render the given text
• Use Cairo to render each run of text glyphs.

Of course, issues like multiple font styles, line-splitting and hyphenation are extra.