rgraves
/
freetype2
forked from minhngoc25a/freetype2
1
0
Fork 0
Code Issues Pull Requests 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: * @title:
* Preamble * Preamble
* *
* @abstract * @abstract:
* What FreeType is and isn't * What FreeType is and isn't
* *
* @descriptiom * @description:
* FreeType is a library that provides access to glyphs in font files. * FreeType is a library that provides access to glyphs in font files. It
* It scales the glyph images and their metrics to a requested size but * scales the glyph images and their metrics to a requested size, and it
* it is not a text layout engine. FreeType rasterizes the glyph images * rasterizes the glyph images to produce pixel or subpixel alpha coverage
* and produces pixel or subpixel alpha coverage bitmaps but it does not * bitmaps.
* perform alpha blending or compositing itself. *
* 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. * How vectorial outlines are converted into bitmaps and pixmaps.
* *
* @description: * @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 * compositing a glyph with a background. FreeType comes with two
* rasterizers: bilevel `raster1` and anti-aliased `smooth` are two * rasterizers: bilevel `raster1` and anti-aliased `smooth` are two
* separate modules. They are usually called from high-level * separate modules. They are usually called from the high-level
* @FT_Load_Glyph or @FT_Render_Glyph and produce the entire coverage * @FT_Load_Glyph or @FT_Render_Glyph functions and produce the entire
* bitmap at once, while staying largely invisible to users. * coverage bitmap at once, while staying largely invisible to users.
* *
* Instead of working with complete coverage bitmaps, it is also * Instead of working with complete coverage bitmaps, it is also possible
* possible to intercept consecutive pixel runs on the same scanline * to intercept consecutive pixel runs on the same scanline with the same
* with the same coverage, called spans, and process them individually. * coverage, called _spans_, and process them individually. Only the
* Only `smooth` rasterizer permits this when calling @FT_Outline_Render * `smooth` rasterizer permits this when calling @FT_Outline_Render with
* with @FT_Raster_Params described below. * @FT_Raster_Params as described below.
* *
* Whether working with complete bitmaps or spans, it is important to * Working with either complete bitmaps or spans it is important to think
* think of them as colorless coverage objects suitable as alpha channels * of them as colorless coverage objects suitable as alpha channels to
* in blending arbitrary colors with background. For best results, it is * blend arbitrary colors with a background. For best results, it is
* recommended to use gamma correction too. * 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. * @FT_Renderer modules.
* *
* @order: * @order:
@ -830,8 +831,8 @@ FT_BEGIN_HEADER
* FT_Span * FT_Span
* *
* @description: * @description:
* A structure used to model a single span of consecutive pixels * A structure to model a single span of consecutive pixels when
* when rendering an anti-aliased bitmap. * rendering an anti-aliased bitmap.
* *
* @fields: * @fields:
* x :: * x ::
@ -849,7 +850,7 @@ FT_BEGIN_HEADER
* @FT_SpanFunc that takes the y~coordinate of the span as a parameter. * @FT_SpanFunc that takes the y~coordinate of the span as a parameter.
* *
* The anti-aliased rasterizer produces coverage values from 0 to 255, * 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_ typedef struct FT_Span_
{ {