mirrors
/
freetype
mirror of https://github.com/freetype/freetype
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Minor clean-ups of last commit.

This commit is contained in:
Werner Lemberg 2020-10-31 06:52:18 +01:00
parent 681c7e2387
commit 6fca2e5b1b
2 changed files with 33 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
include/freetype/freetype.h
View File

@ -38,15 +38,22 @@ FT_BEGIN_HEADER
* @title:
* Preamble
*
* @abstract
* @abstract:
* What FreeType is and isn't
*
* @descriptiom
* FreeType is a library that provides access to glyphs in font files.
* It scales the glyph images and their metrics to a requested size but
* it is not a text layout engine. FreeType rasterizes the glyph images
* and produces pixel or subpixel alpha coverage bitmaps but it does not
* perform alpha blending or compositing itself.
* @description:
* FreeType is a library that provides access to glyphs in font files. It
* scales the glyph images and their metrics to a requested size, and it
* rasterizes the glyph images to produce pixel or subpixel alpha coverage
* bitmaps.
*
* Note that FreeType is _not_ a text layout engine. You have to use
* higher-level libraries like HarfBuzz, Pango, or ICU for that.
*
* Note also that FreeType does _not_ perform alpha blending or
* compositing the resulting bitmaps or pixmaps by itself. Use your
* favourite graphics library (for example, Cairo or Skia) to further
* process FreeType's output.
*
*/

37
include/freetype/ftimage.h
View File

@ -785,26 +785,27 @@ FT_BEGIN_HEADER
* How vectorial outlines are converted into bitmaps and pixmaps.
*
* @description:
* A raster or a raterizer is a scan converter in charge of producing
* a pixel coverage bitmap that can be used as an alpha channel when
* A raster or a rasterizer is a scan converter in charge of producing a
* pixel coverage bitmap that can be used as an alpha channel when
* compositing a glyph with a background. FreeType comes with two
* rasterizers: bilevel `raster1` and anti-aliased `smooth` are two
* separate modules. They are usually called from high-level
* @FT_Load_Glyph or @FT_Render_Glyph and produce the entire coverage
* bitmap at once, while staying largely invisible to users.
* separate modules. They are usually called from the high-level
* @FT_Load_Glyph or @FT_Render_Glyph functions and produce the entire
* coverage bitmap at once, while staying largely invisible to users.
*
* Instead of working with complete coverage bitmaps, it is also
* possible to intercept consecutive pixel runs on the same scanline
* with the same coverage, called spans, and process them individually.
* Only `smooth` rasterizer permits this when calling @FT_Outline_Render
* with @FT_Raster_Params described below.
* Instead of working with complete coverage bitmaps, it is also possible
* to intercept consecutive pixel runs on the same scanline with the same
* coverage, called _spans_, and process them individually. Only the
* `smooth` rasterizer permits this when calling @FT_Outline_Render with
* @FT_Raster_Params as described below.
*
* Whether working with complete bitmaps or spans, it is important to
* think of them as colorless coverage objects suitable as alpha channels
* in blending arbitrary colors with background. For best results, it is
* recommended to use gamma correction too.
* Working with either complete bitmaps or spans it is important to think
* of them as colorless coverage objects suitable as alpha channels to
* blend arbitrary colors with a background. For best results, it is
* recommended to use gamma correction, too.
*
* This section also describes public API needed to set up alternative
* This section also describes the public API needed to set up alternative
* @FT_Renderer modules.
*
* @order:
@ -830,8 +831,8 @@ FT_BEGIN_HEADER
* FT_Span
*
* @description:
* A structure used to model a single span of consecutive pixels
* when rendering an anti-aliased bitmap.
* A structure to model a single span of consecutive pixels when
* rendering an anti-aliased bitmap.
*
* @fields:
* x ::
@ -849,7 +850,7 @@ FT_BEGIN_HEADER
* @FT_SpanFunc that takes the y~coordinate of the span as a parameter.
*
* The anti-aliased rasterizer produces coverage values from 0 to 255,
* from completely transparent to completely opaque.
* this is, from completely transparent to completely opaque.
*/
typedef struct FT_Span_
{