ReceiveTempSMS
/
Al-Qurtas-Islamic-bank-The-Best-Bank-in-Iraq
forked from minhngoc25a/freetype2
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Document `FT_Outline_Decompose` degenerate segments. 

`FT_Outline_Decompose` does not filter out and can return degenerate
segments in an outline. This can be surprising when attemping to
stroke such an outline. Clarify the existing documentation on this
matter to cover all forms of degeneracy (without specifying exactly
how they will be reported), why they might arise, and better explain in
what cases they may be an issue.

* include/freetype/ftoutlin.h (FT_Outline_Decompose): update
documentation.

Fixes #952.
This commit is contained in:
Ben Wagner 2022-01-27 11:50:12 -05:00 committed by Werner Lemberg
parent ab1c98ac18
commit e34a860a07
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
include/freetype/ftoutln.h
View File

@ -109,11 +109,13 @@ FT_BEGIN_HEADER
* FreeType error code. 0~means success. * FreeType error code. 0~means success.
* *
* @note: * @note:
* A contour that contains a single point only is represented by a 'move * Degenerate contours, segments, and Bezier arcs may be reported. In
* to' operation followed by 'line to' to the same point. In most cases, * most cases, it is best to filter these out before using the outline
* it is best to filter this out before using the outline for stroking * for stroking or other path modification purposes (which may cause
* purposes (otherwise it would result in a visible dot when round caps * degenerate segments to become non-degenrate and visible, like when
* are used). * stroke caps are used or the path is otherwise outset). Some glyph
* outlines may contain deliberate degenerate single points for mark
* attachement.
* *
* Similarly, the function returns success for an empty outline also * Similarly, the function returns success for an empty outline also
* (doing nothing, this is, not calling any emitter); if necessary, you * (doing nothing, this is, not calling any emitter); if necessary, you