diff options
Diffstat (limited to 'modules/freetype2/docs/reference/ft2-computations.html')
-rw-r--r-- | modules/freetype2/docs/reference/ft2-computations.html | 27 |
1 files changed, 17 insertions, 10 deletions
diff --git a/modules/freetype2/docs/reference/ft2-computations.html b/modules/freetype2/docs/reference/ft2-computations.html index 9f840e862..d615dcfa2 100644 --- a/modules/freetype2/docs/reference/ft2-computations.html +++ b/modules/freetype2/docs/reference/ft2-computations.html @@ -1,9 +1,9 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" -"http://www.w3.org/TR/html4/loose.dtd"> +"https://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<title>FreeType-2.7.1 API Reference</title> +<title>FreeType-2.9.1 API Reference</title> <style type="text/css"> a:link { color: #0000EF; } a:visited { color: #51188E; } @@ -100,7 +100,7 @@ <body> <table class="index-toc-link"><tr><td class="left">[<a href="ft2-index.html">Index</a>]</td><td class="right">[<a href="ft2-toc.html">TOC</a>]</td></tr></table> -<h1>FreeType-2.7.1 API Reference</h1> +<h1>FreeType-2.9.1 API Reference</h1> <h1 id="computations">Computations</h1> <h2>Synopsis</h2> @@ -129,7 +129,7 @@ <a href="ft2-basic_types.html#FT_Long">FT_Long</a> c ); </pre> -<p>A very simple function used to perform the computation ‘(a*b)/c’ with maximum accuracy (it uses a 64-bit intermediate integer whenever necessary).</p> +<p>Compute ‘(a*b)/c’ with maximum accuracy, using a 64-bit intermediate integer whenever necessary.</p> <p>This function isn't necessarily as fast as some processor specific operations, but is at least completely portable.</p> <h4>input</h4> @@ -160,7 +160,7 @@ <a href="ft2-basic_types.html#FT_Long">FT_Long</a> b ); </pre> -<p>A very simple function used to perform the computation ‘(a*b)/0x10000’ with maximum accuracy. Most of the time this is used to multiply a given value by a 16.16 fixed-point factor.</p> +<p>Compute ‘(a*b)/0x10000’ with maximum accuracy. Its main use is to multiply a given value by a 16.16 fixed-point factor.</p> <h4>input</h4> <table class="fields"> @@ -191,7 +191,7 @@ <a href="ft2-basic_types.html#FT_Long">FT_Long</a> b ); </pre> -<p>A very simple function used to perform the computation ‘(a*0x10000)/b’ with maximum accuracy. Most of the time, this is used to divide a given value by a 16.16 fixed-point factor.</p> +<p>Compute ‘(a*0x10000)/b’ with maximum accuracy. Its main use is to divide a given value by a 16.16 fixed-point factor.</p> <h4>input</h4> <table class="fields"> @@ -217,7 +217,7 @@ <b>FT_RoundFix</b>( <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a> a ); </pre> -<p>A very simple function used to round a 16.16 fixed number.</p> +<p>Round a 16.16 fixed number.</p> <h4>input</h4> <table class="fields"> @@ -227,7 +227,10 @@ </table> <h4>return</h4> -<p>‘a’ rounded to nearest 16.16 fixed integer, halfway cases away from zero.</p> +<p>‘a’ rounded to the nearest 16.16 fixed integer, halfway cases away from zero.</p> + +<h4>note</h4> +<p>The function uses wrap-around arithmetic.</p> <hr> <table class="index-toc-link"><tr><td class="left">[<a href="ft2-index.html">Index</a>]</td><td class="middle">[<a href="#">Top</a>]</td><td class="right">[<a href="ft2-toc.html">TOC</a>]</td></tr></table></div> @@ -240,7 +243,7 @@ <b>FT_CeilFix</b>( <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a> a ); </pre> -<p>A very simple function used to compute the ceiling function of a 16.16 fixed number.</p> +<p>Compute the smallest following integer of a 16.16 fixed number.</p> <h4>input</h4> <table class="fields"> @@ -252,6 +255,9 @@ <h4>return</h4> <p>‘a’ rounded towards plus infinity.</p> +<h4>note</h4> +<p>The function uses wrap-around arithmetic.</p> + <hr> <table class="index-toc-link"><tr><td class="left">[<a href="ft2-index.html">Index</a>]</td><td class="middle">[<a href="#">Top</a>]</td><td class="right">[<a href="ft2-toc.html">TOC</a>]</td></tr></table></div> @@ -263,7 +269,7 @@ <b>FT_FloorFix</b>( <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a> a ); </pre> -<p>A very simple function used to compute the floor function of a 16.16 fixed number.</p> +<p>Compute the largest previous integer of a 16.16 fixed number.</p> <h4>input</h4> <table class="fields"> @@ -336,6 +342,7 @@ <h4>note</h4> <p>The result is undefined if either ‘a’ or ‘b’ is zero.</p> +<p>Since the function uses wrap-around arithmetic, results become meaningless if the arguments are very large.</p> <hr> <table class="index-toc-link"><tr><td class="left">[<a href="ft2-index.html">Index</a>]</td><td class="middle">[<a href="#">Top</a>]</td><td class="right">[<a href="ft2-toc.html">TOC</a>]</td></tr></table></div> |