diff options
Diffstat (limited to 'Build/source/libs/freetype2/freetype-src/docs/reference/ft2-sizes_management.html')
-rw-r--r-- | Build/source/libs/freetype2/freetype-src/docs/reference/ft2-sizes_management.html | 194 |
1 files changed, 148 insertions, 46 deletions
diff --git a/Build/source/libs/freetype2/freetype-src/docs/reference/ft2-sizes_management.html b/Build/source/libs/freetype2/freetype-src/docs/reference/ft2-sizes_management.html index ade45b1cc6c..6240d5e824d 100644 --- a/Build/source/libs/freetype2/freetype-src/docs/reference/ft2-sizes_management.html +++ b/Build/source/libs/freetype2/freetype-src/docs/reference/ft2-sizes_management.html @@ -6,7 +6,7 @@ <meta charset="utf-8"> <meta name="viewport" content="width=device-width,initial-scale=1"> - <meta name="description" content="API Reference Documentation for FreeType-2.13.0"> + <meta name="description" content="API Reference Documentation for FreeType-2.13.1"> @@ -14,11 +14,11 @@ <link rel="icon" href="images/favico.ico"> - <meta name="generator" content="mkdocs-1.2.1, mkdocs-material-7.1.9"> + <meta name="generator" content="mkdocs-1.4.3, mkdocs-material-7.1.9"> - <title>Size Management - FreeType-2.13.0 API Reference</title> + <title>Size Management - FreeType-2.13.1 API Reference</title> @@ -82,7 +82,7 @@ <header class="md-header" data-md-component="header"> <nav class="md-header__inner md-grid" aria-label="Header"> - <a href="index.html" title="FreeType-2.13.0 API Reference" class="md-header__button md-logo" aria-label="FreeType-2.13.0 API Reference" data-md-component="logo"> + <a href="index.html" title="FreeType-2.13.1 API Reference" class="md-header__button md-logo" aria-label="FreeType-2.13.1 API Reference" data-md-component="logo"> <img src="images/favico.ico" alt="logo"> @@ -94,7 +94,7 @@ <div class="md-header__ellipsis"> <div class="md-header__topic"> <span class="md-ellipsis"> - FreeType-2.13.0 API Reference + FreeType-2.13.1 API Reference </span> </div> <div class="md-header__topic" data-md-component="header-topic"> @@ -161,12 +161,12 @@ <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0"> <label class="md-nav__title" for="__drawer"> - <a href="index.html" title="FreeType-2.13.0 API Reference" class="md-nav__button md-logo" aria-label="FreeType-2.13.0 API Reference" data-md-component="logo"> + <a href="index.html" title="FreeType-2.13.1 API Reference" class="md-nav__button md-logo" aria-label="FreeType-2.13.1 API Reference" data-md-component="logo"> <img src="images/favico.ico" alt="logo"> </a> - FreeType-2.13.0 API Reference + FreeType-2.13.1 API Reference </label> <ul class="md-nav__list" data-md-scrollfix> @@ -273,14 +273,12 @@ - - - <li class="md-nav__item md-nav__item--active md-nav__item--nested"> + <li class="md-nav__item md-nav__item--nested"> - <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" checked> + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" > <label class="md-nav__link" for="__nav_4"> Core API @@ -298,8 +296,8 @@ <li class="md-nav__item"> - <a href="ft2-version.html" class="md-nav__link"> - FreeType Version + <a href="ft2-basic_types.html" class="md-nav__link"> + Basic Data Types </a> </li> @@ -310,8 +308,80 @@ <li class="md-nav__item"> - <a href="ft2-basic_types.html" class="md-nav__link"> - Basic Data Types + <a href="ft2-library_setup.html" class="md-nav__link"> + Library Setup + </a> + </li> + + + + + + + + <li class="md-nav__item"> + <a href="ft2-face_creation.html" class="md-nav__link"> + Face Creation + </a> + </li> + + + + + + + + <li class="md-nav__item"> + <a href="ft2-font_testing_macros.html" class="md-nav__link"> + Font Testing Macros + </a> + </li> + + + + + + + + <li class="md-nav__item"> + <a href="ft2-sizing_and_scaling.html" class="md-nav__link"> + Sizing and Scaling + </a> + </li> + + + + + + + + <li class="md-nav__item"> + <a href="ft2-glyph_retrieval.html" class="md-nav__link"> + Glyph Retrieval + </a> + </li> + + + + + + + + <li class="md-nav__item"> + <a href="ft2-character_mapping.html" class="md-nav__link"> + Character Mapping + </a> + </li> + + + + + + + + <li class="md-nav__item"> + <a href="ft2-information_retrieval.html" class="md-nav__link"> + Information Retrieval </a> </li> @@ -322,13 +392,45 @@ <li class="md-nav__item"> - <a href="ft2-base_interface.html" class="md-nav__link"> - Base Interface + <a href="ft2-other_api_data.html" class="md-nav__link"> + Other API Data </a> </li> + </ul> + </nav> + </li> + + + + + + + + + + + + + + <li class="md-nav__item md-nav__item--active md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" checked> + + <label class="md-nav__link" for="__nav_5"> + Extended API + <span class="md-nav__icon md-icon"></span> + </label> + <nav class="md-nav" aria-label="Extended API" data-md-level="1"> + <label class="md-nav__title" for="__nav_5"> + <span class="md-nav__icon md-icon"></span> + Extended API + </label> + <ul class="md-nav__list" data-md-scrollfix> + @@ -491,14 +593,14 @@ <li class="md-nav__item md-nav__item--nested"> - <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" > + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" > - <label class="md-nav__link" for="__nav_5"> + <label class="md-nav__link" for="__nav_6"> Format-Specific API <span class="md-nav__icon md-icon"></span> </label> <nav class="md-nav" aria-label="Format-Specific API" data-md-level="1"> - <label class="md-nav__title" for="__nav_5"> + <label class="md-nav__title" for="__nav_6"> <span class="md-nav__icon md-icon"></span> Format-Specific API </label> @@ -653,14 +755,14 @@ <li class="md-nav__item md-nav__item--nested"> - <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" > + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" > - <label class="md-nav__link" for="__nav_6"> + <label class="md-nav__link" for="__nav_7"> Controlling FreeType Modules <span class="md-nav__icon md-icon"></span> </label> <nav class="md-nav" aria-label="Controlling FreeType Modules" data-md-level="1"> - <label class="md-nav__title" for="__nav_6"> + <label class="md-nav__title" for="__nav_7"> <span class="md-nav__icon md-icon"></span> Controlling FreeType Modules </label> @@ -791,14 +893,14 @@ <li class="md-nav__item md-nav__item--nested"> - <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" > + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" > - <label class="md-nav__link" for="__nav_7"> + <label class="md-nav__link" for="__nav_8"> Cache Sub-System <span class="md-nav__icon md-icon"></span> </label> <nav class="md-nav" aria-label="Cache Sub-System" data-md-level="1"> - <label class="md-nav__title" for="__nav_7"> + <label class="md-nav__title" for="__nav_8"> <span class="md-nav__icon md-icon"></span> Cache Sub-System </label> @@ -833,14 +935,14 @@ <li class="md-nav__item md-nav__item--nested"> - <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" > + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" > - <label class="md-nav__link" for="__nav_8"> + <label class="md-nav__link" for="__nav_9"> Support API <span class="md-nav__icon md-icon"></span> </label> <nav class="md-nav" aria-label="Support API" data-md-level="1"> - <label class="md-nav__title" for="__nav_8"> + <label class="md-nav__title" for="__nav_9"> <span class="md-nav__icon md-icon"></span> Support API </label> @@ -1019,14 +1121,14 @@ <li class="md-nav__item md-nav__item--nested"> - <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" > + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_10" type="checkbox" id="__nav_10" > - <label class="md-nav__link" for="__nav_9"> + <label class="md-nav__link" for="__nav_10"> Error Codes <span class="md-nav__icon md-icon"></span> </label> <nav class="md-nav" aria-label="Error Codes" data-md-level="1"> - <label class="md-nav__title" for="__nav_9"> + <label class="md-nav__title" for="__nav_10"> <span class="md-nav__icon md-icon"></span> Error Codes </label> @@ -1073,14 +1175,14 @@ <li class="md-nav__item md-nav__item--nested"> - <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_10" type="checkbox" id="__nav_10" > + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_11" type="checkbox" id="__nav_11" > - <label class="md-nav__link" for="__nav_10"> + <label class="md-nav__link" for="__nav_11"> Miscellaneous <span class="md-nav__icon md-icon"></span> </label> <nav class="md-nav" aria-label="Miscellaneous" data-md-level="1"> - <label class="md-nav__title" for="__nav_10"> + <label class="md-nav__title" for="__nav_11"> <span class="md-nav__icon md-icon"></span> Miscellaneous </label> @@ -1206,19 +1308,19 @@ - <p><a href="https://www.freetype.org">FreeType</a> » <a href="../">Docs</a> » <a href="index.html#core-api">Core API</a> » Size Management</p> + <p><a href="https://www.freetype.org">FreeType</a> » <a href="../">Docs</a> » <a href="index.html#extended-api">Extended API</a> » Size Management</p> <hr /> <h1 id="size-management">Size Management<a class="headerlink" href="#size-management" title="Permanent link">¶</a></h1> <h2 id="synopsis">Synopsis<a class="headerlink" href="#synopsis" title="Permanent link">¶</a></h2> -<p>When creating a new face object (e.g., with <code><a href="ft2-base_interface.html#ft_new_face">FT_New_Face</a></code>), an <code><a href="ft2-base_interface.html#ft_size">FT_Size</a></code> object is automatically created and used to store all pixel-size dependent information, available in the <code>face->size</code> field.</p> +<p>When creating a new face object (e.g., with <code><a href="ft2-face_creation.html#ft_new_face">FT_New_Face</a></code>), an <code><a href="ft2-sizing_and_scaling.html#ft_size">FT_Size</a></code> object is automatically created and used to store all pixel-size dependent information, available in the <code>face->size</code> field.</p> <p>It is however possible to create more sizes for a given face, mostly in order to manage several character pixel sizes of the same font family and style. See <code><a href="ft2-sizes_management.html#ft_new_size">FT_New_Size</a></code> and <code><a href="ft2-sizes_management.html#ft_done_size">FT_Done_Size</a></code>.</p> -<p>Note that <code><a href="ft2-base_interface.html#ft_set_pixel_sizes">FT_Set_Pixel_Sizes</a></code> and <code><a href="ft2-base_interface.html#ft_set_char_size">FT_Set_Char_Size</a></code> only modify the contents of the current ‘active’ size; you thus need to use <code><a href="ft2-sizes_management.html#ft_activate_size">FT_Activate_Size</a></code> to change it.</p> +<p>Note that <code><a href="ft2-sizing_and_scaling.html#ft_set_pixel_sizes">FT_Set_Pixel_Sizes</a></code> and <code><a href="ft2-sizing_and_scaling.html#ft_set_char_size">FT_Set_Char_Size</a></code> only modify the contents of the current ‘active’ size; you thus need to use <code><a href="ft2-sizes_management.html#ft_activate_size">FT_Activate_Size</a></code> to change it.</p> <p>99% of applications won't need the functions provided here, especially if they use the caching sub-system, so be cautious when using these.</p> <h2 id="ft_new_size">FT_New_Size<a class="headerlink" href="#ft_new_size" title="Permanent link">¶</a></h2> <p>Defined in FT_SIZES_H (freetype/ftsizes.h).</p> <div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) - <b>FT_New_Size</b>( <a href="ft2-base_interface.html#ft_face">FT_Face</a> face, - <a href="ft2-base_interface.html#ft_size">FT_Size</a>* size ); + <b>FT_New_Size</b>( <a href="ft2-face_creation.html#ft_face">FT_Face</a> face, + <a href="ft2-sizing_and_scaling.html#ft_size">FT_Size</a>* size ); </code></pre></div> <p>Create a new size object from a given face object.</p> @@ -1241,16 +1343,16 @@ <p>FreeType error code. 0 means success.</p> <h4>note</h4> -<p>You need to call <code><a href="ft2-sizes_management.html#ft_activate_size">FT_Activate_Size</a></code> in order to select the new size for upcoming calls to <code><a href="ft2-base_interface.html#ft_set_pixel_sizes">FT_Set_Pixel_Sizes</a></code>, <code><a href="ft2-base_interface.html#ft_set_char_size">FT_Set_Char_Size</a></code>, <code><a href="ft2-base_interface.html#ft_load_glyph">FT_Load_Glyph</a></code>, <code><a href="ft2-base_interface.html#ft_load_char">FT_Load_Char</a></code>, etc.</p> +<p>You need to call <code><a href="ft2-sizes_management.html#ft_activate_size">FT_Activate_Size</a></code> in order to select the new size for upcoming calls to <code><a href="ft2-sizing_and_scaling.html#ft_set_pixel_sizes">FT_Set_Pixel_Sizes</a></code>, <code><a href="ft2-sizing_and_scaling.html#ft_set_char_size">FT_Set_Char_Size</a></code>, <code><a href="ft2-glyph_retrieval.html#ft_load_glyph">FT_Load_Glyph</a></code>, <code><a href="ft2-character_mapping.html#ft_load_char">FT_Load_Char</a></code>, etc.</p> <hr> <h2 id="ft_done_size">FT_Done_Size<a class="headerlink" href="#ft_done_size" title="Permanent link">¶</a></h2> <p>Defined in FT_SIZES_H (freetype/ftsizes.h).</p> <div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) - <b>FT_Done_Size</b>( <a href="ft2-base_interface.html#ft_size">FT_Size</a> size ); + <b>FT_Done_Size</b>( <a href="ft2-sizing_and_scaling.html#ft_size">FT_Size</a> size ); </code></pre></div> -<p>Discard a given size object. Note that <code><a href="ft2-base_interface.html#ft_done_face">FT_Done_Face</a></code> automatically discards all size objects allocated with <code><a href="ft2-sizes_management.html#ft_new_size">FT_New_Size</a></code>.</p> +<p>Discard a given size object. Note that <code><a href="ft2-face_creation.html#ft_done_face">FT_Done_Face</a></code> automatically discards all size objects allocated with <code><a href="ft2-sizes_management.html#ft_new_size">FT_New_Size</a></code>.</p> <h4>input</h4> <table class="fields"> <tr><td class="val" id="size">size</td><td class="desc"> @@ -1266,10 +1368,10 @@ <h2 id="ft_activate_size">FT_Activate_Size<a class="headerlink" href="#ft_activate_size" title="Permanent link">¶</a></h2> <p>Defined in FT_SIZES_H (freetype/ftsizes.h).</p> <div class = "codehilite"><pre><code> FT_EXPORT( <a href="ft2-basic_types.html#ft_error">FT_Error</a> ) - <b>FT_Activate_Size</b>( <a href="ft2-base_interface.html#ft_size">FT_Size</a> size ); + <b>FT_Activate_Size</b>( <a href="ft2-sizing_and_scaling.html#ft_size">FT_Size</a> size ); </code></pre></div> -<p>Even though it is possible to create several size objects for a given face (see <code><a href="ft2-sizes_management.html#ft_new_size">FT_New_Size</a></code> for details), functions like <code><a href="ft2-base_interface.html#ft_load_glyph">FT_Load_Glyph</a></code> or <code><a href="ft2-base_interface.html#ft_load_char">FT_Load_Char</a></code> only use the one that has been activated last to determine the ‘current character pixel size’.</p> +<p>Even though it is possible to create several size objects for a given face (see <code><a href="ft2-sizes_management.html#ft_new_size">FT_New_Size</a></code> for details), functions like <code><a href="ft2-glyph_retrieval.html#ft_load_glyph">FT_Load_Glyph</a></code> or <code><a href="ft2-character_mapping.html#ft_load_char">FT_Load_Char</a></code> only use the one that has been activated last to determine the ‘current character pixel size’.</p> <p>This function can be used to ‘activate’ a previously created size object.</p> <h4>input</h4> <table class="fields"> @@ -1359,7 +1461,7 @@ <div class="md-dialog" data-md-component="dialog"> <div class="md-dialog__inner md-typeset"></div> </div> - <script id="__config" type="application/json">{"base": ".", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "search": "assets/javascripts/workers/search.477d984a.min.js", "version": null}</script> + <script id="__config" type="application/json">{"base": ".", "features": [], "search": "assets/javascripts/workers/search.477d984a.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "version": null}</script> <script src="assets/javascripts/bundle.82b56eb2.min.js"></script> |