As I study the code, I'm going to fill this page. Every sentence is of uncertainy. So, I don't use "maybe" or "perphaps". But that doesn't mean I'm sure that is correct. I just don't want to mess up readability with those unnessesary words. If you find errors, correct them.
Text rendering on Linux
Of cource, gfx takes text, and it breaks down to textruns. Then, what exactly happening under the hood? Basically, there is two dives into gfx to render the page. One is for making gfx do glyph-level layout, and auquiring the result of textruns, in turn, using that information, gecko do css-box-level layout with frames (a.k.a. reflow). The other is for actually making gfx draw graphics using the combined glyph-level- and css-box-level- geometric information.
This is lying under gfx, with wearing thebes. ;) Cairo interacts with gfx's text rendering in some way. One is by becoming by proxy of gfx and Freetype. Because Freetype's glyph data is destined to Cairo, gfx instructs Freetype only via Cairo. Thus, actual glyph vector data are stop at Cairo, in the form which Cairo likes(cairo_scaled_font_t). To complicate this, mozilla-central contains cairo. What's happening here? Is it modified and/or used on Linux? Also, Cairo is used even on Windows and Mac OS X. So, gfxFont is associated with Cairo to some extent.
Pango is for doing layout of glyphs. But, gfx doesn't use the high level PangoLayout. Instead, it interacts it deeply. First of all, Pango doesn't render at all. Pango is only used for calculating positions of glyphs. Then evenry resultant information are passed back to gfx. How gfx communicate with Pango?
This enables font selection. Various CSS values are passed as FC_Pattern. Genelly FC_Pattern is used passing around information between gfx, pango, freetype. Because of modular neture, pango uses callbacks. Thus this kind of method is neccesary.
This extracts glyphs from actual font files residing in the system. At this level, RTL glyphs are exactly same as LTR glyphs. This means. glyph's coordinate is tied to screen coordinate, not the text coordinate in which the glyph may belong to. So, while we render glyphs, we must do x-=width.
gfxFont.cpp gfxFont.h: this is for platform-independent header related Fonts.
textrun, glyph metrics, extents.
1st: Glyph Layout part.
How extents are retreaved??? And cached??
gfx_pango_fc_font_get_glyph_extents() is called every time glyph extents is needed by Pango's shapers.
2nd: Glyph Rendering part.
nsSVGGlyphFrame::FillCharacters -> gfxTextRun::Draw -> gfxFont::Draw()
gfxFont.cpp:333 gfxFont::Draw() does final rendering of all glyphs rendered on Firefox, even including UI.
gfxTextRun: this is almost always treated as a collection. How about the assumption? next text run's x must be larger than the previous one's x? If I were do vertical layout directly, it'll break everything?
Justification. -> CSS style text-align and text-justify -> NS_STYLE_TEXT_ALIGN_JUSTIFY, mTextAlign hmm text-align doesn't reach to gfx???
* When set, the text string pointer used to create the text run
* is guaranteed to be available during the lifetime of the text run.
TEXT_IS_PERSISTENT = 0x0001,
* When set, the text is known to be all-ASCII (< 128).
TEXT_IS_ASCII = 0x0002,
* When set, the text is RTL.
TEXT_IS_RTL = 0x0004,
* When set, spacing is enabled and the textrun needs to call GetSpacing
* on the spacing provider.
TEXT_ENABLE_SPACING = 0x0008,
* When set, GetSpacing can return negative spacing.
TEXT_ENABLE_NEGATIVE_SPACING = 0x0010,
* When set, GetHyphenationBreaks may return true for some character
* positions, otherwise it will always return false for all characters.
TEXT_ENABLE_HYPHEN_BREAKS = 0x0040,
* When set, the text has no characters above 255 and it is stored
* in the textrun in 8-bit format.
TEXT_IS_8BIT = 0x0080,
* When set, the text may have UTF16 surrogate pairs, otherwise it
TEXT_HAS_SURROGATES = 0x0100,
* When set, the RunMetrics::mBoundingBox field will be initialized
* properly based on glyph extents, in particular, glyph extents that
* overflow the standard font-box (the box defined by the ascent, descent
* and advance width of the glyph). When not set, it may just be the
* standard font-box even if glyphs overflow.
TEXT_NEED_BOUNDING_BOX = 0x0200,
* When set, optional ligatures are disabled. Ligatures that are
* required for legible text should still be enabled.
TEXT_DISABLE_OPTIONAL_LIGATURES = 0x0400,
* When set, the textrun should favour speed of construction over
* quality. This may involve disabling ligatures and/or kerning or
* other effects.
TEXT_OPTIMIZE_SPEED = 0x0800