What are each project used for?

[Happypig375]

It seems like Typography.OpenFont and Typography.GlyphLayout are the most important ones.
While digging through the demos (also note the weird namings of them),
I see that Typography.Contours are also used.
This makes me wonder what each project is supposed to provide.

[prepare]

1. Typography.OpenFont

• This project is a core project, no dependency on others.
• This project contains a font reader that implements Open Font Format,
  (ISO/IEC 14496-22:2015 , and Microsoft OpenType Specification)
  and Web Open Font Format (both WOFF 1.0, 2.0)
• OpenType GSUB, GPOS layout mechanism are 'sleep' in here.
• No Visual/Graphics Rendering Here

---

2. Typography.GlyphLayout

since GlyphLayout engine is not stable and quite complex,
I separated this from the OpenFont core project

• This project invokes OpenType Layout Engine/Mechanism (esp. GSUB, GPOS) inside the
  Typography.OpenFont
• The engine converts a string to a glyph-index List and substitutes some glyph,
  and place them into a proper position by the request 'settings'
  eg see Add ScriptLang ComboBox #82,
  or Emoji Font :) #18
• No Visual/Graphics Rendering Here

---

With Typography.OpenFont + Typography.GlyphLayout

you can use the font data/ text/ glyph position to
render to 'your' render surface.

I provide the example for this

eg ...

• Render to classic GDI+ WinForms => https://github.com/LayoutFarm/Typography/tree/master/Demo/Windows/GdiPlusSample.WinForms

• Render to PixelFarm => https://github.com/LayoutFarm/Typography/tree/master/Demo/Windows/PixelFarmSample.WinForms

or other projects that use only 2 libs and render the data to their surfaces.

see ...

• https://github.com/samhocevar/emoji.wpf

• https://github.com/zwcloud/ImGui

• https://github.com/MatterHackers/agg-sharp

pic1 MatterControl (https://github.com/MatterHackers/MatterControl) with Typography

[Happypig375]

What about Typography.Contours and others?
Typography.Contours targets .NET Framework 2.0 and cannot be referenced from .NET Standard 2.0.

[prepare]

But when I want to parse a long text and render like this ...

---

The HtmlRenderer example!

This is a snapshot of Html drawboard from (https://github.com/LayoutFarm/HtmlRenderer).
The glyphs are generated/layouted with our Typography, and rendered with
the PixelFarm (https://github.com/PaintLab/PixelFarm)

pic 1: HtmlRenderer on GLES2 surface, text are renderered with the Typography

---

I need more functions about how to parse a long text
and layout it.

So I need more functions, Those are in development stages.

---

3. Typography.TextServices

   This is a hub of doing some advance things about how to parse a long text and layout them
   The project contains 2 sub-projects( TextBreak and TextFlow)

---

4. Typography.TextBreak

• This implements text-break engine.

• Implements how to break a long text to a list of 'textspan'
  for some languages(eg English) , a text can be parsed into a list of textspan by whitespace break
  but some languages (eg Thai, Laos) can't, They need more advance parsing algorhytm eg=> Dictionary Breaking Engine.

---

5. Typography.TextFlow

• This implements text flow. How to flow a text into a specific shape area.

---

[Happypig375]

This should probably be put in README.

[prepare]

6. FontAtlas see

You can see in the pic1 that I render the Html into OpenGLES2 surface.

Rendering a text on GLES2 surface may has multiple ways

One technique is using Font texture atlas.

I provide How to create font Atlas in the project

---

[prepare]

7. Msdf Texture see

   When we talk about FontAtlas.
   There are many kind of Font Atlas.

   If you need scalable texture font with 'Sharp' edge=>
   one of them is Multi-channel signed distance field (Msdf) Texture

   I also 'port' Multi-channel signed distance field (Msdf) Texture
   (https://github.com/Chlumsky/msdfgen) from C/C++ to C#

[prepare]

8. Typography.Contours

• This is a developing project.
• I use this for glyph shape analysis/study.
• I try to implement AutoHint here

eg.

pic 1: grid w,h (1px,10px)

pic 2: grid w,h (1px,10px)

(see PaintLab/PixelFarm#4 , #37)

[prepare]

Under development Typography.Contours

---

Century font, A, 460pts

pic 1: master outline

pic 2: from 1

pic 3: from 1, master outline with edge offset -10px (thin)

pic 4: from 3

pic 5: from 1, master outline with edge offset +10px (thick)

pic 5: from 4

[prepare]

Naming something sometimes quite hard :)

Welcome all new suggestions about that.

[Happypig375]

Can you post this useful information at README?