lili/opennurbs
1
0
Fork 0
mirror of https://github.com/mcneel/opennurbs.git synced 2026-03-30 15:36:52 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
832ccb5c1aa0e9513081163bbbc5b4aa4e306227
opennurbs/6/d6/dde/opennurbs__font_8h_source.html
Bozo 832ccb5c1a Publish! 
Generated from v6.0.11315.11111-test14
2018-02-03 11:08:49 -08:00

117 lines
381 KiB
HTML
Raw Blame History

<!-- HTML header for doxygen 1.8.13-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>openNURBS SDK Help: D:/BuildAgent/work/d8e3bf9e94f4c621/src4/bin/opennurbs_public/opennurbs_font.h Source File</title>
<link href="../../tabs.css" rel="stylesheet" type="text/css"/>
<!-- <script type="text/javascript" src="../../jquery.js"></script> -->
<script type="text/javascript" src="https://code.jquery.com/jquery-2.1.1.min.js"></script>
<script type="text/javascript" src="../../dynsections.js"></script>
<link href="../../doxygen.css" rel="stylesheet" type="text/css" />
<link href="../../customdoxygen.css" rel="stylesheet" type="text/css"/>
<!-- bootstrap -->
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
<!-- smartmenus -->
<link href="../../jquery.smartmenus.bootstrap.css" rel="stylesheet">
<script type="text/javascript" src="../../jquery.smartmenus.js"></script>
<script type="text/javascript" src="../../jquery.smartmenus.bootstrap.js"></script>
</head>
<body>
<!-- <div class="version-banner">
Go back to the <a href="/">main site</a>...
</div> -->
<div class="container">
<!-- navbar -->
<nav class="navbar navbar-default">
<div class="container-fluid">
<a class="navbar-brand" href="#">openNURBS SDK Help</a>
<div class="navbar-collapse collapse" id="main-nav-placeholder">
<!-- <p class="navbar-text navbar-right">v6.0</p> -->
<ul class="nav navbar-nav navbar-right">
<li class="dropdown">
<a class="dropdown-toggle" href="#">v6.0 <span class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="#">Latest (6.x)</a></li>
<li class="disabled"><a href="#">WIP (7.x)</a></li>
</ul>
</li>
</ul>
</div>
</div>
</nav>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div class="page-content">
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript" src="../../menudata.js"></script>
<script type="text/javascript" src="../../menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('../../',false,false,'search.php','Search');
});
</script>
<div id="main-nav"></div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="../../dir_2ea30aa2956a8db99dd22aa5e597f384.html">bin</a></li><li class="navelem"><a class="el" href="../../dir_7a6cfee8d318bd47c162fe536aecd3a7.html">opennurbs_public</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">opennurbs_font.h</div> </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span>&#160;<span class="comment">// Copyright (c) 1993-2015 Robert McNeel &amp; Associates. All rights reserved.</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span>&#160;<span class="comment">// OpenNURBS, Rhinoceros, and Rhino3D are registered trademarks of Robert</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span>&#160;<span class="comment">// McNeel &amp; Associates.</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span>&#160;<span class="comment">// THIS SOFTWARE IS PROVIDED &quot;AS IS&quot; WITHOUT EXPRESS OR IMPLIED WARRANTY.</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span>&#160;<span class="comment">// ALL IMPLIED WARRANTIES OF FITNESS FOR ANY PARTICULAR PURPOSE AND OF</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span>&#160;<span class="comment">// MERCHANTABILITY ARE HEREBY DISCLAIMED.</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span>&#160;<span class="comment">// </span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span>&#160;<span class="comment">// For complete openNURBS copyright information see &lt;http://www.opennurbs.org&gt;.</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span>&#160;<span class="comment">//</span><span class="comment"></span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span>&#160;<span class="comment">////////////////////////////////////////////////////////////////</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span>&#160;</div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span>&#160;<span class="preprocessor">#if !defined(OPENNURBS_FONT_INC_)</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span>&#160;<span class="preprocessor">#define OPENNURBS_FONT_INC_</span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span>&#160;</div><div class="line"><a name="l00018"></a><span class="lineno"><a class="line" href="../../dd/d29/class_o_n___font_metrics.html"> 18</a></span>&#160;<span class="keyword">class </span>ON_CLASS <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span>&#160;{</div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span>&#160; <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span>&#160; ~<a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span>&#160; <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>(<span class="keyword">const</span> <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>&amp;) = <span class="keywordflow">default</span>;</div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span>&#160; <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>&amp; operator=(<span class="keyword">const</span> <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>&amp;) = <span class="keywordflow">default</span>;</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span>&#160;</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span>&#160;</div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span>&#160; <span class="comment">// All properties are zero.</span></div><div class="line"><a name="l00029"></a><span class="lineno"><a class="line" href="../../dd/d29/class_o_n___font_metrics.html#a9f0b2b89127afdb35f994e648d816884"> 29</a></span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a> <a class="code" href="../../dd/d29/class_o_n___font_metrics.html#a9f0b2b89127afdb35f994e648d816884">Unset</a>;</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>&#160;</div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>&#160;<span class="comment"> ON_FontMetric::DefaultLineFeedRatio*ON_FontMetrics().AspectOfI()</span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span>&#160;<span class="comment"> can be used to cook up a line space value when using the </span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span>&#160;<span class="comment"> ON_FontMetrics.LineSpace() value defined by the font is</span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>&#160;<span class="comment"> not desired.</span></div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00037"></a><span class="lineno"><a class="line" href="../../dd/d29/class_o_n___font_metrics.html#abe44d95515dabcce5ed56759c7ab770f"> 37</a></span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">double</span> <a class="code" href="../../dd/d29/class_o_n___font_metrics.html#abe44d95515dabcce5ed56759c7ab770f">DefaultLineFeedRatio</a>; <span class="comment">// 1.6</span></div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span>&#160;</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span>&#160; <span class="comment">// UNICODE code point of the glyph used to determine HeightOfCapital()</span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span>&#160; <span class="comment">// when no reaonable value is available from the font definition.</span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span>&#160; <span class="comment">// Currently this is the &#39;I&#39; glyph. Opennurbs has used &#39;I&#39; since 2005.</span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>&#160; <span class="comment">// It is possible &#39;H&#39; would work as well. All other glyphs, in </span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>&#160; <span class="comment">// particular &#39;M&#39; and &#39;W&#39;, do not work.</span></div><div class="line"><a name="l00044"></a><span class="lineno"><a class="line" href="../../dd/d29/class_o_n___font_metrics.html#a09a14df60aa3a72ffa0580f2dc86fac1"> 44</a></span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> ON__UINT32 <a class="code" href="../../dd/d29/class_o_n___font_metrics.html#a09a14df60aa3a72ffa0580f2dc86fac1">HeightOfCapitalCodePoint</a>; <span class="comment">// &#39;I&#39;</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>&#160;</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>&#160;<span class="comment"> Signed distance from the baseline to highest point on a glyph outline.</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>&#160;<span class="comment"> If every glyph outline in the font has (0,0) on the basline, then Ascent() </span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span>&#160;<span class="comment"> is the maximum glyph bounding box Y.</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span>&#160; <span class="keywordtype">int</span> Ascent() <span class="keyword">const</span>;</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span>&#160;</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>&#160;<span class="comment"> Signed distance from the baseline to lowest point on a glyph outline.</span></div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>&#160;<span class="comment"> This value is typically negative because glyphs for letters like &#39;j&#39;</span></div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>&#160;<span class="comment"> typically have a portion of their outline below the baseline. However,</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>&#160;<span class="comment"> some fonts have positive descent.</span></div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>&#160;<span class="comment"> If every glyph outline in the font has (0,0) on the basline, then Ascent() </span></div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>&#160;<span class="comment"> is the maximum glyph bounding box Y.</span></div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>&#160; <span class="keywordtype">int</span> Descent() <span class="keyword">const</span>;</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>&#160;</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>&#160;<span class="comment"> The postive distance to move a base line when moving to a new line of text.</span></div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>&#160;<span class="comment"> For almost every font used to render text, LineSpace() &gt; (Ascent() - Descent()).</span></div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>&#160;<span class="comment"> This metric is sometimes called &quot;height&quot;, but that term is often confused</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>&#160;<span class="comment"> with (Ascent() - Descent()). </span></div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span>&#160;<span class="comment"> For fonts designed to render horizontal lines of text, LineSpace() is a </span></div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>&#160;<span class="comment"> vertical distance. For fonts desingned to render vertical lines of text,</span></div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>&#160;<span class="comment"> LineSpace() is a horizontal distance. Depending on the context, the </span></div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>&#160;<span class="comment"> direction to move can be up, down, left or right.</span></div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span>&#160; <span class="keywordtype">int</span> LineSpace() <span class="keyword">const</span>;</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>&#160;</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>&#160;<span class="comment"> The &quot;units per EM&quot;. This is the height and width of the square grid </span></div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>&#160;<span class="comment"> where the font glyphs are designed. </span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>&#160;<span class="comment"> The width of the &#39;M&#39; glyph in a font can be different from UPM.</span></div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>&#160;<span class="comment"> The height of the &#39;M&#39; glyph in a font is typically less than UPM.</span></div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>&#160;<span class="comment"> In TrueType fonts, UPM is often a power of two and generally 1024 or 2048.</span></div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>&#160;<span class="comment"> In OpenType fonts, UPM is often 1000.</span></div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>&#160;<span class="comment"> In PostScript fonts, UPM is often 1000.</span></div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>&#160; <span class="keywordtype">int</span> UPM() <span class="keyword">const</span>;</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>&#160;</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>&#160;<span class="comment"> The signed distance from the baseline to the highest point on the &#39;I&#39; glyph.</span></div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>&#160;<span class="comment"> The primary uses of AscentOfI() are:</span></div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>&#160;<span class="comment"> 1) </span></div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>&#160;<span class="comment"> Calculate a scale factor to produce text with a user specified &quot;text height&quot;.</span></div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span>&#160;<span class="comment"> 2) </span></div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>&#160;<span class="comment"> To calculate insertion location for ON::TextVerticalAlignment::Middle</span></div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>&#160;<span class="comment"> and ON::TextVerticalAlignment::Top.</span></div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span>&#160;<span class="comment"> Since 2005, opennurbs has used</span></div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>&#160;<span class="comment"> (user specified text height)/AscentOfI()</span></div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span>&#160;<span class="comment"> as the scale factor to render glyphs when user interface has provided </span></div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>&#160;<span class="comment"> a &quot;text height&quot; value. Users are more satisfied with this approach</span></div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>&#160;<span class="comment"> than when the scaling is base on line space or maximum font glyph ascent</span></div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>&#160;<span class="comment"> values. Experiments have ruled out the use of any other capital latin </span></div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span>&#160;<span class="comment"> letter glyph except &#39;H&#39; for this use. When a font does not contain an</span></div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>&#160;<span class="comment"> &#39;I&#39; glyph, a suitable value is returned that can be used for text height</span></div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>&#160;<span class="comment"> scaling and vertical alignment.</span></div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>&#160; <span class="keywordtype">int</span> AscentOfI() <span class="keyword">const</span>;</div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>&#160; </div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>&#160;<span class="comment"> Get the scale to apply to normalized glyph boxes and outlines to </span></div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>&#160;<span class="comment"> render the &#39;I&#39; in the glyph&#39;s font at a height of text_height.</span></div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span>&#160;<span class="comment"> text_height - [in]</span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>&#160;<span class="comment"> The desired height of typical capital latin letter glyphs.</span></div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>&#160;<span class="comment"> text_height / AscentOfI().</span></div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>&#160; <span class="keywordtype">double</span> GlyphScale(<span class="keywordtype">double</span> text_height) <span class="keyword">const</span>;</div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span>&#160; </div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>&#160;<span class="comment"> Thickness of strikeout.</span></div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>&#160;<span class="comment"> The signed distance from the baseline to the bottom of the strikeout </span></div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span>&#160;<span class="comment"> is StrikeoutPosition() - StrikeoutThickness()/2.</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>&#160; <span class="keywordtype">int</span> StrikeoutThickness() <span class="keyword">const</span>;</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span>&#160;</div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span>&#160;<span class="comment"> Signed distance from baseline to center of strikeout. </span></div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span>&#160;<span class="comment"> A positive value indicates the strikeout is above the baseline (common).</span></div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>&#160;<span class="comment"> The signed distance from the baseline to the bottom of the strikeout </span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>&#160;<span class="comment"> is StrikeoutPosition() - StrikeoutThickness()/2.</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span>&#160; <span class="keywordtype">int</span> StrikeoutPosition() <span class="keyword">const</span>;</div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>&#160;</div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>&#160;</div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span>&#160;<span class="comment"> Thickness of underscore</span></div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>&#160;<span class="comment"> The signed distance from the baseline to the bottom of the underscore</span></div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>&#160;<span class="comment"> is UnderscorePosition() - UnderscoreThickness()/2.</span></div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>&#160; <span class="keywordtype">int</span> UnderscoreThickness() <span class="keyword">const</span>;</div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>&#160; </div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>&#160;<span class="comment"> Signed distance from baseline to center of underscore.</span></div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>&#160;<span class="comment"> A negative value indicates the underscore is below the baseline (common).</span></div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>&#160;<span class="comment"> The signed distance from the baseline to the bottom of the underscore</span></div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span>&#160;<span class="comment"> is UnderscorePosition() - UnderscoreThickness()/2.</span></div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span>&#160; <span class="keywordtype">int</span> UnderscorePosition() <span class="keyword">const</span>; </div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span>&#160;</div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a> Scale(</div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>&#160; <span class="keyword">const</span> <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>&amp; font_metrics,</div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span>&#160; <span class="keywordtype">double</span> scale</div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>&#160; );</div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>&#160;</div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>&#160; <span class="keywordtype">void</span> SetHeights(</div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>&#160; <span class="keywordtype">int</span> ascent,</div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span>&#160; <span class="keywordtype">int</span> descent,</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span>&#160; <span class="keywordtype">int</span> UPM,</div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>&#160; <span class="keywordtype">int</span> line_space</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>&#160; );</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>&#160;</div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>&#160; <span class="keywordtype">bool</span> HeightsAreValid() <span class="keyword">const</span>;</div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span>&#160;</div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>&#160; <span class="keywordtype">void</span> SetAscentOfI(</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span>&#160; <span class="keywordtype">int</span> ascent_of_I</div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>&#160; );</div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span>&#160; </div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span>&#160; <span class="keywordtype">void</span> SetStrikeout(</div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span>&#160; <span class="keywordtype">int</span> strikeout_position,</div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span>&#160; <span class="keywordtype">int</span> strikeout_thickness</div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span>&#160; );</div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span>&#160; </div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span>&#160; <span class="keywordtype">void</span> SetUnderscore(</div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span>&#160; <span class="keywordtype">int</span> underscore_position,</div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span>&#160; <span class="keywordtype">int</span> underscore_thickness</div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span>&#160; );</div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span>&#160; </div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span>&#160; <span class="keywordtype">int</span> m_UPM = 0; <span class="comment">// units per EM</span></div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span>&#160; <span class="keywordtype">int</span> m_ascent = 0; <span class="comment">// max over all glyphs in font of (highest outline point - baseline point).y</span></div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>&#160; <span class="keywordtype">int</span> m_descent = 0; <span class="comment">// min over all glyphs in font of (lowest outline point - baseline point).y</span></div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span>&#160; <span class="keywordtype">int</span> m_line_space = 0; <span class="comment">// distance between baselines </span></div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span>&#160; <span class="keywordtype">int</span> m_ascent_of_I = 0; <span class="comment">// (highest &#39;I&#39; outline point - I baseline point).y</span></div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>&#160;</div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span>&#160; <span class="keywordtype">int</span> m_strikeout_thickness = 0; <span class="comment">//</span></div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>&#160; <span class="keywordtype">int</span> m_strikeout_position = 0; <span class="comment">// </span></div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span>&#160;</div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span>&#160; <span class="keywordtype">int</span> m_underscore_thickness = 0; <span class="comment">//</span></div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span>&#160; <span class="keywordtype">int</span> m_underscore_position = 0; <span class="comment">//</span></div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span>&#160;</div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span>&#160; <span class="keywordtype">int</span> m_reserved1 = 0;</div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span>&#160; <span class="keywordtype">double</span> m_reserved2 = 0.0;</div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span>&#160; <span class="keywordtype">double</span> m_reserved3 = 0.0;</div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span>&#160; ON__UINT_PTR m_reserved5 = 0;</div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span>&#160;};</div><div class="line"><a name="l00219"></a><span class="lineno"> 219</span>&#160;</div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00221"></a><span class="lineno"> 221</span>&#160;<span class="comment">/// &lt;summary&gt;</span></div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span>&#160;<span class="comment">/// An ON_Font is a face in a font family. It corresponds to a Windows LOGFONT,</span></div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span>&#160;<span class="comment">/// a .NET System.Drawing.Font or a FreeType FT_Face.</span></div><div class="line"><a name="l00224"></a><span class="lineno"> 224</span>&#160;<span class="comment">/// &lt;/summary&gt;</span></div><div class="line"><a name="l00225"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html"> 225</a></span>&#160;<span class="comment"></span><span class="keyword">class </span>ON_CLASS <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a></div><div class="line"><a name="l00226"></a><span class="lineno"> 226</span>&#160;{</div><div class="line"><a name="l00227"></a><span class="lineno"> 227</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00228"></a><span class="lineno"> 228</span>&#160;</div><div class="line"><a name="l00229"></a><span class="lineno"> 229</span>&#160;<span class="preprocessor">#pragma region RH_C_SHARED_ENUM [ON_Font::Weight] [Rhino.DocObjects.Font.FontWeight] [nested:byte]</span></div><div class="line"><a name="l00230"></a><span class="lineno"> 230</span>&#160;<span class="comment"> /// &lt;summary&gt;</span></div><div class="line"><a name="l00231"></a><span class="lineno"> 231</span>&#160;<span class="comment"></span><span class="comment"> /// Weight enum values</span></div><div class="line"><a name="l00232"></a><span class="lineno"> 232</span>&#160;<span class="comment"></span><span class="comment"> /// Avoid casting these values to int.</span></div><div class="line"><a name="l00233"></a><span class="lineno"> 233</span>&#160;<span class="comment"></span><span class="comment"> /// Use ON_Font::WindowsLogfontWeightFromWeight() or</span></div><div class="line"><a name="l00234"></a><span class="lineno"> 234</span>&#160;<span class="comment"></span><span class="comment"> /// ON_Font::AppleWeightOfFontFromWeight() or</span></div><div class="line"><a name="l00235"></a><span class="lineno"> 235</span>&#160;<span class="comment"></span><span class="comment"> /// add another converter.</span></div><div class="line"><a name="l00236"></a><span class="lineno"> 236</span>&#160;<span class="comment"></span><span class="comment"> /// &lt;/summary&gt;</span></div><div class="line"><a name="l00237"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d"> 237</a></span>&#160;<span class="comment"></span> <span class="keyword">enum class</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">Weight</a> : unsigned char</div><div class="line"><a name="l00238"></a><span class="lineno"> 238</span>&#160; {<span class="comment"></span></div><div class="line"><a name="l00239"></a><span class="lineno"> 239</span>&#160;<span class="comment"> /// &lt;summary&gt; Not set. &lt;/summary&gt;</span></div><div class="line"><a name="l00240"></a><span class="lineno"> 240</span>&#160;<span class="comment"></span> Unset = 0,</div><div class="line"><a name="l00241"></a><span class="lineno"> 241</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00242"></a><span class="lineno"> 242</span>&#160;<span class="comment"> /// &lt;summary&gt; IsLight = true &lt;/summary&gt;</span></div><div class="line"><a name="l00243"></a><span class="lineno"> 243</span>&#160;<span class="comment"></span> Thin = 1,</div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00245"></a><span class="lineno"> 245</span>&#160;<span class="comment"> /// &lt;summary&gt; IsLight = true &lt;/summary&gt;</span></div><div class="line"><a name="l00246"></a><span class="lineno"> 246</span>&#160;<span class="comment"></span> Ultralight = 2,</div><div class="line"><a name="l00247"></a><span class="lineno"> 247</span>&#160;</div><div class="line"><a name="l00248"></a><span class="lineno"> 248</span>&#160; <span class="comment">//ExtraLight = 2,</span></div><div class="line"><a name="l00249"></a><span class="lineno"> 249</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00250"></a><span class="lineno"> 250</span>&#160;<span class="comment"> /// &lt;summary&gt; IsLight = true &lt;/summary&gt;</span></div><div class="line"><a name="l00251"></a><span class="lineno"> 251</span>&#160;<span class="comment"></span> Light = 3,</div><div class="line"><a name="l00252"></a><span class="lineno"> 252</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00253"></a><span class="lineno"> 253</span>&#160;<span class="comment"> /// &lt;summary&gt; Default font weight. IsNormalWeight = true Also called Regular.&lt;/summary&gt;</span></div><div class="line"><a name="l00254"></a><span class="lineno"> 254</span>&#160;<span class="comment"></span> Normal = 4, </div><div class="line"><a name="l00255"></a><span class="lineno"> 255</span>&#160;</div><div class="line"><a name="l00256"></a><span class="lineno"> 256</span>&#160; <span class="comment">//Regular = 4,</span></div><div class="line"><a name="l00257"></a><span class="lineno"> 257</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00258"></a><span class="lineno"> 258</span>&#160;<span class="comment"> /// &lt;summary&gt; IsNormalWeight = true &lt;/summary&gt;</span></div><div class="line"><a name="l00259"></a><span class="lineno"> 259</span>&#160;<span class="comment"></span> Medium = 5,</div><div class="line"><a name="l00260"></a><span class="lineno"> 260</span>&#160; <span class="comment"></span></div><div class="line"><a name="l00261"></a><span class="lineno"> 261</span>&#160;<span class="comment"> /// &lt;summary&gt; IsBold = true &lt;/summary&gt;</span></div><div class="line"><a name="l00262"></a><span class="lineno"> 262</span>&#160;<span class="comment"></span> Semibold = 6,</div><div class="line"><a name="l00263"></a><span class="lineno"> 263</span>&#160;</div><div class="line"><a name="l00264"></a><span class="lineno"> 264</span>&#160; <span class="comment">//Demibold = 6,</span></div><div class="line"><a name="l00265"></a><span class="lineno"> 265</span>&#160; <span class="comment">//Demi = 6,</span></div><div class="line"><a name="l00266"></a><span class="lineno"> 266</span>&#160; <span class="comment">//Semi = 6,</span></div><div class="line"><a name="l00267"></a><span class="lineno"> 267</span>&#160; <span class="comment"></span></div><div class="line"><a name="l00268"></a><span class="lineno"> 268</span>&#160;<span class="comment"> /// &lt;summary&gt; IsBold = true &lt;/summary&gt;</span></div><div class="line"><a name="l00269"></a><span class="lineno"> 269</span>&#160;<span class="comment"></span> Bold = 7,</div><div class="line"><a name="l00270"></a><span class="lineno"> 270</span>&#160; <span class="comment"></span></div><div class="line"><a name="l00271"></a><span class="lineno"> 271</span>&#160;<span class="comment"> /// &lt;summary&gt; IsBold = true &lt;/summary&gt;</span></div><div class="line"><a name="l00272"></a><span class="lineno"> 272</span>&#160;<span class="comment"></span> Ultrabold = 8,</div><div class="line"><a name="l00273"></a><span class="lineno"> 273</span>&#160;</div><div class="line"><a name="l00274"></a><span class="lineno"> 274</span>&#160; <span class="comment">//ExtraBold = 8,</span></div><div class="line"><a name="l00275"></a><span class="lineno"> 275</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00276"></a><span class="lineno"> 276</span>&#160;<span class="comment"> /// &lt;summary&gt; IsBold = true Also called Black&lt;/summary&gt;</span></div><div class="line"><a name="l00277"></a><span class="lineno"> 277</span>&#160;<span class="comment"></span> Heavy = 9</div><div class="line"><a name="l00278"></a><span class="lineno"> 278</span>&#160;</div><div class="line"><a name="l00279"></a><span class="lineno"> 279</span>&#160; <span class="comment">//Black = 9,</span></div><div class="line"><a name="l00280"></a><span class="lineno"> 280</span>&#160; };</div><div class="line"><a name="l00281"></a><span class="lineno"> 281</span>&#160;<span class="preprocessor">#pragma endregion</span></div><div class="line"><a name="l00282"></a><span class="lineno"> 282</span>&#160;</div><div class="line"><a name="l00283"></a><span class="lineno"> 283</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00284"></a><span class="lineno"> 284</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00285"></a><span class="lineno"> 285</span>&#160;<span class="comment"> -1: weight_a is lighter, weight_b is heavier</span></div><div class="line"><a name="l00286"></a><span class="lineno"> 286</span>&#160;<span class="comment"> +1: weight_a is heavier, weight_b is lighter</span></div><div class="line"><a name="l00287"></a><span class="lineno"> 287</span>&#160;<span class="comment"> 0: weight_a = weight_b</span></div><div class="line"><a name="l00288"></a><span class="lineno"> 288</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00289"></a><span class="lineno"> 289</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> CompareWeight(</div><div class="line"><a name="l00290"></a><span class="lineno"> 290</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> weight_a,</div><div class="line"><a name="l00291"></a><span class="lineno"> 291</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> weight_b</div><div class="line"><a name="l00292"></a><span class="lineno"> 292</span>&#160; );</div><div class="line"><a name="l00293"></a><span class="lineno"> 293</span>&#160;</div><div class="line"><a name="l00294"></a><span class="lineno"> 294</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00295"></a><span class="lineno"> 295</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00296"></a><span class="lineno"> 296</span>&#160;<span class="comment"> In the rare cases when an ON_Font::Weight value must be passed</span></div><div class="line"><a name="l00297"></a><span class="lineno"> 297</span>&#160;<span class="comment"> as an unsigned int, use ON_Font::FontWeightFromUnsigned() to</span></div><div class="line"><a name="l00298"></a><span class="lineno"> 298</span>&#160;<span class="comment"> convert the unsigned value to an ON_Font::Weight value.</span></div><div class="line"><a name="l00299"></a><span class="lineno"> 299</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00300"></a><span class="lineno"> 300</span>&#160;<span class="comment"> unsigned_font_weight - [in]</span></div><div class="line"><a name="l00301"></a><span class="lineno"> 301</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00302"></a><span class="lineno"> 302</span>&#160; <span class="keyword">static</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> FontWeightFromUnsigned(</div><div class="line"><a name="l00303"></a><span class="lineno"> 303</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> unsigned_font_weight</div><div class="line"><a name="l00304"></a><span class="lineno"> 304</span>&#160; );</div><div class="line"><a name="l00305"></a><span class="lineno"> 305</span>&#160;</div><div class="line"><a name="l00306"></a><span class="lineno"> 306</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00307"></a><span class="lineno"> 307</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00308"></a><span class="lineno"> 308</span>&#160;<span class="comment"> The correspondence between Windows LOGFONT lfWeight values and</span></div><div class="line"><a name="l00309"></a><span class="lineno"> 309</span>&#160;<span class="comment"> ON_Font::Weight enum values is</span></div><div class="line"><a name="l00310"></a><span class="lineno"> 310</span>&#160;<span class="comment"> ON_Font::Weight::Thin = 100 LOGFONT lfWeight</span></div><div class="line"><a name="l00311"></a><span class="lineno"> 311</span>&#160;<span class="comment"> ON_Font::Weight::Ultralight = 200 LOGFONT lfWeight</span></div><div class="line"><a name="l00312"></a><span class="lineno"> 312</span>&#160;<span class="comment"> ON_Font::Weight::Light = 300 LOGFONT lfWeight</span></div><div class="line"><a name="l00313"></a><span class="lineno"> 313</span>&#160;<span class="comment"> ON_Font::Weight::Normal = 400 LOGFONT lfWeight</span></div><div class="line"><a name="l00314"></a><span class="lineno"> 314</span>&#160;<span class="comment"> ON_Font::Weight::Medium = 500 LOGFONT lfWeight</span></div><div class="line"><a name="l00315"></a><span class="lineno"> 315</span>&#160;<span class="comment"> ON_Font::Weight::Semibold = 600 LOGFONT lfWeight</span></div><div class="line"><a name="l00316"></a><span class="lineno"> 316</span>&#160;<span class="comment"> ON_Font::Weight::Bold = 700 LOGFONT lfWeight</span></div><div class="line"><a name="l00317"></a><span class="lineno"> 317</span>&#160;<span class="comment"> ON_Font::Weight::Ultrabold = 800 LOGFONT lfWeight</span></div><div class="line"><a name="l00318"></a><span class="lineno"> 318</span>&#160;<span class="comment"> ON_Font::Weight::Heavy = 900 LOGFONT lfWeight</span></div><div class="line"><a name="l00319"></a><span class="lineno"> 319</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00320"></a><span class="lineno"> 320</span>&#160;<span class="comment"> The Windows LOGFONT lfWeight value that corresponds to the ON_Font::Weight enum value.</span></div><div class="line"><a name="l00321"></a><span class="lineno"> 321</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00322"></a><span class="lineno"> 322</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> WindowsLogfontWeightFromWeight(</div><div class="line"><a name="l00323"></a><span class="lineno"> 323</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight</div><div class="line"><a name="l00324"></a><span class="lineno"> 324</span>&#160; );</div><div class="line"><a name="l00325"></a><span class="lineno"> 325</span>&#160;</div><div class="line"><a name="l00326"></a><span class="lineno"> 326</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00327"></a><span class="lineno"> 327</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00328"></a><span class="lineno"> 328</span>&#160;<span class="comment"> The correspondence between Apple &quot;weight of font&quot; values and</span></div><div class="line"><a name="l00329"></a><span class="lineno"> 329</span>&#160;<span class="comment"> ON_Font::Weight enum values is</span></div><div class="line"><a name="l00330"></a><span class="lineno"> 330</span>&#160;<span class="comment"> ON_Font::Weight::Thin = 1</span></div><div class="line"><a name="l00331"></a><span class="lineno"> 331</span>&#160;<span class="comment"> ON_Font::Weight::Ultralight = 2</span></div><div class="line"><a name="l00332"></a><span class="lineno"> 332</span>&#160;<span class="comment"> ON_Font::Weight::Light = 3</span></div><div class="line"><a name="l00333"></a><span class="lineno"> 333</span>&#160;<span class="comment"> ON_Font::Weight::Normal = 4 </span></div><div class="line"><a name="l00334"></a><span class="lineno"> 334</span>&#160;<span class="comment"> ON_Font::Weight::Medium = 5</span></div><div class="line"><a name="l00335"></a><span class="lineno"> 335</span>&#160;<span class="comment"> ON_Font::Weight::Semibold = 6</span></div><div class="line"><a name="l00336"></a><span class="lineno"> 336</span>&#160;<span class="comment"> ON_Font::Weight::Bold = 7</span></div><div class="line"><a name="l00337"></a><span class="lineno"> 337</span>&#160;<span class="comment"> ON_Font::Weight::Ultrabold = 8</span></div><div class="line"><a name="l00338"></a><span class="lineno"> 338</span>&#160;<span class="comment"> ON_Font::Weight::Heavy = 9</span></div><div class="line"><a name="l00339"></a><span class="lineno"> 339</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00340"></a><span class="lineno"> 340</span>&#160;<span class="comment"> The Apple &quot;weight of font&quot; value that corresponds to the ON_Font::Weight enum value.</span></div><div class="line"><a name="l00341"></a><span class="lineno"> 341</span>&#160;<span class="comment"> */</span> </div><div class="line"><a name="l00342"></a><span class="lineno"> 342</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> AppleWeightOfFontFromWeight(</div><div class="line"><a name="l00343"></a><span class="lineno"> 343</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight</div><div class="line"><a name="l00344"></a><span class="lineno"> 344</span>&#160; );</div><div class="line"><a name="l00345"></a><span class="lineno"> 345</span>&#160;</div><div class="line"><a name="l00346"></a><span class="lineno"> 346</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00347"></a><span class="lineno"> 347</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00348"></a><span class="lineno"> 348</span>&#160;<span class="comment"> The correspondence between Apple &quot;font weight trait&quot; values and</span></div><div class="line"><a name="l00349"></a><span class="lineno"> 349</span>&#160;<span class="comment"> ON_Font::Weight enum values is</span></div><div class="line"><a name="l00350"></a><span class="lineno"> 350</span>&#160;<span class="comment"> ON_Font::Weight::Thin = -0.4 Apple font weight trait</span></div><div class="line"><a name="l00351"></a><span class="lineno"> 351</span>&#160;<span class="comment"> ON_Font::Weight::Ultralight = -0.2667 Apple font weight trait</span></div><div class="line"><a name="l00352"></a><span class="lineno"> 352</span>&#160;<span class="comment"> ON_Font::Weight::Light = -0.1333 Apple font weight trait</span></div><div class="line"><a name="l00353"></a><span class="lineno"> 353</span>&#160;<span class="comment"> ON_Font::Weight::Normal = 0.0 Apple font weight trait</span></div><div class="line"><a name="l00354"></a><span class="lineno"> 354</span>&#160;<span class="comment"> ON_Font::Weight::Medium = 0.1333 Apple font weight trait</span></div><div class="line"><a name="l00355"></a><span class="lineno"> 355</span>&#160;<span class="comment"> ON_Font::Weight::Semibold = 0.2667 Apple font weight trait</span></div><div class="line"><a name="l00356"></a><span class="lineno"> 356</span>&#160;<span class="comment"> ON_Font::Weight::Bold = 0.4 Apple font weight trait</span></div><div class="line"><a name="l00357"></a><span class="lineno"> 357</span>&#160;<span class="comment"> ON_Font::Weight::Ultrabold = 0.5333 Apple font weight trait</span></div><div class="line"><a name="l00358"></a><span class="lineno"> 358</span>&#160;<span class="comment"> ON_Font::Weight::Heavy = 0.6667 Apple font weight trait</span></div><div class="line"><a name="l00359"></a><span class="lineno"> 359</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00360"></a><span class="lineno"> 360</span>&#160;<span class="comment"> The Apple &quot;NSFontWeightTrait&quot; value that corresponds to the ON_Font::Weight enum value.</span></div><div class="line"><a name="l00361"></a><span class="lineno"> 361</span>&#160;<span class="comment"> */</span> </div><div class="line"><a name="l00362"></a><span class="lineno"> 362</span>&#160; <span class="keyword">static</span> <span class="keywordtype">double</span> AppleFontWeightTraitFromWeight(</div><div class="line"><a name="l00363"></a><span class="lineno"> 363</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight</div><div class="line"><a name="l00364"></a><span class="lineno"> 364</span>&#160; );</div><div class="line"><a name="l00365"></a><span class="lineno"> 365</span>&#160;</div><div class="line"><a name="l00366"></a><span class="lineno"> 366</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00367"></a><span class="lineno"> 367</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00368"></a><span class="lineno"> 368</span>&#160;<span class="comment"> The correspondence between Windows LOGFONT lfWeight values and</span></div><div class="line"><a name="l00369"></a><span class="lineno"> 369</span>&#160;<span class="comment"> ON_Font::Weight enum values is</span></div><div class="line"><a name="l00370"></a><span class="lineno"> 370</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00371"></a><span class="lineno"> 371</span>&#160;<span class="comment"> ON_Font::Weight::Thin = 100</span></div><div class="line"><a name="l00372"></a><span class="lineno"> 372</span>&#160;<span class="comment"> ON_Font::Weight::Ultralight = 200</span></div><div class="line"><a name="l00373"></a><span class="lineno"> 373</span>&#160;<span class="comment"> ON_Font::Weight::Light = 300</span></div><div class="line"><a name="l00374"></a><span class="lineno"> 374</span>&#160;<span class="comment"> ON_Font::Weight::Normal = 400</span></div><div class="line"><a name="l00375"></a><span class="lineno"> 375</span>&#160;<span class="comment"> ON_Font::Weight::Medium = 500</span></div><div class="line"><a name="l00376"></a><span class="lineno"> 376</span>&#160;<span class="comment"> ON_Font::Weight::Semibold = 600</span></div><div class="line"><a name="l00377"></a><span class="lineno"> 377</span>&#160;<span class="comment"> ON_Font::Weight::Bold = 700</span></div><div class="line"><a name="l00378"></a><span class="lineno"> 378</span>&#160;<span class="comment"> ON_Font::Weight::Ultrabold = 800</span></div><div class="line"><a name="l00379"></a><span class="lineno"> 379</span>&#160;<span class="comment"> ON_Font::Weight::Heavy = 900</span></div><div class="line"><a name="l00380"></a><span class="lineno"> 380</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00381"></a><span class="lineno"> 381</span>&#160;<span class="comment"> The best ON_Font::Weight enum value for the Windows LOGFONT weight.</span></div><div class="line"><a name="l00382"></a><span class="lineno"> 382</span>&#160;<span class="comment"> */</span> </div><div class="line"><a name="l00383"></a><span class="lineno"> 383</span>&#160;</div><div class="line"><a name="l00384"></a><span class="lineno"> 384</span>&#160; <span class="keyword">static</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> WeightFromWindowsLogfontWeight(</div><div class="line"><a name="l00385"></a><span class="lineno"> 385</span>&#160; <span class="keywordtype">int</span> windows_logfont_weight</div><div class="line"><a name="l00386"></a><span class="lineno"> 386</span>&#160; );</div><div class="line"><a name="l00387"></a><span class="lineno"> 387</span>&#160;</div><div class="line"><a name="l00388"></a><span class="lineno"> 388</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00389"></a><span class="lineno"> 389</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00390"></a><span class="lineno"> 390</span>&#160;<span class="comment"> The correspondence between Apple &quot;weight of font&quot; values and</span></div><div class="line"><a name="l00391"></a><span class="lineno"> 391</span>&#160;<span class="comment"> ON_Font::Weight enum values is</span></div><div class="line"><a name="l00392"></a><span class="lineno"> 392</span>&#160;<span class="comment"> ON_Font::Weight::Thin = 1</span></div><div class="line"><a name="l00393"></a><span class="lineno"> 393</span>&#160;<span class="comment"> ON_Font::Weight::Ultralight = 2</span></div><div class="line"><a name="l00394"></a><span class="lineno"> 394</span>&#160;<span class="comment"> ON_Font::Weight::Light = 3</span></div><div class="line"><a name="l00395"></a><span class="lineno"> 395</span>&#160;<span class="comment"> ON_Font::Weight::Normal = 4 </span></div><div class="line"><a name="l00396"></a><span class="lineno"> 396</span>&#160;<span class="comment"> ON_Font::Weight::Medium = 5</span></div><div class="line"><a name="l00397"></a><span class="lineno"> 397</span>&#160;<span class="comment"> ON_Font::Weight::Semibold = 6</span></div><div class="line"><a name="l00398"></a><span class="lineno"> 398</span>&#160;<span class="comment"> ON_Font::Weight::Bold = 7</span></div><div class="line"><a name="l00399"></a><span class="lineno"> 399</span>&#160;<span class="comment"> ON_Font::Weight::Ultrabold = 8</span></div><div class="line"><a name="l00400"></a><span class="lineno"> 400</span>&#160;<span class="comment"> ON_Font::Weight::Heavy = 9</span></div><div class="line"><a name="l00401"></a><span class="lineno"> 401</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00402"></a><span class="lineno"> 402</span>&#160;<span class="comment"> The best ON_Font::Weight enum value for the Apple weight of font.</span></div><div class="line"><a name="l00403"></a><span class="lineno"> 403</span>&#160;<span class="comment"> */</span> </div><div class="line"><a name="l00404"></a><span class="lineno"> 404</span>&#160; <span class="keyword">static</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> WeightFromAppleWeightOfFont(</div><div class="line"><a name="l00405"></a><span class="lineno"> 405</span>&#160; <span class="keywordtype">int</span> apple_weight_of_font</div><div class="line"><a name="l00406"></a><span class="lineno"> 406</span>&#160; );</div><div class="line"><a name="l00407"></a><span class="lineno"> 407</span>&#160;</div><div class="line"><a name="l00408"></a><span class="lineno"> 408</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00409"></a><span class="lineno"> 409</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00410"></a><span class="lineno"> 410</span>&#160;<span class="comment"> apple_font_weight_trait - [in]</span></div><div class="line"><a name="l00411"></a><span class="lineno"> 411</span>&#160;<span class="comment"> Apple NSFontWeightTrait</span></div><div class="line"><a name="l00412"></a><span class="lineno"> 412</span>&#160;<span class="comment"> The valid value range is from -1.0 to 1.0. The value of 0.0 corresponds to the regular or medium font weight.</span></div><div class="line"><a name="l00413"></a><span class="lineno"> 413</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00414"></a><span class="lineno"> 414</span>&#160; <span class="keyword">static</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> WeightFromAppleFontWeightTrait(</div><div class="line"><a name="l00415"></a><span class="lineno"> 415</span>&#160; <span class="keywordtype">double</span> apple_font_weight_trait</div><div class="line"><a name="l00416"></a><span class="lineno"> 416</span>&#160; );</div><div class="line"><a name="l00417"></a><span class="lineno"> 417</span>&#160;</div><div class="line"><a name="l00418"></a><span class="lineno"> 418</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* WeightToWideString(</div><div class="line"><a name="l00419"></a><span class="lineno"> 419</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight</div><div class="line"><a name="l00420"></a><span class="lineno"> 420</span>&#160; );</div><div class="line"><a name="l00421"></a><span class="lineno"> 421</span>&#160;</div><div class="line"><a name="l00422"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1"> 422</a></span>&#160;</div><div class="line"><a name="l00423"></a><span class="lineno"> 423</span>&#160;</div><div class="line"><a name="l00424"></a><span class="lineno"> 424</span>&#160;<span class="preprocessor">#pragma region RH_C_SHARED_ENUM [ON_Font::Stretch] [Rhino.DocObjects.Font.FontStretch] [nested:byte]</span></div><div class="line"><a name="l00425"></a><span class="lineno"> 425</span>&#160;<span class="comment"> /// &lt;summary&gt;</span></div><div class="line"><a name="l00426"></a><span class="lineno"> 426</span>&#160;<span class="comment"></span><span class="comment"> /// Horizontal expansion or contraction of font</span></div><div class="line"><a name="l00427"></a><span class="lineno"> 427</span>&#160;<span class="comment"></span><span class="comment"> /// &lt;/summary&gt;</span></div><div class="line"><a name="l00428"></a><span class="lineno"> 428</span>&#160;<span class="comment"></span> <span class="keyword">enum class</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">Stretch</a> : unsigned char</div><div class="line"><a name="l00429"></a><span class="lineno"> 429</span>&#160; {<span class="comment"></span></div><div class="line"><a name="l00430"></a><span class="lineno"> 430</span>&#160;<span class="comment"> /// &lt;summary&gt; Not set. &lt;/summary&gt;</span></div><div class="line"><a name="l00431"></a><span class="lineno"> 431</span>&#160;<span class="comment"></span> Unset = 0,<span class="comment"></span></div><div class="line"><a name="l00432"></a><span class="lineno"> 432</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00433"></a><span class="lineno"> 433</span>&#160;<span class="comment"></span> Ultracondensed = 1,<span class="comment"></span></div><div class="line"><a name="l00434"></a><span class="lineno"> 434</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00435"></a><span class="lineno"> 435</span>&#160;<span class="comment"></span> Extracondensed = 2,<span class="comment"></span></div><div class="line"><a name="l00436"></a><span class="lineno"> 436</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00437"></a><span class="lineno"> 437</span>&#160;<span class="comment"></span> Condensed = 3,<span class="comment"></span></div><div class="line"><a name="l00438"></a><span class="lineno"> 438</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00439"></a><span class="lineno"> 439</span>&#160;<span class="comment"></span> Semicondensed = 4,</div><div class="line"><a name="l00440"></a><span class="lineno"> 440</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00441"></a><span class="lineno"> 441</span>&#160;<span class="comment"> /// &lt;summary&gt; Default font stretch. &lt;/summary&gt;</span></div><div class="line"><a name="l00442"></a><span class="lineno"> 442</span>&#160;<span class="comment"></span> Medium = 5,</div><div class="line"><a name="l00443"></a><span class="lineno"> 443</span>&#160;</div><div class="line"><a name="l00444"></a><span class="lineno"> 444</span>&#160; <span class="comment">//Normal = 5,</span></div><div class="line"><a name="l00445"></a><span class="lineno"> 445</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00446"></a><span class="lineno"> 446</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00447"></a><span class="lineno"> 447</span>&#160;<span class="comment"></span> Semiexpanded = 6,<span class="comment"></span></div><div class="line"><a name="l00448"></a><span class="lineno"> 448</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00449"></a><span class="lineno"> 449</span>&#160;<span class="comment"></span> Expanded = 7,<span class="comment"></span></div><div class="line"><a name="l00450"></a><span class="lineno"> 450</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00451"></a><span class="lineno"> 451</span>&#160;<span class="comment"></span> Extraexpanded = 8,<span class="comment"></span></div><div class="line"><a name="l00452"></a><span class="lineno"> 452</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00453"></a><span class="lineno"> 453</span>&#160;<span class="comment"></span> Ultraexpanded = 9</div><div class="line"><a name="l00454"></a><span class="lineno"> 454</span>&#160; };</div><div class="line"><a name="l00455"></a><span class="lineno"> 455</span>&#160;<span class="preprocessor">#pragma endregion</span></div><div class="line"><a name="l00456"></a><span class="lineno"> 456</span>&#160;</div><div class="line"><a name="l00457"></a><span class="lineno"> 457</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00458"></a><span class="lineno"> 458</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00459"></a><span class="lineno"> 459</span>&#160;<span class="comment"> In the rare cases when an ON_Font::Stretch value must be passed</span></div><div class="line"><a name="l00460"></a><span class="lineno"> 460</span>&#160;<span class="comment"> as an unsigned int, use ON_Font::FontStretchFromUnsigned() to</span></div><div class="line"><a name="l00461"></a><span class="lineno"> 461</span>&#160;<span class="comment"> convert the unsigned value to an ON_Font::Stretch value.</span></div><div class="line"><a name="l00462"></a><span class="lineno"> 462</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00463"></a><span class="lineno"> 463</span>&#160;<span class="comment"> unsigned_font_stretch - [in]</span></div><div class="line"><a name="l00464"></a><span class="lineno"> 464</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00465"></a><span class="lineno"> 465</span>&#160; <span class="keyword">static</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a> FontStretchFromUnsigned(</div><div class="line"><a name="l00466"></a><span class="lineno"> 466</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> unsigned_font_stretch</div><div class="line"><a name="l00467"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277"> 467</a></span>&#160; );</div><div class="line"><a name="l00468"></a><span class="lineno"> 468</span>&#160;</div><div class="line"><a name="l00469"></a><span class="lineno"> 469</span>&#160;</div><div class="line"><a name="l00470"></a><span class="lineno"> 470</span>&#160;<span class="preprocessor">#pragma region RH_C_SHARED_ENUM [ON_Font::Style] [Rhino.DocObjects.Font.FontStyle] [nested:byte]</span></div><div class="line"><a name="l00471"></a><span class="lineno"> 471</span>&#160;<span class="comment"> /// &lt;summary&gt;</span></div><div class="line"><a name="l00472"></a><span class="lineno"> 472</span>&#160;<span class="comment"></span><span class="comment"> /// Vertical angle of font</span></div><div class="line"><a name="l00473"></a><span class="lineno"> 473</span>&#160;<span class="comment"></span><span class="comment"> /// Upright, Italic, or Oblique</span></div><div class="line"><a name="l00474"></a><span class="lineno"> 474</span>&#160;<span class="comment"></span><span class="comment"> /// &lt;/summary&gt;</span></div><div class="line"><a name="l00475"></a><span class="lineno"> 475</span>&#160;<span class="comment"></span> <span class="keyword">enum class</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">Style</a> : unsigned char</div><div class="line"><a name="l00476"></a><span class="lineno"> 476</span>&#160; {<span class="comment"></span></div><div class="line"><a name="l00477"></a><span class="lineno"> 477</span>&#160;<span class="comment"> /// &lt;summary&gt; Not set. &lt;/summary&gt;</span></div><div class="line"><a name="l00478"></a><span class="lineno"> 478</span>&#160;<span class="comment"></span> Unset = 0,</div><div class="line"><a name="l00479"></a><span class="lineno"> 479</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00480"></a><span class="lineno"> 480</span>&#160;<span class="comment"> /// &lt;summary&gt; Default font style. &lt;/summary&gt;</span></div><div class="line"><a name="l00481"></a><span class="lineno"> 481</span>&#160;<span class="comment"></span> Upright = 1,</div><div class="line"><a name="l00482"></a><span class="lineno"> 482</span>&#160;</div><div class="line"><a name="l00483"></a><span class="lineno"> 483</span>&#160; <span class="comment">//Normal = 1,</span></div><div class="line"><a name="l00484"></a><span class="lineno"> 484</span>&#160; <span class="comment">//Roman = 1,</span></div><div class="line"><a name="l00485"></a><span class="lineno"> 485</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00486"></a><span class="lineno"> 486</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00487"></a><span class="lineno"> 487</span>&#160;<span class="comment"></span> Italic = 2,</div><div class="line"><a name="l00488"></a><span class="lineno"> 488</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00489"></a><span class="lineno"> 489</span>&#160;<span class="comment"> /// &lt;summary&gt; &lt;/summary&gt;</span></div><div class="line"><a name="l00490"></a><span class="lineno"> 490</span>&#160;<span class="comment"></span> Oblique = 3</div><div class="line"><a name="l00491"></a><span class="lineno"> 491</span>&#160; };</div><div class="line"><a name="l00492"></a><span class="lineno"> 492</span>&#160;<span class="preprocessor">#pragma endregion</span></div><div class="line"><a name="l00493"></a><span class="lineno"> 493</span>&#160;</div><div class="line"><a name="l00494"></a><span class="lineno"> 494</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00495"></a><span class="lineno"> 495</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00496"></a><span class="lineno"> 496</span>&#160;<span class="comment"> In the rare cases when an ON_Font::Style value must be passed</span></div><div class="line"><a name="l00497"></a><span class="lineno"> 497</span>&#160;<span class="comment"> as an unsigned int, use ON_Font::FontStyleFromUnsigned() to</span></div><div class="line"><a name="l00498"></a><span class="lineno"> 498</span>&#160;<span class="comment"> convert the unsigned value to an ON_Font::Style value.</span></div><div class="line"><a name="l00499"></a><span class="lineno"> 499</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00500"></a><span class="lineno"> 500</span>&#160;<span class="comment"> unsigned_font_style - [in]</span></div><div class="line"><a name="l00501"></a><span class="lineno"> 501</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00502"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a05c94f6c57071525f59916a874b007e8"> 502</a></span>&#160; <span class="keyword">static</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> FontStyleFromUnsigned(</div><div class="line"><a name="l00503"></a><span class="lineno"> 503</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> unsigned_font_style</div><div class="line"><a name="l00504"></a><span class="lineno"> 504</span>&#160; );</div><div class="line"><a name="l00505"></a><span class="lineno"> 505</span>&#160;</div><div class="line"><a name="l00506"></a><span class="lineno"> 506</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* StyleToWideString(</div><div class="line"><a name="l00507"></a><span class="lineno"> 507</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style</div><div class="line"><a name="l00508"></a><span class="lineno"> 508</span>&#160; );</div><div class="line"><a name="l00509"></a><span class="lineno"> 509</span>&#160;</div><div class="line"><a name="l00510"></a><span class="lineno"> 510</span>&#160;</div><div class="line"><a name="l00511"></a><span class="lineno"> 511</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00512"></a><span class="lineno"> 512</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a> Default;</div><div class="line"><a name="l00513"></a><span class="lineno"> 513</span>&#160; <span class="keyword">static</span> <span class="keywordtype">bool</span> IsValidFaceName(</div><div class="line"><a name="l00514"></a><span class="lineno"> 514</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name</div><div class="line"><a name="l00515"></a><span class="lineno"> 515</span>&#160; );</div><div class="line"><a name="l00516"></a><span class="lineno"> 516</span>&#160; </div><div class="line"><a name="l00517"></a><span class="lineno"> 517</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l00518"></a><span class="lineno"> 518</span>&#160; <span class="comment">// This private constructor is used to construct ON_Font::Default and managed fonts.</span></div><div class="line"><a name="l00519"></a><span class="lineno"> 519</span>&#160; <span class="comment">// Never make this constructor protected or public.</span></div><div class="line"><a name="l00520"></a><span class="lineno"> 520</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>(</div><div class="line"><a name="l00521"></a><span class="lineno"> 521</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> managed_status, <span class="comment">// 0 = no, 1 = ON_Font::Default, 2 = managed</span></div><div class="line"><a name="l00522"></a><span class="lineno"> 522</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; src</div><div class="line"><a name="l00523"></a><span class="lineno"> 523</span>&#160; );</div><div class="line"><a name="l00524"></a><span class="lineno"> 524</span>&#160;</div><div class="line"><a name="l00525"></a><span class="lineno"> 525</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l00526"></a><span class="lineno"> 526</span>&#160; <span class="comment">// Use ON_Font( const ON_Font&amp; ) or ON_Font::operator= if you need to make a copy.</span></div><div class="line"><a name="l00527"></a><span class="lineno"> 527</span>&#160; <span class="comment">// Never make CopyHelper protected or public.</span></div><div class="line"><a name="l00528"></a><span class="lineno"> 528</span>&#160; <span class="keywordtype">void</span> CopyHelper(</div><div class="line"><a name="l00529"></a><span class="lineno"> 529</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp;</div><div class="line"><a name="l00530"></a><span class="lineno"> 530</span>&#160; );</div><div class="line"><a name="l00531"></a><span class="lineno"> 531</span>&#160;</div><div class="line"><a name="l00532"></a><span class="lineno"> 532</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00533"></a><span class="lineno"> 533</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00534"></a><span class="lineno"> 534</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00535"></a><span class="lineno"> 535</span>&#160;<span class="comment"> Get a font managed by the application from the font characteristics.</span></div><div class="line"><a name="l00536"></a><span class="lineno"> 536</span>&#160;<span class="comment"> Never delete a font returned by GetManagedFont().</span></div><div class="line"><a name="l00537"></a><span class="lineno"> 537</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00538"></a><span class="lineno"> 538</span>&#160;<span class="comment"> face_name - [in]</span></div><div class="line"><a name="l00539"></a><span class="lineno"> 539</span>&#160;<span class="comment"> font_weight - [in]</span></div><div class="line"><a name="l00540"></a><span class="lineno"> 540</span>&#160;<span class="comment"> default = ON_Font::Default.FontWeight()</span></div><div class="line"><a name="l00541"></a><span class="lineno"> 541</span>&#160;<span class="comment"> font_style - [in]</span></div><div class="line"><a name="l00542"></a><span class="lineno"> 542</span>&#160;<span class="comment"> default = ON_Font::Default.FontStyle()</span></div><div class="line"><a name="l00543"></a><span class="lineno"> 543</span>&#160;<span class="comment"> font_stretch - [in]</span></div><div class="line"><a name="l00544"></a><span class="lineno"> 544</span>&#160;<span class="comment"> default = ON_Font::Default.FontStretch()</span></div><div class="line"><a name="l00545"></a><span class="lineno"> 545</span>&#160;<span class="comment"> bUnderlined - [in]</span></div><div class="line"><a name="l00546"></a><span class="lineno"> 546</span>&#160;<span class="comment"> default = ON_Font::Default.Underlined() = false</span></div><div class="line"><a name="l00547"></a><span class="lineno"> 547</span>&#160;<span class="comment"> bStrikethrough - [in]</span></div><div class="line"><a name="l00548"></a><span class="lineno"> 548</span>&#160;<span class="comment"> default = ON_Font::Default.Strikethrough() = false</span></div><div class="line"><a name="l00549"></a><span class="lineno"> 549</span>&#160;<span class="comment"> linefeed_ratio - [in]</span></div><div class="line"><a name="l00550"></a><span class="lineno"> 550</span>&#160;<span class="comment"> default = ON_Font::Default.LinefeedRatio()</span></div><div class="line"><a name="l00551"></a><span class="lineno"> 551</span>&#160;<span class="comment"> windows_charset - [in]</span></div><div class="line"><a name="l00552"></a><span class="lineno"> 552</span>&#160;<span class="comment"> default = ON_Font::WindowsCharSet::DefaultCharSet</span></div><div class="line"><a name="l00553"></a><span class="lineno"> 553</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00554"></a><span class="lineno"> 554</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00555"></a><span class="lineno"> 555</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name</div><div class="line"><a name="l00556"></a><span class="lineno"> 556</span>&#160; );</div><div class="line"><a name="l00557"></a><span class="lineno"> 557</span>&#160;</div><div class="line"><a name="l00558"></a><span class="lineno"> 558</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00559"></a><span class="lineno"> 559</span>&#160; <span class="keywordtype">double</span> point_size,</div><div class="line"><a name="l00560"></a><span class="lineno"> 560</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name</div><div class="line"><a name="l00561"></a><span class="lineno"> 561</span>&#160; );</div><div class="line"><a name="l00562"></a><span class="lineno"> 562</span>&#160;</div><div class="line"><a name="l00563"></a><span class="lineno"> 563</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00564"></a><span class="lineno"> 564</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00565"></a><span class="lineno"> 565</span>&#160; <span class="keywordtype">bool</span> bBold</div><div class="line"><a name="l00566"></a><span class="lineno"> 566</span>&#160; );</div><div class="line"><a name="l00567"></a><span class="lineno"> 567</span>&#160;</div><div class="line"><a name="l00568"></a><span class="lineno"> 568</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00569"></a><span class="lineno"> 569</span>&#160; <span class="keywordtype">double</span> point_size,</div><div class="line"><a name="l00570"></a><span class="lineno"> 570</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00571"></a><span class="lineno"> 571</span>&#160; <span class="keywordtype">bool</span> bBold</div><div class="line"><a name="l00572"></a><span class="lineno"> 572</span>&#160; );</div><div class="line"><a name="l00573"></a><span class="lineno"> 573</span>&#160;</div><div class="line"><a name="l00574"></a><span class="lineno"> 574</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00575"></a><span class="lineno"> 575</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00576"></a><span class="lineno"> 576</span>&#160; <span class="keywordtype">bool</span> bBold,</div><div class="line"><a name="l00577"></a><span class="lineno"> 577</span>&#160; <span class="keywordtype">bool</span> bItalic</div><div class="line"><a name="l00578"></a><span class="lineno"> 578</span>&#160; );</div><div class="line"><a name="l00579"></a><span class="lineno"> 579</span>&#160;</div><div class="line"><a name="l00580"></a><span class="lineno"> 580</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00581"></a><span class="lineno"> 581</span>&#160; <span class="keywordtype">double</span> point_size,</div><div class="line"><a name="l00582"></a><span class="lineno"> 582</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00583"></a><span class="lineno"> 583</span>&#160; <span class="keywordtype">bool</span> bBold,</div><div class="line"><a name="l00584"></a><span class="lineno"> 584</span>&#160; <span class="keywordtype">bool</span> bItalic</div><div class="line"><a name="l00585"></a><span class="lineno"> 585</span>&#160; );</div><div class="line"><a name="l00586"></a><span class="lineno"> 586</span>&#160;</div><div class="line"><a name="l00587"></a><span class="lineno"> 587</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00588"></a><span class="lineno"> 588</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name, </div><div class="line"><a name="l00589"></a><span class="lineno"> 589</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00590"></a><span class="lineno"> 590</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style</div><div class="line"><a name="l00591"></a><span class="lineno"> 591</span>&#160; );</div><div class="line"><a name="l00592"></a><span class="lineno"> 592</span>&#160;</div><div class="line"><a name="l00593"></a><span class="lineno"> 593</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00594"></a><span class="lineno"> 594</span>&#160; <span class="keywordtype">double</span> point_size,</div><div class="line"><a name="l00595"></a><span class="lineno"> 595</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name, </div><div class="line"><a name="l00596"></a><span class="lineno"> 596</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00597"></a><span class="lineno"> 597</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style</div><div class="line"><a name="l00598"></a><span class="lineno"> 598</span>&#160; );</div><div class="line"><a name="l00599"></a><span class="lineno"> 599</span>&#160;</div><div class="line"><a name="l00600"></a><span class="lineno"> 600</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00601"></a><span class="lineno"> 601</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name, </div><div class="line"><a name="l00602"></a><span class="lineno"> 602</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00603"></a><span class="lineno"> 603</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style,</div><div class="line"><a name="l00604"></a><span class="lineno"> 604</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a> font_stretch,</div><div class="line"><a name="l00605"></a><span class="lineno"> 605</span>&#160; <span class="keywordtype">bool</span> bUnderlined, </div><div class="line"><a name="l00606"></a><span class="lineno"> 606</span>&#160; <span class="keywordtype">bool</span> bStrikethrough,</div><div class="line"><a name="l00607"></a><span class="lineno"> 607</span>&#160; <span class="keywordtype">double</span> linefeed_ratio,</div><div class="line"><a name="l00608"></a><span class="lineno"> 608</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> logfont_charset</div><div class="line"><a name="l00609"></a><span class="lineno"> 609</span>&#160; );</div><div class="line"><a name="l00610"></a><span class="lineno"> 610</span>&#160;</div><div class="line"><a name="l00611"></a><span class="lineno"> 611</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00612"></a><span class="lineno"> 612</span>&#160; <span class="keywordtype">double</span> point_size,</div><div class="line"><a name="l00613"></a><span class="lineno"> 613</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name, </div><div class="line"><a name="l00614"></a><span class="lineno"> 614</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00615"></a><span class="lineno"> 615</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style,</div><div class="line"><a name="l00616"></a><span class="lineno"> 616</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a> font_stretch,</div><div class="line"><a name="l00617"></a><span class="lineno"> 617</span>&#160; <span class="keywordtype">bool</span> bUnderlined, </div><div class="line"><a name="l00618"></a><span class="lineno"> 618</span>&#160; <span class="keywordtype">bool</span> bStrikethrough,</div><div class="line"><a name="l00619"></a><span class="lineno"> 619</span>&#160; <span class="keywordtype">double</span> linefeed_ratio,</div><div class="line"><a name="l00620"></a><span class="lineno"> 620</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> logfont_charset</div><div class="line"><a name="l00621"></a><span class="lineno"> 621</span>&#160; );</div><div class="line"><a name="l00622"></a><span class="lineno"> 622</span>&#160;</div><div class="line"><a name="l00623"></a><span class="lineno"> 623</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFontFromFontDescription(</div><div class="line"><a name="l00624"></a><span class="lineno"> 624</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* font_description</div><div class="line"><a name="l00625"></a><span class="lineno"> 625</span>&#160; );</div><div class="line"><a name="l00626"></a><span class="lineno"> 626</span>&#160;</div><div class="line"><a name="l00627"></a><span class="lineno"> 627</span>&#160;<span class="preprocessor">#if defined(ON_OS_WINDOWS_GDI)</span></div><div class="line"><a name="l00628"></a><span class="lineno"> 628</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00629"></a><span class="lineno"> 629</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00630"></a><span class="lineno"> 630</span>&#160;<span class="comment"> Get a managed font from a LOGFONT</span></div><div class="line"><a name="l00631"></a><span class="lineno"> 631</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00632"></a><span class="lineno"> 632</span>&#160;<span class="comment"> map_mode - [in]</span></div><div class="line"><a name="l00633"></a><span class="lineno"> 633</span>&#160;<span class="comment"> If map_mode is 0, then ::GetMapMode(hdc) is called to get the mapping mode.</span></div><div class="line"><a name="l00634"></a><span class="lineno"> 634</span>&#160;<span class="comment"> Otherwised, map_mode must identify a Windows mapping mode</span></div><div class="line"><a name="l00635"></a><span class="lineno"> 635</span>&#160;<span class="comment"> (MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, M_TWIPS).</span></div><div class="line"><a name="l00636"></a><span class="lineno"> 636</span>&#160;<span class="comment"> If map_mode = MM_TEXT (1), then hdc is used as described in the hdc parameter.</span></div><div class="line"><a name="l00637"></a><span class="lineno"> 637</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l00638"></a><span class="lineno"> 638</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l00639"></a><span class="lineno"> 639</span>&#160;<span class="comment"> If map_mode is set and not MM_TEXT, then hdc is ignored.</span></div><div class="line"><a name="l00640"></a><span class="lineno"> 640</span>&#160;<span class="comment"> Otherwise the device context is used to get the mapping mode ( GetMapMode(hdc) ). </span></div><div class="line"><a name="l00641"></a><span class="lineno"> 641</span>&#160;<span class="comment"> If the mapping mode is MM_TEXT, then the additional device context values</span></div><div class="line"><a name="l00642"></a><span class="lineno"> 642</span>&#160;<span class="comment"> GetDeviceCaps(hdc, LOGPIXELSY) and conversion between device and logical pixel heights</span></div><div class="line"><a name="l00643"></a><span class="lineno"> 643</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l00644"></a><span class="lineno"> 644</span>&#160;<span class="comment"> logfont - [in]</span></div><div class="line"><a name="l00645"></a><span class="lineno"> 645</span>&#160;<span class="comment"> These logfont properties are used to find the managed font.</span></div><div class="line"><a name="l00646"></a><span class="lineno"> 646</span>&#160;<span class="comment"> lfHeight (when dc is not zero)</span></div><div class="line"><a name="l00647"></a><span class="lineno"> 647</span>&#160;<span class="comment"> lfWeight;</span></div><div class="line"><a name="l00648"></a><span class="lineno"> 648</span>&#160;<span class="comment"> lfItalic;</span></div><div class="line"><a name="l00649"></a><span class="lineno"> 649</span>&#160;<span class="comment"> lfUnderline;</span></div><div class="line"><a name="l00650"></a><span class="lineno"> 650</span>&#160;<span class="comment"> lfStrikeOut;</span></div><div class="line"><a name="l00651"></a><span class="lineno"> 651</span>&#160;<span class="comment"> lfCharSet;</span></div><div class="line"><a name="l00652"></a><span class="lineno"> 652</span>&#160;<span class="comment"> lfFaceName[LF_FACESIZE];</span></div><div class="line"><a name="l00653"></a><span class="lineno"> 653</span>&#160;<span class="comment"> All other LOGFONT properties is ignored.</span></div><div class="line"><a name="l00654"></a><span class="lineno"> 654</span>&#160;<span class="comment"> See Also:</span></div><div class="line"><a name="l00655"></a><span class="lineno"> 655</span>&#160;<span class="comment"> ON_Font::GetManagedFontFromWindowsLogfontComplete</span></div><div class="line"><a name="l00656"></a><span class="lineno"> 656</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00657"></a><span class="lineno"> 657</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFontFromWindowsLogfont(</div><div class="line"><a name="l00658"></a><span class="lineno"> 658</span>&#160; <span class="keywordtype">int</span> map_mode,</div><div class="line"><a name="l00659"></a><span class="lineno"> 659</span>&#160; HDC hdc,</div><div class="line"><a name="l00660"></a><span class="lineno"> 660</span>&#160; <span class="keyword">const</span> LOGFONT&amp; logfont</div><div class="line"><a name="l00661"></a><span class="lineno"> 661</span>&#160; );</div><div class="line"><a name="l00662"></a><span class="lineno"> 662</span>&#160;</div><div class="line"><a name="l00663"></a><span class="lineno"> 663</span>&#160; enum : <span class="keywordtype">int</span></div><div class="line"><a name="l00664"></a><span class="lineno"> 664</span>&#160; {</div><div class="line"><a name="l00665"></a><span class="lineno"> 665</span>&#160; MAP_MODE_ZERO_ERROR_SUPPRESS = MM_MAX + 3</div><div class="line"><a name="l00666"></a><span class="lineno"> 666</span>&#160; };</div><div class="line"><a name="l00667"></a><span class="lineno"> 667</span>&#160;</div><div class="line"><a name="l00668"></a><span class="lineno"> 668</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l00669"></a><span class="lineno"> 669</span>&#160;</div><div class="line"><a name="l00670"></a><span class="lineno"> 670</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFontFromAppleFontName(</div><div class="line"><a name="l00671"></a><span class="lineno"> 671</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* apple_font_name</div><div class="line"><a name="l00672"></a><span class="lineno"> 672</span>&#160; );</div><div class="line"><a name="l00673"></a><span class="lineno"> 673</span>&#160;</div><div class="line"><a name="l00674"></a><span class="lineno"> 674</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00675"></a><span class="lineno"> 675</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00676"></a><span class="lineno"> 676</span>&#160;<span class="comment"> The managed font for this font. </span></div><div class="line"><a name="l00677"></a><span class="lineno"> 677</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00678"></a><span class="lineno"> 678</span>&#160;<span class="comment"> If this-&gt;IsManagedFont() is true, then &quot;this&quot; is returned.</span></div><div class="line"><a name="l00679"></a><span class="lineno"> 679</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00680"></a><span class="lineno"> 680</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* ManagedFont() <span class="keyword">const</span>;</div><div class="line"><a name="l00681"></a><span class="lineno"> 681</span>&#160;</div><div class="line"><a name="l00682"></a><span class="lineno"> 682</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00683"></a><span class="lineno"> 683</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00684"></a><span class="lineno"> 684</span>&#160;<span class="comment"> Returns the glpyh informationh for used to render a specific code point</span></div><div class="line"><a name="l00685"></a><span class="lineno"> 685</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00686"></a><span class="lineno"> 686</span>&#160;<span class="comment"> unicode_code_point </span></div><div class="line"><a name="l00687"></a><span class="lineno"> 687</span>&#160;<span class="comment"> UNICODE code point value</span></div><div class="line"><a name="l00688"></a><span class="lineno"> 688</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00689"></a><span class="lineno"> 689</span>&#160;<span class="comment"> Glyph rendering information.</span></div><div class="line"><a name="l00690"></a><span class="lineno"> 690</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00691"></a><span class="lineno"> 691</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00692"></a><span class="lineno"> 692</span>&#160;<span class="comment"> Typically the returned glpyh uses is a single glpyh in this-&gt;ManagedFont().</span></div><div class="line"><a name="l00693"></a><span class="lineno"> 693</span>&#160;<span class="comment"> In this case, glyph-&gt;SubstitueCount() is 0.</span></div><div class="line"><a name="l00694"></a><span class="lineno"> 694</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00695"></a><span class="lineno"> 695</span>&#160;<span class="comment"> In some cases one or more glyphs from one or more substitute fonts are required</span></div><div class="line"><a name="l00696"></a><span class="lineno"> 696</span>&#160;<span class="comment"> to render the code point. In this case, glyph-&gt;SubstitueCount() is 0.</span></div><div class="line"><a name="l00697"></a><span class="lineno"> 697</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00698"></a><span class="lineno"> 698</span>&#160;<span class="comment"> Example:</span></div><div class="line"><a name="l00699"></a><span class="lineno"> 699</span>&#160;<span class="comment"> ON_Font* font = ...;</span></div><div class="line"><a name="l00700"></a><span class="lineno"> 700</span>&#160;<span class="comment"> unsigned int code_point = ...;</span></div><div class="line"><a name="l00701"></a><span class="lineno"> 701</span>&#160;<span class="comment"> const ON_FontGlyph* g = font-&gt;CodePointGlyph(code_point);</span></div><div class="line"><a name="l00702"></a><span class="lineno"> 702</span>&#160;<span class="comment"> if (nullptr != g )</span></div><div class="line"><a name="l00703"></a><span class="lineno"> 703</span>&#160;<span class="comment"> {</span></div><div class="line"><a name="l00704"></a><span class="lineno"> 704</span>&#160;<span class="comment"> if ( g-&gt;SubstituteCount() &gt; 0 )</span></div><div class="line"><a name="l00705"></a><span class="lineno"> 705</span>&#160;<span class="comment"> {</span></div><div class="line"><a name="l00706"></a><span class="lineno"> 706</span>&#160;<span class="comment"> // complicate case - one of more substitutes must be rendered to render g</span></div><div class="line"><a name="l00707"></a><span class="lineno"> 707</span>&#160;<span class="comment"> for ( const ON_FontGlyph* gsub = g.NextSubstitute(); nullptr != gsub; gsub = gsub-&gt;NextSubstitute() )</span></div><div class="line"><a name="l00708"></a><span class="lineno"> 708</span>&#160;<span class="comment"> {</span></div><div class="line"><a name="l00709"></a><span class="lineno"> 709</span>&#160;<span class="comment"> ...</span></div><div class="line"><a name="l00710"></a><span class="lineno"> 710</span>&#160;<span class="comment"> }</span></div><div class="line"><a name="l00711"></a><span class="lineno"> 711</span>&#160;<span class="comment"> }</span></div><div class="line"><a name="l00712"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#acc261a5bf2b733abe65cc432c1501192"> 712</a></span>&#160;<span class="comment"> else</span></div><div class="line"><a name="l00713"></a><span class="lineno"> 713</span>&#160;<span class="comment"> {</span></div><div class="line"><a name="l00714"></a><span class="lineno"> 714</span>&#160;<span class="comment"> // simple case - this computer can directly render g</span></div><div class="line"><a name="l00715"></a><span class="lineno"> 715</span>&#160;<span class="comment"> ...</span></div><div class="line"><a name="l00716"></a><span class="lineno"> 716</span>&#160;<span class="comment"> }</span></div><div class="line"><a name="l00717"></a><span class="lineno"> 717</span>&#160;<span class="comment"> }</span></div><div class="line"><a name="l00718"></a><span class="lineno"> 718</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00719"></a><span class="lineno"> 719</span>&#160; <span class="keyword">const</span> <span class="keyword">class </span><a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>* CodePointGlyph(</div><div class="line"><a name="l00720"></a><span class="lineno"> 720</span>&#160; ON__UINT32 unicode_code_point</div><div class="line"><a name="l00721"></a><span class="lineno"> 721</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l00722"></a><span class="lineno"> 722</span>&#160;</div><div class="line"><a name="l00723"></a><span class="lineno"> 723</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l00724"></a><span class="lineno"> 724</span>&#160; <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>;</div><div class="line"><a name="l00725"></a><span class="lineno"> 725</span>&#160; <span class="keyword">const</span> <span class="keyword">class </span><a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>* Internal_ManagedCodePointGlyph(</div><div class="line"><a name="l00726"></a><span class="lineno"> 726</span>&#160; ON__UINT32 unicode_code_point,</div><div class="line"><a name="l00727"></a><span class="lineno"> 727</span>&#160; <span class="keywordtype">bool</span> bCreateIfMissing,</div><div class="line"><a name="l00728"></a><span class="lineno"> 728</span>&#160; <span class="keywordtype">bool</span> bFindSubstitutes</div><div class="line"><a name="l00729"></a><span class="lineno"> 729</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l00730"></a><span class="lineno"> 730</span>&#160;</div><div class="line"><a name="l00731"></a><span class="lineno"> 731</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00732"></a><span class="lineno"> 732</span>&#160;</div><div class="line"><a name="l00733"></a><span class="lineno"> 733</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00734"></a><span class="lineno"> 734</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00735"></a><span class="lineno"> 735</span>&#160;<span class="comment"> When reading version 5 3dm achives, the font description can be</span></div><div class="line"><a name="l00736"></a><span class="lineno"> 736</span>&#160;<span class="comment"> a generic font description or an Apple font name. This function</span></div><div class="line"><a name="l00737"></a><span class="lineno"> 737</span>&#160;<span class="comment"> rejects certain descriptions like &quot;Default&quot; and &quot;Arial&quot; for</span></div><div class="line"><a name="l00738"></a><span class="lineno"> 738</span>&#160;<span class="comment"> use as Apple font names.</span></div><div class="line"><a name="l00739"></a><span class="lineno"> 739</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00740"></a><span class="lineno"> 740</span>&#160; <span class="keyword">static</span> <span class="keywordtype">bool</span> IsNotAppleFontName(</div><div class="line"><a name="l00741"></a><span class="lineno"> 741</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* font_description</div><div class="line"><a name="l00742"></a><span class="lineno"> 742</span>&#160; );</div><div class="line"><a name="l00743"></a><span class="lineno"> 743</span>&#160;</div><div class="line"><a name="l00744"></a><span class="lineno"> 744</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFont(</div><div class="line"><a name="l00745"></a><span class="lineno"> 745</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; font_characteristics,</div><div class="line"><a name="l00746"></a><span class="lineno"> 746</span>&#160; <span class="keywordtype">bool</span> bCreateIfNotFound</div><div class="line"><a name="l00747"></a><span class="lineno"> 747</span>&#160; );</div><div class="line"><a name="l00748"></a><span class="lineno"> 748</span>&#160;</div><div class="line"><a name="l00749"></a><span class="lineno"> 749</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* GetManagedFontFromSerialNumber(</div><div class="line"><a name="l00750"></a><span class="lineno"> 750</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> managed_font_runtime_serial_number</div><div class="line"><a name="l00751"></a><span class="lineno"> 751</span>&#160; );</div><div class="line"><a name="l00752"></a><span class="lineno"> 752</span>&#160;</div><div class="line"><a name="l00753"></a><span class="lineno"> 753</span>&#160; <span class="keyword">static</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> GetManagedFontList(</div><div class="line"><a name="l00754"></a><span class="lineno"> 754</span>&#160; <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt; const ON_Font* &gt;</a>&amp; managed_fonts</div><div class="line"><a name="l00755"></a><span class="lineno"> 755</span>&#160; );</div><div class="line"><a name="l00756"></a><span class="lineno"> 756</span>&#160;</div><div class="line"><a name="l00757"></a><span class="lineno"> 757</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00758"></a><span class="lineno"> 758</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00759"></a><span class="lineno"> 759</span>&#160;<span class="comment"> True if this font is a managed font returned by one of the</span></div><div class="line"><a name="l00760"></a><span class="lineno"> 760</span>&#160;<span class="comment"> static ON_Font::GetManagedFont(...) functions.</span></div><div class="line"><a name="l00761"></a><span class="lineno"> 761</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00762"></a><span class="lineno"> 762</span>&#160;<span class="comment"> ON_Font::Default is managed.</span></div><div class="line"><a name="l00763"></a><span class="lineno"> 763</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00764"></a><span class="lineno"> 764</span>&#160; <span class="keywordtype">bool</span> IsManagedFont() <span class="keyword">const</span>;</div><div class="line"><a name="l00765"></a><span class="lineno"> 765</span>&#160;</div><div class="line"><a name="l00766"></a><span class="lineno"> 766</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00767"></a><span class="lineno"> 767</span>&#160;</div><div class="line"><a name="l00768"></a><span class="lineno"> 768</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00769"></a><span class="lineno"> 769</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00770"></a><span class="lineno"> 770</span>&#160;<span class="comment"> If opennurbs is built with FreeType support then</span></div><div class="line"><a name="l00771"></a><span class="lineno"> 771</span>&#160;<span class="comment"> FT_Face freetype_face = (FT_Face)ON_Font::FreeTypeFace(font)</span></div><div class="line"><a name="l00772"></a><span class="lineno"> 772</span>&#160;<span class="comment"> will return a FreeType face that can be used to render the font.</span></div><div class="line"><a name="l00773"></a><span class="lineno"> 773</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00774"></a><span class="lineno"> 774</span>&#160;<span class="comment"> font - [in]</span></div><div class="line"><a name="l00775"></a><span class="lineno"> 775</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00776"></a><span class="lineno"> 776</span>&#160;<span class="comment"> A value that can be cast as a FreeType FT_Face.</span></div><div class="line"><a name="l00777"></a><span class="lineno"> 777</span>&#160;<span class="comment"> Example</span></div><div class="line"><a name="l00778"></a><span class="lineno"> 778</span>&#160;<span class="comment"> const ON_Font* font = ...;</span></div><div class="line"><a name="l00779"></a><span class="lineno"> 779</span>&#160;<span class="comment"> FT_Face freetype_face = (FT_Face)ON_Font::FreeTypeFace(font);</span></div><div class="line"><a name="l00780"></a><span class="lineno"> 780</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00781"></a><span class="lineno"> 781</span>&#160;<span class="comment"> Many fonts do not have a glyph for a every UNICODE codepoint and font</span></div><div class="line"><a name="l00782"></a><span class="lineno"> 782</span>&#160;<span class="comment"> substitution is required. If you want to get the freetype face</span></div><div class="line"><a name="l00783"></a><span class="lineno"> 783</span>&#160;<span class="comment"> used for a specfic UNICODE codepoint, call ON_Font::CodepointFreeTypeFace().</span></div><div class="line"><a name="l00784"></a><span class="lineno"> 784</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00785"></a><span class="lineno"> 785</span>&#160; <span class="keyword">static</span> ON__UINT_PTR <a class="code" href="../../d7/d29/class_o_n___font_glyph.html#afa54bf369e6920c9e663a04798cdbc8f">FreeTypeFace</a>(</div><div class="line"><a name="l00786"></a><span class="lineno"> 786</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font</div><div class="line"><a name="l00787"></a><span class="lineno"> 787</span>&#160; );</div><div class="line"><a name="l00788"></a><span class="lineno"> 788</span>&#160; </div><div class="line"><a name="l00789"></a><span class="lineno"> 789</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l00790"></a><span class="lineno"> 790</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00791"></a><span class="lineno"> 791</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00792"></a><span class="lineno"> 792</span>&#160;<span class="comment"> Helper function used by destructor to deallocate memory used</span></div><div class="line"><a name="l00793"></a><span class="lineno"> 793</span>&#160;<span class="comment"> by FreeType face</span></div><div class="line"><a name="l00794"></a><span class="lineno"> 794</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00795"></a><span class="lineno"> 795</span>&#160; <span class="keyword">static</span> <span class="keywordtype">void</span> DestroyFreeTypeFace(</div><div class="line"><a name="l00796"></a><span class="lineno"> 796</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font</div><div class="line"><a name="l00797"></a><span class="lineno"> 797</span>&#160; );</div><div class="line"><a name="l00798"></a><span class="lineno"> 798</span>&#160;</div><div class="line"><a name="l00799"></a><span class="lineno"> 799</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00800"></a><span class="lineno"> 800</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html#a003e28c4b7e4c4ced7fbe3fa422074ec">ON_Font</a>();</div><div class="line"><a name="l00801"></a><span class="lineno"> 801</span>&#160; ~<a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l00802"></a><span class="lineno"> 802</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html#a003e28c4b7e4c4ced7fbe3fa422074ec">ON_Font</a>(<span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; src);</div><div class="line"><a name="l00803"></a><span class="lineno"> 803</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html#a940ce31d13be5e4f3fe2ec87ed2db238">operator=</a>(<span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; src);</div><div class="line"><a name="l00804"></a><span class="lineno"> 804</span>&#160;</div><div class="line"><a name="l00805"></a><span class="lineno"> 805</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00806"></a><span class="lineno"> 806</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00807"></a><span class="lineno"> 807</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00808"></a><span class="lineno"> 808</span>&#160;<span class="comment"> Create a font with a specified facename and properties.</span></div><div class="line"><a name="l00809"></a><span class="lineno"> 809</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00810"></a><span class="lineno"> 810</span>&#160;<span class="comment"> face_name - [in]</span></div><div class="line"><a name="l00811"></a><span class="lineno"> 811</span>&#160;<span class="comment"> nullptr is treated as ON_Font::Default.FaceName().</span></div><div class="line"><a name="l00812"></a><span class="lineno"> 812</span>&#160;<span class="comment"> bBold - [in]</span></div><div class="line"><a name="l00813"></a><span class="lineno"> 813</span>&#160;<span class="comment"> True for a bold version of the font.</span></div><div class="line"><a name="l00814"></a><span class="lineno"> 814</span>&#160;<span class="comment"> bItalic - [in]</span></div><div class="line"><a name="l00815"></a><span class="lineno"> 815</span>&#160;<span class="comment"> True for an italic version of the font.</span></div><div class="line"><a name="l00816"></a><span class="lineno"> 816</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00817"></a><span class="lineno"> 817</span>&#160;<span class="comment"> True if the font characteristics were valid and set on the font.</span></div><div class="line"><a name="l00818"></a><span class="lineno"> 818</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00819"></a><span class="lineno"> 819</span>&#160; <span class="keywordtype">bool</span> SetFontCharacteristics( </div><div class="line"><a name="l00820"></a><span class="lineno"> 820</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00821"></a><span class="lineno"> 821</span>&#160; <span class="keywordtype">bool</span> bBold,</div><div class="line"><a name="l00822"></a><span class="lineno"> 822</span>&#160; <span class="keywordtype">bool</span> bItalic,</div><div class="line"><a name="l00823"></a><span class="lineno"> 823</span>&#160; <span class="keywordtype">bool</span> bUnderlined,</div><div class="line"><a name="l00824"></a><span class="lineno"> 824</span>&#160; <span class="keywordtype">bool</span> bStrikethrough</div><div class="line"><a name="l00825"></a><span class="lineno"> 825</span>&#160; );</div><div class="line"><a name="l00826"></a><span class="lineno"> 826</span>&#160;</div><div class="line"><a name="l00827"></a><span class="lineno"> 827</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00828"></a><span class="lineno"> 828</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00829"></a><span class="lineno"> 829</span>&#160;<span class="comment"> Create a font with a specified facename and properties.</span></div><div class="line"><a name="l00830"></a><span class="lineno"> 830</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00831"></a><span class="lineno"> 831</span>&#160;<span class="comment"> point_size - [in]</span></div><div class="line"><a name="l00832"></a><span class="lineno"> 832</span>&#160;<span class="comment"> If point_size &gt; 0.0, then it specifies which size of font definition</span></div><div class="line"><a name="l00833"></a><span class="lineno"> 833</span>&#160;<span class="comment"> should be used. Otherwise the font size used for annotation text</span></div><div class="line"><a name="l00834"></a><span class="lineno"> 834</span>&#160;<span class="comment"> is used.</span></div><div class="line"><a name="l00835"></a><span class="lineno"> 835</span>&#160;<span class="comment"> For high quality fonts it is generally the case that</span></div><div class="line"><a name="l00836"></a><span class="lineno"> 836</span>&#160;<span class="comment"> different point sizes of the same font face have</span></div><div class="line"><a name="l00837"></a><span class="lineno"> 837</span>&#160;<span class="comment"> subtle differences in glyph design and are not</span></div><div class="line"><a name="l00838"></a><span class="lineno"> 838</span>&#160;<span class="comment"> simply scaled versions of a base glyph.</span></div><div class="line"><a name="l00839"></a><span class="lineno"> 839</span>&#160;<span class="comment"> face_name - [in]</span></div><div class="line"><a name="l00840"></a><span class="lineno"> 840</span>&#160;<span class="comment"> nullptr is treated as ON_Font::Default.FaceName().</span></div><div class="line"><a name="l00841"></a><span class="lineno"> 841</span>&#160;<span class="comment"> bBold - [in]</span></div><div class="line"><a name="l00842"></a><span class="lineno"> 842</span>&#160;<span class="comment"> True for a bold version of the font.</span></div><div class="line"><a name="l00843"></a><span class="lineno"> 843</span>&#160;<span class="comment"> bItalic - [in]</span></div><div class="line"><a name="l00844"></a><span class="lineno"> 844</span>&#160;<span class="comment"> True for an italic version of the font.</span></div><div class="line"><a name="l00845"></a><span class="lineno"> 845</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00846"></a><span class="lineno"> 846</span>&#160;<span class="comment"> True if the font characteristics were valid and set on the font.</span></div><div class="line"><a name="l00847"></a><span class="lineno"> 847</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00848"></a><span class="lineno"> 848</span>&#160; <span class="keywordtype">bool</span> SetFontCharacteristics( </div><div class="line"><a name="l00849"></a><span class="lineno"> 849</span>&#160; <span class="keywordtype">double</span> point_size,</div><div class="line"><a name="l00850"></a><span class="lineno"> 850</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00851"></a><span class="lineno"> 851</span>&#160; <span class="keywordtype">bool</span> bBold,</div><div class="line"><a name="l00852"></a><span class="lineno"> 852</span>&#160; <span class="keywordtype">bool</span> bItalic,</div><div class="line"><a name="l00853"></a><span class="lineno"> 853</span>&#160; <span class="keywordtype">bool</span> bUnderlined,</div><div class="line"><a name="l00854"></a><span class="lineno"> 854</span>&#160; <span class="keywordtype">bool</span> bStrikethrough</div><div class="line"><a name="l00855"></a><span class="lineno"> 855</span>&#160; );</div><div class="line"><a name="l00856"></a><span class="lineno"> 856</span>&#160;</div><div class="line"><a name="l00857"></a><span class="lineno"> 857</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00858"></a><span class="lineno"> 858</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00859"></a><span class="lineno"> 859</span>&#160;<span class="comment"> Set the font&#39;s face name and characteristics.</span></div><div class="line"><a name="l00860"></a><span class="lineno"> 860</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00861"></a><span class="lineno"> 861</span>&#160;<span class="comment"> face_name - [in]</span></div><div class="line"><a name="l00862"></a><span class="lineno"> 862</span>&#160;<span class="comment"> nullptr is not permitted.</span></div><div class="line"><a name="l00863"></a><span class="lineno"> 863</span>&#160;<span class="comment"> Pass ON_Font::Default.FaceName() if you don&#39;t have a face name.</span></div><div class="line"><a name="l00864"></a><span class="lineno"> 864</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00865"></a><span class="lineno"> 865</span>&#160;<span class="comment"> True if the font characteristics were valid and set on the font.</span></div><div class="line"><a name="l00866"></a><span class="lineno"> 866</span>&#160;<span class="comment"> */</span> </div><div class="line"><a name="l00867"></a><span class="lineno"> 867</span>&#160; <span class="keywordtype">bool</span> SetFontCharacteristics( </div><div class="line"><a name="l00868"></a><span class="lineno"> 868</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00869"></a><span class="lineno"> 869</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00870"></a><span class="lineno"> 870</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style,</div><div class="line"><a name="l00871"></a><span class="lineno"> 871</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a> font_stretch,</div><div class="line"><a name="l00872"></a><span class="lineno"> 872</span>&#160; <span class="keywordtype">bool</span> bUnderlined,</div><div class="line"><a name="l00873"></a><span class="lineno"> 873</span>&#160; <span class="keywordtype">bool</span> bStrikethrough</div><div class="line"><a name="l00874"></a><span class="lineno"> 874</span>&#160; );</div><div class="line"><a name="l00875"></a><span class="lineno"> 875</span>&#160;</div><div class="line"><a name="l00876"></a><span class="lineno"> 876</span>&#160; <span class="keywordtype">bool</span> SetFontCharacteristics( </div><div class="line"><a name="l00877"></a><span class="lineno"> 877</span>&#160; <span class="keywordtype">double</span> point_size,</div><div class="line"><a name="l00878"></a><span class="lineno"> 878</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00879"></a><span class="lineno"> 879</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00880"></a><span class="lineno"> 880</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style,</div><div class="line"><a name="l00881"></a><span class="lineno"> 881</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a> font_stretch,</div><div class="line"><a name="l00882"></a><span class="lineno"> 882</span>&#160; <span class="keywordtype">bool</span> bUnderlined,</div><div class="line"><a name="l00883"></a><span class="lineno"> 883</span>&#160; <span class="keywordtype">bool</span> bStrikethrough</div><div class="line"><a name="l00884"></a><span class="lineno"> 884</span>&#160; );</div><div class="line"><a name="l00885"></a><span class="lineno"> 885</span>&#160;</div><div class="line"><a name="l00886"></a><span class="lineno"> 886</span>&#160; <span class="keywordtype">bool</span> SetFontCharacteristics( </div><div class="line"><a name="l00887"></a><span class="lineno"> 887</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00888"></a><span class="lineno"> 888</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00889"></a><span class="lineno"> 889</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style,</div><div class="line"><a name="l00890"></a><span class="lineno"> 890</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a> font_stretch,</div><div class="line"><a name="l00891"></a><span class="lineno"> 891</span>&#160; <span class="keywordtype">bool</span> bUnderlined,</div><div class="line"><a name="l00892"></a><span class="lineno"> 892</span>&#160; <span class="keywordtype">bool</span> bStrikethrough,</div><div class="line"><a name="l00893"></a><span class="lineno"> 893</span>&#160; <span class="keywordtype">double</span> linefeed_ratio,</div><div class="line"><a name="l00894"></a><span class="lineno"> 894</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> logfont_charset</div><div class="line"><a name="l00895"></a><span class="lineno"> 895</span>&#160; );</div><div class="line"><a name="l00896"></a><span class="lineno"> 896</span>&#160;</div><div class="line"><a name="l00897"></a><span class="lineno"> 897</span>&#160; <span class="keywordtype">bool</span> SetFontCharacteristics( </div><div class="line"><a name="l00898"></a><span class="lineno"> 898</span>&#160; <span class="keywordtype">double</span> point_size,</div><div class="line"><a name="l00899"></a><span class="lineno"> 899</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name,</div><div class="line"><a name="l00900"></a><span class="lineno"> 900</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00901"></a><span class="lineno"> 901</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style,</div><div class="line"><a name="l00902"></a><span class="lineno"> 902</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a> font_stretch,</div><div class="line"><a name="l00903"></a><span class="lineno"> 903</span>&#160; <span class="keywordtype">bool</span> bUnderlined,</div><div class="line"><a name="l00904"></a><span class="lineno"> 904</span>&#160; <span class="keywordtype">bool</span> bStrikethrough,</div><div class="line"><a name="l00905"></a><span class="lineno"> 905</span>&#160; <span class="keywordtype">double</span> linefeed_ratio,</div><div class="line"><a name="l00906"></a><span class="lineno"> 906</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> logfont_charset</div><div class="line"><a name="l00907"></a><span class="lineno"> 907</span>&#160; );</div><div class="line"><a name="l00908"></a><span class="lineno"> 908</span>&#160;</div><div class="line"><a name="l00909"></a><span class="lineno"> 909</span>&#160;</div><div class="line"><a name="l00910"></a><span class="lineno"> 910</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00911"></a><span class="lineno"> 911</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00912"></a><span class="lineno"> 912</span>&#160;<span class="comment"> The font properties weight, style, stretch, underlined, </span></div><div class="line"><a name="l00913"></a><span class="lineno"> 913</span>&#160;<span class="comment"> and strikethrough are encoded in the returned value.</span></div><div class="line"><a name="l00914"></a><span class="lineno"> 914</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00915"></a><span class="lineno"> 915</span>&#160;<span class="comment"> This is a legacy value used in 3dm archive reading/writing </span></div><div class="line"><a name="l00916"></a><span class="lineno"> 916</span>&#160;<span class="comment"> and some sorting operations.</span></div><div class="line"><a name="l00917"></a><span class="lineno"> 917</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00918"></a><span class="lineno"> 918</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> FontCharacteristicsAsUnsigned() <span class="keyword">const</span>;</div><div class="line"><a name="l00919"></a><span class="lineno"> 919</span>&#160;</div><div class="line"><a name="l00920"></a><span class="lineno"> 920</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l00921"></a><span class="lineno"> 921</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00922"></a><span class="lineno"> 922</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00923"></a><span class="lineno"> 923</span>&#160;<span class="comment"> All font characterisics defined by the input parameters are encoded </span></div><div class="line"><a name="l00924"></a><span class="lineno"> 924</span>&#160;<span class="comment"> in the returned value.</span></div><div class="line"><a name="l00925"></a><span class="lineno"> 925</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00926"></a><span class="lineno"> 926</span>&#160;<span class="comment"> Used in 3dm archive reading/writing.</span></div><div class="line"><a name="l00927"></a><span class="lineno"> 927</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00928"></a><span class="lineno"> 928</span>&#160; <span class="keyword">static</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> Internal_FontCharacteristicsAsUnsigned(</div><div class="line"><a name="l00929"></a><span class="lineno"> 929</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a> font_weight,</div><div class="line"><a name="l00930"></a><span class="lineno"> 930</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a> font_style,</div><div class="line"><a name="l00931"></a><span class="lineno"> 931</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a> font_stretch,</div><div class="line"><a name="l00932"></a><span class="lineno"> 932</span>&#160; <span class="keywordtype">bool</span> bUnderlined,</div><div class="line"><a name="l00933"></a><span class="lineno"> 933</span>&#160; <span class="keywordtype">bool</span> bStrikethrough</div><div class="line"><a name="l00934"></a><span class="lineno"> 934</span>&#160; );</div><div class="line"><a name="l00935"></a><span class="lineno"> 935</span>&#160; </div><div class="line"><a name="l00936"></a><span class="lineno"> 936</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00937"></a><span class="lineno"> 937</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00938"></a><span class="lineno"> 938</span>&#160;<span class="comment"> All font characterisics except facename (weight, style, stretch, </span></div><div class="line"><a name="l00939"></a><span class="lineno"> 939</span>&#160;<span class="comment"> underlined, strikethrough, charset) are encoded in the returned</span></div><div class="line"><a name="l00940"></a><span class="lineno"> 940</span>&#160;<span class="comment"> value.</span></div><div class="line"><a name="l00941"></a><span class="lineno"> 941</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00942"></a><span class="lineno"> 942</span>&#160;<span class="comment"> font_characteristics_as_unsigned - [in]</span></div><div class="line"><a name="l00943"></a><span class="lineno"> 943</span>&#160;<span class="comment"> Value returned from ON_Font.FontCharacteristicsAsUnsigned()</span></div><div class="line"><a name="l00944"></a><span class="lineno"> 944</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00945"></a><span class="lineno"> 945</span>&#160;<span class="comment"> True if the characterstics were set.</span></div><div class="line"><a name="l00946"></a><span class="lineno"> 946</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l00947"></a><span class="lineno"> 947</span>&#160;<span class="comment"> Used in 3dm archive reading/writing.</span></div><div class="line"><a name="l00948"></a><span class="lineno"> 948</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00949"></a><span class="lineno"> 949</span>&#160; <span class="keywordtype">bool</span> Internal_SetFontCharacteristicsFromUnsigned(</div><div class="line"><a name="l00950"></a><span class="lineno"> 950</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> font_characteristics_as_unsigned</div><div class="line"><a name="l00951"></a><span class="lineno"> 951</span>&#160; );</div><div class="line"><a name="l00952"></a><span class="lineno"> 952</span>&#160;</div><div class="line"><a name="l00953"></a><span class="lineno"> 953</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l00954"></a><span class="lineno"> 954</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00955"></a><span class="lineno"> 955</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00956"></a><span class="lineno"> 956</span>&#160;<span class="comment"> Returns a 32-bit crc of the font weight, style, stretch, underline, strikethrough, </span></div><div class="line"><a name="l00957"></a><span class="lineno"> 957</span>&#160;<span class="comment"> and facename characteristics.</span></div><div class="line"><a name="l00958"></a><span class="lineno"> 958</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00959"></a><span class="lineno"> 959</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00960"></a><span class="lineno"> 960</span>&#160;<span class="comment"> bIgnoreFaceNameOrdinalCase - [in]</span></div><div class="line"><a name="l00961"></a><span class="lineno"> 961</span>&#160;<span class="comment"> If true, ON_wString::MapStringOrdinal() is applied to the face name</span></div><div class="line"><a name="l00962"></a><span class="lineno"> 962</span>&#160;<span class="comment"> and the returned CRC is ordinal case independent.</span></div><div class="line"><a name="l00963"></a><span class="lineno"> 963</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00964"></a><span class="lineno"> 964</span>&#160; ON__UINT32 CRC32(</div><div class="line"><a name="l00965"></a><span class="lineno"> 965</span>&#160; <span class="keywordtype">bool</span> bIgnoreFaceNameOrdinalCase</div><div class="line"><a name="l00966"></a><span class="lineno"> 966</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l00967"></a><span class="lineno"> 967</span>&#160;</div><div class="line"><a name="l00968"></a><span class="lineno"> 968</span>&#160;<span class="preprocessor">#if defined(ON_OS_WINDOWS_GDI)</span></div><div class="line"><a name="l00969"></a><span class="lineno"> 969</span>&#160;</div><div class="line"><a name="l00970"></a><span class="lineno"> 970</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00971"></a><span class="lineno"> 971</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l00972"></a><span class="lineno"> 972</span>&#160;<span class="comment"> Get the scale factors for converting heights beween </span></div><div class="line"><a name="l00973"></a><span class="lineno"> 973</span>&#160;<span class="comment"> Windows device coordinates and Windows logical coordinates.</span></div><div class="line"><a name="l00974"></a><span class="lineno"> 974</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00975"></a><span class="lineno"> 975</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l00976"></a><span class="lineno"> 976</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l00977"></a><span class="lineno"> 977</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l00978"></a><span class="lineno"> 978</span>&#160;<span class="comment"> The device context is used to get the conversion between device </span></div><div class="line"><a name="l00979"></a><span class="lineno"> 979</span>&#160;<span class="comment"> and logical pixel heights. The Windows GDI functions</span></div><div class="line"><a name="l00980"></a><span class="lineno"> 980</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l00981"></a><span class="lineno"> 981</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00982"></a><span class="lineno"> 982</span>&#160;<span class="comment"> device_to_logical_scale - [out]</span></div><div class="line"><a name="l00983"></a><span class="lineno"> 983</span>&#160;<span class="comment"> logical_height = device_to_logical_scale*device_height</span></div><div class="line"><a name="l00984"></a><span class="lineno"> 984</span>&#160;<span class="comment"></span></div><div class="line"><a name="l00985"></a><span class="lineno"> 985</span>&#160;<span class="comment"> logical_to_device_scale - [out]</span></div><div class="line"><a name="l00986"></a><span class="lineno"> 986</span>&#160;<span class="comment"> device_height = logical_to_device_scale*logical_height</span></div><div class="line"><a name="l00987"></a><span class="lineno"> 987</span>&#160;<span class="comment"> </span></div><div class="line"><a name="l00988"></a><span class="lineno"> 988</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l00989"></a><span class="lineno"> 989</span>&#160;<span class="comment"> True if successful.</span></div><div class="line"><a name="l00990"></a><span class="lineno"> 990</span>&#160;<span class="comment"> False otherwise. In the returned scale factors are set to 1.0.</span></div><div class="line"><a name="l00991"></a><span class="lineno"> 991</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l00992"></a><span class="lineno"> 992</span>&#160; <span class="keyword">static</span> <span class="keywordtype">bool</span> GetWindowsDeviceToLogicalHeightScales(</div><div class="line"><a name="l00993"></a><span class="lineno"> 993</span>&#160; HDC hdc,</div><div class="line"><a name="l00994"></a><span class="lineno"> 994</span>&#160; <span class="keywordtype">double</span>* device_to_logical_scale,</div><div class="line"><a name="l00995"></a><span class="lineno"> 995</span>&#160; <span class="keywordtype">double</span>* logical_to_device_scale</div><div class="line"><a name="l00996"></a><span class="lineno"> 996</span>&#160; );</div><div class="line"><a name="l00997"></a><span class="lineno"> 997</span>&#160;</div><div class="line"><a name="l00998"></a><span class="lineno"> 998</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l00999"></a><span class="lineno"> 999</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>&#160;<span class="comment"> Convert a character height in points to a Windows LOGFONT lfHeight value (negative number).</span></div><div class="line"><a name="l01001"></a><span class="lineno"> 1001</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01002"></a><span class="lineno"> 1002</span>&#160;<span class="comment"> The mapping mode determines the length unit system for the returned value.</span></div><div class="line"><a name="l01003"></a><span class="lineno"> 1003</span>&#160;<span class="comment"> </span></div><div class="line"><a name="l01004"></a><span class="lineno"> 1004</span>&#160;<span class="comment"> </span></div><div class="line"><a name="l01005"></a><span class="lineno"> 1005</span>&#160;<span class="comment"> The Windows convention is to use negative lfHeight values to specify</span></div><div class="line"><a name="l01006"></a><span class="lineno"> 1006</span>&#160;<span class="comment"> font character heights and postive height values to specify font cell heights.</span></div><div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01008"></a><span class="lineno"> 1008</span>&#160;<span class="comment"> font cell height = font acsent + font descent.</span></div><div class="line"><a name="l01009"></a><span class="lineno"> 1009</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01010"></a><span class="lineno"> 1010</span>&#160;<span class="comment"> font character height = Cell height - internal leading.</span></div><div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01012"></a><span class="lineno"> 1012</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01013"></a><span class="lineno"> 1013</span>&#160;<span class="comment"> map_mode - [in]</span></div><div class="line"><a name="l01014"></a><span class="lineno"> 1014</span>&#160;<span class="comment"> If map_mode is 0, then ::GetMapMode(hdc) is called to get the mapping mode.</span></div><div class="line"><a name="l01015"></a><span class="lineno"> 1015</span>&#160;<span class="comment"> Otherwised, map_mode must identify a Windows mapping mode</span></div><div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>&#160;<span class="comment"> (MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, M_TWIPS).</span></div><div class="line"><a name="l01017"></a><span class="lineno"> 1017</span>&#160;<span class="comment"> If map_mode = MM_TEXT (1), then hdc is used as described in the hdc parameter.</span></div><div class="line"><a name="l01018"></a><span class="lineno"> 1018</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01019"></a><span class="lineno"> 1019</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l01020"></a><span class="lineno"> 1020</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l01021"></a><span class="lineno"> 1021</span>&#160;<span class="comment"> If map_mode is set and not MM_TEXT, then hdc is ignored.</span></div><div class="line"><a name="l01022"></a><span class="lineno"> 1022</span>&#160;<span class="comment"> Otherwise the device context is used to get the mapping mode ( GetMapMode(hdc) ). </span></div><div class="line"><a name="l01023"></a><span class="lineno"> 1023</span>&#160;<span class="comment"> If the mapping mode is MM_TEXT, then the additional device context values</span></div><div class="line"><a name="l01024"></a><span class="lineno"> 1024</span>&#160;<span class="comment"> GetDeviceCaps(hdc, LOGPIXELSY) and conversion between device and logical pixel heights</span></div><div class="line"><a name="l01025"></a><span class="lineno"> 1025</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l01026"></a><span class="lineno"> 1026</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01027"></a><span class="lineno"> 1027</span>&#160;<span class="comment"> point_size - [in]</span></div><div class="line"><a name="l01028"></a><span class="lineno"> 1028</span>&#160;<span class="comment"> Font character height in points (1 point = 1/72 inch = 25.4/72 millimeters). </span></div><div class="line"><a name="l01029"></a><span class="lineno"> 1029</span>&#160;<span class="comment"> In terms of font metrics, character height = ascent + descent - internal leading.</span></div><div class="line"><a name="l01030"></a><span class="lineno"> 1030</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01031"></a><span class="lineno"> 1031</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01032"></a><span class="lineno"> 1032</span>&#160;<span class="comment"> LOGFONT lfHeight value. </span></div><div class="line"><a name="l01033"></a><span class="lineno"> 1033</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01034"></a><span class="lineno"> 1034</span>&#160;<span class="comment"> This value is always negative.</span></div><div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01036"></a><span class="lineno"> 1036</span>&#160;<span class="comment"> The absolute value of the returned value</span></div><div class="line"><a name="l01037"></a><span class="lineno"> 1037</span>&#160;<span class="comment"> = character height</span></div><div class="line"><a name="l01038"></a><span class="lineno"> 1038</span>&#160;<span class="comment"> = ascent + descent - internal leading</span></div><div class="line"><a name="l01039"></a><span class="lineno"> 1039</span>&#160;<span class="comment"> For many common fonts, the &quot;character height&quot; is close to the distance</span></div><div class="line"><a name="l01040"></a><span class="lineno"> 1040</span>&#160;<span class="comment"> from the bottom of a lower case g to the top of an upper case M. </span></div><div class="line"><a name="l01041"></a><span class="lineno"> 1041</span>&#160;<span class="comment"> The internal leading is space reseved for diacritical marks like the</span></div><div class="line"><a name="l01042"></a><span class="lineno"> 1042</span>&#160;<span class="comment"> ring above the A in the UNICODE &quot;LATIN LETTER A WITH RING&quot; U+00C5 glyph.</span></div><div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>&#160;<span class="comment"> Character height is also known as the &quot;em height&quot;. </span></div><div class="line"><a name="l01044"></a><span class="lineno"> 1044</span>&#160;<span class="comment"> Note that the &quot;em height&quot; is typically larger than the height of the</span></div><div class="line"><a name="l01045"></a><span class="lineno"> 1045</span>&#160;<span class="comment"> letter M because &quot;em height&quot; inlcude descent.</span></div><div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01047"></a><span class="lineno"> 1047</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> WindowsLogfontCharacterHeightFromPointSize(</div><div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>&#160; <span class="keywordtype">int</span> map_mode,</div><div class="line"><a name="l01049"></a><span class="lineno"> 1049</span>&#160; HDC hdc,</div><div class="line"><a name="l01050"></a><span class="lineno"> 1050</span>&#160; <span class="keywordtype">double</span> point_size</div><div class="line"><a name="l01051"></a><span class="lineno"> 1051</span>&#160; );</div><div class="line"><a name="l01052"></a><span class="lineno"> 1052</span>&#160;</div><div class="line"><a name="l01053"></a><span class="lineno"> 1053</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01054"></a><span class="lineno"> 1054</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01055"></a><span class="lineno"> 1055</span>&#160;<span class="comment"> map_mode - [in]</span></div><div class="line"><a name="l01056"></a><span class="lineno"> 1056</span>&#160;<span class="comment"> If map_mode is 0, then ::GetMapMode(hdc) is called to get the mapping mode.</span></div><div class="line"><a name="l01057"></a><span class="lineno"> 1057</span>&#160;<span class="comment"> Otherwised, map_mode must identify a Windows mapping mode</span></div><div class="line"><a name="l01058"></a><span class="lineno"> 1058</span>&#160;<span class="comment"> (MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, M_TWIPS).</span></div><div class="line"><a name="l01059"></a><span class="lineno"> 1059</span>&#160;<span class="comment"> If map_mode = MM_TEXT (1), then hdc is used as described in the hdc parameter.</span></div><div class="line"><a name="l01060"></a><span class="lineno"> 1060</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01061"></a><span class="lineno"> 1061</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l01062"></a><span class="lineno"> 1062</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l01063"></a><span class="lineno"> 1063</span>&#160;<span class="comment"> If map_mode is set and not MM_TEXT, then hdc is ignored.</span></div><div class="line"><a name="l01064"></a><span class="lineno"> 1064</span>&#160;<span class="comment"> Otherwise the device context is used to get the mapping mode ( GetMapMode(hdc) ). </span></div><div class="line"><a name="l01065"></a><span class="lineno"> 1065</span>&#160;<span class="comment"> If the mapping mode is MM_TEXT, then the additional device context values</span></div><div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>&#160;<span class="comment"> GetDeviceCaps(hdc, LOGPIXELSY) and conversion between device and logical pixel heights</span></div><div class="line"><a name="l01067"></a><span class="lineno"> 1067</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l01068"></a><span class="lineno"> 1068</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01069"></a><span class="lineno"> 1069</span>&#160;<span class="comment"> logfont_character_height - [in]</span></div><div class="line"><a name="l01070"></a><span class="lineno"> 1070</span>&#160;<span class="comment"> This value must be a Windows LOGFONT character height in units</span></div><div class="line"><a name="l01071"></a><span class="lineno"> 1071</span>&#160;<span class="comment"> determine from map_mode and hdc. If you have a LOGFONT with postive</span></div><div class="line"><a name="l01072"></a><span class="lineno"> 1072</span>&#160;<span class="comment"> lfHeight value, you must get the fonts TEXTMETRICS and subbr</span></div><div class="line"><a name="l01073"></a><span class="lineno"> 1073</span>&#160;<span class="comment"> </span></div><div class="line"><a name="l01074"></a><span class="lineno"> 1074</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01075"></a><span class="lineno"> 1075</span>&#160;<span class="comment"> Character height in points (1 point = 1/72 inch).</span></div><div class="line"><a name="l01076"></a><span class="lineno"> 1076</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01077"></a><span class="lineno"> 1077</span>&#160;<span class="comment"> font character height = font ascent + font descent - font internal leading.</span></div><div class="line"><a name="l01078"></a><span class="lineno"> 1078</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01079"></a><span class="lineno"> 1079</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l01080"></a><span class="lineno"> 1080</span>&#160;<span class="comment"> See ON_Font::PointSize() for information about point units,</span></div><div class="line"><a name="l01081"></a><span class="lineno"> 1081</span>&#160;<span class="comment"> font character height, and font cell height.</span></div><div class="line"><a name="l01082"></a><span class="lineno"> 1082</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01083"></a><span class="lineno"> 1083</span>&#160; <span class="keyword">static</span> <span class="keywordtype">double</span> PointSizeFromWindowsLogfontCharacterHeight(</div><div class="line"><a name="l01084"></a><span class="lineno"> 1084</span>&#160; <span class="keywordtype">int</span> map_mode,</div><div class="line"><a name="l01085"></a><span class="lineno"> 1085</span>&#160; HDC hdc,</div><div class="line"><a name="l01086"></a><span class="lineno"> 1086</span>&#160; <span class="keywordtype">int</span> logfont_character_height</div><div class="line"><a name="l01087"></a><span class="lineno"> 1087</span>&#160; );</div><div class="line"><a name="l01088"></a><span class="lineno"> 1088</span>&#160;</div><div class="line"><a name="l01089"></a><span class="lineno"> 1089</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01090"></a><span class="lineno"> 1090</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01091"></a><span class="lineno"> 1091</span>&#160;<span class="comment"> Get a Windows LOGFONT character height </span></div><div class="line"><a name="l01092"></a><span class="lineno"> 1092</span>&#160;<span class="comment"> = -(TEXTMETRIC.tmAscent + TEXTMETRIC.tmDescent - TEXTMETRIC.tmLeading ) </span></div><div class="line"><a name="l01093"></a><span class="lineno"> 1093</span>&#160;<span class="comment"> as a negative integer.</span></div><div class="line"><a name="l01094"></a><span class="lineno"> 1094</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01095"></a><span class="lineno"> 1095</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01096"></a><span class="lineno"> 1096</span>&#160;<span class="comment"> map_mode - [in]</span></div><div class="line"><a name="l01097"></a><span class="lineno"> 1097</span>&#160;<span class="comment"> The best results are obtained when map_mode = MM_TEXT and the hdc is</span></div><div class="line"><a name="l01098"></a><span class="lineno"> 1098</span>&#160;<span class="comment"> correctly set for the context where the font is being rendered. Otherwise</span></div><div class="line"><a name="l01099"></a><span class="lineno"> 1099</span>&#160;<span class="comment"> the loss of precision when length units system conversion scale factors </span></div><div class="line"><a name="l01100"></a><span class="lineno"> 1100</span>&#160;<span class="comment"> are applied and results are stored in int LOGFONT and TEXTMETRIC fields</span></div><div class="line"><a name="l01101"></a><span class="lineno"> 1101</span>&#160;<span class="comment"> lead to discrepancies.</span></div><div class="line"><a name="l01102"></a><span class="lineno"> 1102</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>&#160;<span class="comment"> If map_mode is 0, then ::GetMapMode(hdc) is called to get the mapping mode.</span></div><div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>&#160;<span class="comment"> Otherwised, map_mode must identify a Windows mapping mode</span></div><div class="line"><a name="l01105"></a><span class="lineno"> 1105</span>&#160;<span class="comment"> (MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, M_TWIPS).</span></div><div class="line"><a name="l01106"></a><span class="lineno"> 1106</span>&#160;<span class="comment"> If map_mode = MM_TEXT (1), then hdc is used as described in the hdc parameter.</span></div><div class="line"><a name="l01107"></a><span class="lineno"> 1107</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01108"></a><span class="lineno"> 1108</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l01109"></a><span class="lineno"> 1109</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l01110"></a><span class="lineno"> 1110</span>&#160;<span class="comment"> If map_mode is set and not MM_TEXT, then hdc is ignored.</span></div><div class="line"><a name="l01111"></a><span class="lineno"> 1111</span>&#160;<span class="comment"> Otherwise the device context is used to get the mapping mode ( GetMapMode(hdc) ). </span></div><div class="line"><a name="l01112"></a><span class="lineno"> 1112</span>&#160;<span class="comment"> If the mapping mode is MM_TEXT, then the additional device context values</span></div><div class="line"><a name="l01113"></a><span class="lineno"> 1113</span>&#160;<span class="comment"> GetDeviceCaps(hdc, LOGPIXELSY) and conversion between device and logical pixel heights</span></div><div class="line"><a name="l01114"></a><span class="lineno"> 1114</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l01115"></a><span class="lineno"> 1115</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01116"></a><span class="lineno"> 1116</span>&#160;<span class="comment"> logfont - [in]</span></div><div class="line"><a name="l01117"></a><span class="lineno"> 1117</span>&#160;<span class="comment"> If logfont.lfHeight &lt;= 0, then logfont.lfHeight is returned.</span></div><div class="line"><a name="l01118"></a><span class="lineno"> 1118</span>&#160;<span class="comment"> If logfont.lfHeight &gt; 0, then logfont face name, map_mode and hdc are </span></div><div class="line"><a name="l01119"></a><span class="lineno"> 1119</span>&#160;<span class="comment"> used to calculate the font&#39;s TEXTMETRICS tmInternalLeading value</span></div><div class="line"><a name="l01120"></a><span class="lineno"> 1120</span>&#160;<span class="comment"> -((tm.tmAscent + tm.tmDescent) - tmInternalLeading) is returned.</span></div><div class="line"><a name="l01121"></a><span class="lineno"> 1121</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01122"></a><span class="lineno"> 1122</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01123"></a><span class="lineno"> 1123</span>&#160;<span class="comment"> 0: failure</span></div><div class="line"><a name="l01124"></a><span class="lineno"> 1124</span>&#160;<span class="comment"> &lt;0: Windows LOGFONT character height in units specified by map_mode and hdc.</span></div><div class="line"><a name="l01125"></a><span class="lineno"> 1125</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01126"></a><span class="lineno"> 1126</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> WindowsLogfontCharacterHeight(</div><div class="line"><a name="l01127"></a><span class="lineno"> 1127</span>&#160; <span class="keywordtype">int</span> map_mode,</div><div class="line"><a name="l01128"></a><span class="lineno"> 1128</span>&#160; HDC hdc,</div><div class="line"><a name="l01129"></a><span class="lineno"> 1129</span>&#160; <span class="keyword">const</span> LOGFONT&amp; logfont</div><div class="line"><a name="l01130"></a><span class="lineno"> 1130</span>&#160; );</div><div class="line"><a name="l01131"></a><span class="lineno"> 1131</span>&#160;</div><div class="line"><a name="l01132"></a><span class="lineno"> 1132</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01133"></a><span class="lineno"> 1133</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01134"></a><span class="lineno"> 1134</span>&#160;<span class="comment"> Get a Windows LOGFONT cell height </span></div><div class="line"><a name="l01135"></a><span class="lineno"> 1135</span>&#160;<span class="comment"> = (TEXTMETRIC.tmAscent + TEXTMETRIC.tmDescent)</span></div><div class="line"><a name="l01136"></a><span class="lineno"> 1136</span>&#160;<span class="comment"> as a positive integer.</span></div><div class="line"><a name="l01137"></a><span class="lineno"> 1137</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01138"></a><span class="lineno"> 1138</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01139"></a><span class="lineno"> 1139</span>&#160;<span class="comment"> map_mode - [in]</span></div><div class="line"><a name="l01140"></a><span class="lineno"> 1140</span>&#160;<span class="comment"> The best results are obtained when map_mode = MM_TEXT and the hdc is</span></div><div class="line"><a name="l01141"></a><span class="lineno"> 1141</span>&#160;<span class="comment"> correctly set for the context where the font is being rendered. Otherwise</span></div><div class="line"><a name="l01142"></a><span class="lineno"> 1142</span>&#160;<span class="comment"> the loss of precision when length units system conversion scale factors </span></div><div class="line"><a name="l01143"></a><span class="lineno"> 1143</span>&#160;<span class="comment"> are applied and results are stored in int LOGFONT and TEXTMETRIC fields</span></div><div class="line"><a name="l01144"></a><span class="lineno"> 1144</span>&#160;<span class="comment"> lead to discrepancies.</span></div><div class="line"><a name="l01145"></a><span class="lineno"> 1145</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01146"></a><span class="lineno"> 1146</span>&#160;<span class="comment"> If map_mode is 0, then ::GetMapMode(hdc) is called to get the mapping mode.</span></div><div class="line"><a name="l01147"></a><span class="lineno"> 1147</span>&#160;<span class="comment"> Otherwised, map_mode must identify a Windows mapping mode</span></div><div class="line"><a name="l01148"></a><span class="lineno"> 1148</span>&#160;<span class="comment"> (MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, M_TWIPS).</span></div><div class="line"><a name="l01149"></a><span class="lineno"> 1149</span>&#160;<span class="comment"> If map_mode = MM_TEXT (1), then hdc is used as described in the hdc parameter.</span></div><div class="line"><a name="l01150"></a><span class="lineno"> 1150</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01151"></a><span class="lineno"> 1151</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l01152"></a><span class="lineno"> 1152</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l01153"></a><span class="lineno"> 1153</span>&#160;<span class="comment"> If map_mode is set and not MM_TEXT, then hdc is ignored.</span></div><div class="line"><a name="l01154"></a><span class="lineno"> 1154</span>&#160;<span class="comment"> Otherwise the device context is used to get the mapping mode ( GetMapMode(hdc) ). </span></div><div class="line"><a name="l01155"></a><span class="lineno"> 1155</span>&#160;<span class="comment"> If the mapping mode is MM_TEXT, then the additional device context values</span></div><div class="line"><a name="l01156"></a><span class="lineno"> 1156</span>&#160;<span class="comment"> GetDeviceCaps(hdc, LOGPIXELSY) and conversion between device and logical pixel heights</span></div><div class="line"><a name="l01157"></a><span class="lineno"> 1157</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l01158"></a><span class="lineno"> 1158</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01159"></a><span class="lineno"> 1159</span>&#160;<span class="comment"> logfont - [in]</span></div><div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>&#160;<span class="comment"> If logfont.lfHeight &gt;= 0, then logfont.lfHeight is returned.</span></div><div class="line"><a name="l01161"></a><span class="lineno"> 1161</span>&#160;<span class="comment"> If logfont.lfHeight &lt; 0, then logfont face name, map_mode and hdc are </span></div><div class="line"><a name="l01162"></a><span class="lineno"> 1162</span>&#160;<span class="comment"> used to calculate the font&#39;s TEXTMETRIC and</span></div><div class="line"><a name="l01163"></a><span class="lineno"> 1163</span>&#160;<span class="comment"> (tm.tmAscent + tm.tmDescent) is returned.</span></div><div class="line"><a name="l01164"></a><span class="lineno"> 1164</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01165"></a><span class="lineno"> 1165</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01166"></a><span class="lineno"> 1166</span>&#160;<span class="comment"> 0: failure</span></div><div class="line"><a name="l01167"></a><span class="lineno"> 1167</span>&#160;<span class="comment"> &gt;0: Windows LOGFONT cell height in units specified by map_mode and hdc.</span></div><div class="line"><a name="l01168"></a><span class="lineno"> 1168</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01169"></a><span class="lineno"> 1169</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> WindowsLogfontCellHeight(</div><div class="line"><a name="l01170"></a><span class="lineno"> 1170</span>&#160; <span class="keywordtype">int</span> map_mode,</div><div class="line"><a name="l01171"></a><span class="lineno"> 1171</span>&#160; HDC hdc,</div><div class="line"><a name="l01172"></a><span class="lineno"> 1172</span>&#160; <span class="keyword">const</span> LOGFONT&amp; logfont</div><div class="line"><a name="l01173"></a><span class="lineno"> 1173</span>&#160; );</div><div class="line"><a name="l01174"></a><span class="lineno"> 1174</span>&#160;</div><div class="line"><a name="l01175"></a><span class="lineno"> 1175</span>&#160;</div><div class="line"><a name="l01176"></a><span class="lineno"> 1176</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01177"></a><span class="lineno"> 1177</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01178"></a><span class="lineno"> 1178</span>&#160;<span class="comment"> Get a Windows text metrics.</span></div><div class="line"><a name="l01179"></a><span class="lineno"> 1179</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01180"></a><span class="lineno"> 1180</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01181"></a><span class="lineno"> 1181</span>&#160;<span class="comment"> map_mode - [in]</span></div><div class="line"><a name="l01182"></a><span class="lineno"> 1182</span>&#160;<span class="comment"> The best results are obtained when map_mode = MM_TEXT and the hdc is</span></div><div class="line"><a name="l01183"></a><span class="lineno"> 1183</span>&#160;<span class="comment"> correctly set for the context where the font is being rendered. Otherwise</span></div><div class="line"><a name="l01184"></a><span class="lineno"> 1184</span>&#160;<span class="comment"> the loss of precision when length units system conversion scale factors </span></div><div class="line"><a name="l01185"></a><span class="lineno"> 1185</span>&#160;<span class="comment"> are applied and results are stored in int LOGFONT and TEXTMETRIC fields</span></div><div class="line"><a name="l01186"></a><span class="lineno"> 1186</span>&#160;<span class="comment"> lead to discrepancies.</span></div><div class="line"><a name="l01187"></a><span class="lineno"> 1187</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01188"></a><span class="lineno"> 1188</span>&#160;<span class="comment"> If map_mode is 0, then ::GetMapMode(hdc) is called to get the mapping mode.</span></div><div class="line"><a name="l01189"></a><span class="lineno"> 1189</span>&#160;<span class="comment"> Otherwised, map_mode must identify a Windows mapping mode</span></div><div class="line"><a name="l01190"></a><span class="lineno"> 1190</span>&#160;<span class="comment"> (MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, M_TWIPS).</span></div><div class="line"><a name="l01191"></a><span class="lineno"> 1191</span>&#160;<span class="comment"> If map_mode = MM_TEXT (1), then hdc is used as described in the hdc parameter.</span></div><div class="line"><a name="l01192"></a><span class="lineno"> 1192</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01193"></a><span class="lineno"> 1193</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l01194"></a><span class="lineno"> 1194</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l01195"></a><span class="lineno"> 1195</span>&#160;<span class="comment"> If map_mode is set and not MM_TEXT, then hdc is ignored.</span></div><div class="line"><a name="l01196"></a><span class="lineno"> 1196</span>&#160;<span class="comment"> Otherwise the device context is used to get the mapping mode ( GetMapMode(hdc) ). </span></div><div class="line"><a name="l01197"></a><span class="lineno"> 1197</span>&#160;<span class="comment"> If the mapping mode is MM_TEXT, then the additional device context values</span></div><div class="line"><a name="l01198"></a><span class="lineno"> 1198</span>&#160;<span class="comment"> GetDeviceCaps(hdc, LOGPIXELSY) and conversion between device and logical pixel heights</span></div><div class="line"><a name="l01199"></a><span class="lineno"> 1199</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l01200"></a><span class="lineno"> 1200</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01201"></a><span class="lineno"> 1201</span>&#160;<span class="comment"> logfont - [in]</span></div><div class="line"><a name="l01202"></a><span class="lineno"> 1202</span>&#160;<span class="comment"> If logfont.lfHeight &gt;= 0, then logfont.lfHeight is returned.</span></div><div class="line"><a name="l01203"></a><span class="lineno"> 1203</span>&#160;<span class="comment"> If logfont.lfHeight &lt; 0, then logfont face name, map_mode and hdc are </span></div><div class="line"><a name="l01204"></a><span class="lineno"> 1204</span>&#160;<span class="comment"> used to calculate the font&#39;s TEXTMETRIC and</span></div><div class="line"><a name="l01205"></a><span class="lineno"> 1205</span>&#160;<span class="comment"> (tm.tmAscent + tm.tmDescent) is returned.</span></div><div class="line"><a name="l01206"></a><span class="lineno"> 1206</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01207"></a><span class="lineno"> 1207</span>&#160;<span class="comment"> textmetric - [out]</span></div><div class="line"><a name="l01208"></a><span class="lineno"> 1208</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01209"></a><span class="lineno"> 1209</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01210"></a><span class="lineno"> 1210</span>&#160;<span class="comment"> 0: failure</span></div><div class="line"><a name="l01211"></a><span class="lineno"> 1211</span>&#160;<span class="comment"> &gt;0: Windows LOGFONT cell height in units specified by map_mode and hdc.</span></div><div class="line"><a name="l01212"></a><span class="lineno"> 1212</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01213"></a><span class="lineno"> 1213</span>&#160; <span class="keyword">static</span> <span class="keywordtype">bool</span> GetWindowsTextMetrics(</div><div class="line"><a name="l01214"></a><span class="lineno"> 1214</span>&#160; <span class="keywordtype">int</span> map_mode,</div><div class="line"><a name="l01215"></a><span class="lineno"> 1215</span>&#160; HDC hdc,</div><div class="line"><a name="l01216"></a><span class="lineno"> 1216</span>&#160; <span class="keyword">const</span> LOGFONT&amp; logfont,</div><div class="line"><a name="l01217"></a><span class="lineno"> 1217</span>&#160; TEXTMETRIC&amp; textmetric</div><div class="line"><a name="l01218"></a><span class="lineno"> 1218</span>&#160; );</div><div class="line"><a name="l01219"></a><span class="lineno"> 1219</span>&#160;</div><div class="line"><a name="l01220"></a><span class="lineno"> 1220</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01221"></a><span class="lineno"> 1221</span>&#160; <span class="keyword">static</span> HDC Internal_CreateWindowsLogfontDeviceContext();</div><div class="line"><a name="l01222"></a><span class="lineno"> 1222</span>&#160; <span class="keyword">static</span> <span class="keywordtype">void</span> Internal_DeleteWindowsLogfontDeviceContext(</div><div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>&#160; HDC hdc</div><div class="line"><a name="l01224"></a><span class="lineno"> 1224</span>&#160; );</div><div class="line"><a name="l01225"></a><span class="lineno"> 1225</span>&#160;</div><div class="line"><a name="l01226"></a><span class="lineno"> 1226</span>&#160;<span class="keyword">public</span>: </div><div class="line"><a name="l01227"></a><span class="lineno"> 1227</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01228"></a><span class="lineno"> 1228</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01229"></a><span class="lineno"> 1229</span>&#160;<span class="comment"> Set ON_Font properties from a subset of the LOGFONT properties.</span></div><div class="line"><a name="l01230"></a><span class="lineno"> 1230</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01231"></a><span class="lineno"> 1231</span>&#160;<span class="comment"> map_mode - [in]</span></div><div class="line"><a name="l01232"></a><span class="lineno"> 1232</span>&#160;<span class="comment"> If map_mode is 0, then ::GetMapMode(hdc) is called to get the mapping mode.</span></div><div class="line"><a name="l01233"></a><span class="lineno"> 1233</span>&#160;<span class="comment"> Otherwised, map_mode must identify a Windows mapping mode</span></div><div class="line"><a name="l01234"></a><span class="lineno"> 1234</span>&#160;<span class="comment"> (MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, M_TWIPS).</span></div><div class="line"><a name="l01235"></a><span class="lineno"> 1235</span>&#160;<span class="comment"> If map_mode = MM_TEXT (1), then hdc is used as described in the hdc parameter.</span></div><div class="line"><a name="l01236"></a><span class="lineno"> 1236</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l01237"></a><span class="lineno"> 1237</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l01238"></a><span class="lineno"> 1238</span>&#160;<span class="comment"> If map_mode is set and not MM_TEXT, then hdc is ignored.</span></div><div class="line"><a name="l01239"></a><span class="lineno"> 1239</span>&#160;<span class="comment"> Otherwise the device context is used to get the mapping mode ( GetMapMode(hdc) ). </span></div><div class="line"><a name="l01240"></a><span class="lineno"> 1240</span>&#160;<span class="comment"> If the mapping mode is MM_TEXT, then the additional device context values</span></div><div class="line"><a name="l01241"></a><span class="lineno"> 1241</span>&#160;<span class="comment"> GetDeviceCaps(hdc, LOGPIXELSY) and conversion between device and logical pixel heights</span></div><div class="line"><a name="l01242"></a><span class="lineno"> 1242</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l01243"></a><span class="lineno"> 1243</span>&#160;<span class="comment"> logfont - [in]</span></div><div class="line"><a name="l01244"></a><span class="lineno"> 1244</span>&#160;<span class="comment"> These logfont properties are used to set the ON_Font.</span></div><div class="line"><a name="l01245"></a><span class="lineno"> 1245</span>&#160;<span class="comment"> lfHeight (when dc is not zero),</span></div><div class="line"><a name="l01246"></a><span class="lineno"> 1246</span>&#160;<span class="comment"> lfWeight</span></div><div class="line"><a name="l01247"></a><span class="lineno"> 1247</span>&#160;<span class="comment"> lfItalic</span></div><div class="line"><a name="l01248"></a><span class="lineno"> 1248</span>&#160;<span class="comment"> lfUnderline</span></div><div class="line"><a name="l01249"></a><span class="lineno"> 1249</span>&#160;<span class="comment"> lfStrikeOut</span></div><div class="line"><a name="l01250"></a><span class="lineno"> 1250</span>&#160;<span class="comment"> lfCharSet</span></div><div class="line"><a name="l01251"></a><span class="lineno"> 1251</span>&#160;<span class="comment"> lfFaceName[LF_FACESIZE];</span></div><div class="line"><a name="l01252"></a><span class="lineno"> 1252</span>&#160;<span class="comment"> All other LOGFONT properties are ignored.</span></div><div class="line"><a name="l01253"></a><span class="lineno"> 1253</span>&#160;<span class="comment"> See Also:</span></div><div class="line"><a name="l01254"></a><span class="lineno"> 1254</span>&#160;<span class="comment"> ON_Font::SetFromWindowsLogFontPartialComplete</span></div><div class="line"><a name="l01255"></a><span class="lineno"> 1255</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01256"></a><span class="lineno"> 1256</span>&#160; <span class="keywordtype">bool</span> SetFromWindowsLogFont(</div><div class="line"><a name="l01257"></a><span class="lineno"> 1257</span>&#160; <span class="keywordtype">int</span> map_mode,</div><div class="line"><a name="l01258"></a><span class="lineno"> 1258</span>&#160; HDC hdc,</div><div class="line"><a name="l01259"></a><span class="lineno"> 1259</span>&#160; <span class="keyword">const</span> LOGFONT&amp; logfont</div><div class="line"><a name="l01260"></a><span class="lineno"> 1260</span>&#160; );</div><div class="line"><a name="l01261"></a><span class="lineno"> 1261</span>&#160;</div><div class="line"><a name="l01262"></a><span class="lineno"> 1262</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01263"></a><span class="lineno"> 1263</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01264"></a><span class="lineno"> 1264</span>&#160;<span class="comment"> map_mode - [in]</span></div><div class="line"><a name="l01265"></a><span class="lineno"> 1265</span>&#160;<span class="comment"> If map_mode is 0, then ::GetMapMode(hdc) is called to get the mapping mode.</span></div><div class="line"><a name="l01266"></a><span class="lineno"> 1266</span>&#160;<span class="comment"> Otherwised, map_mode must identify a Windows mapping mode</span></div><div class="line"><a name="l01267"></a><span class="lineno"> 1267</span>&#160;<span class="comment"> (MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, M_TWIPS).</span></div><div class="line"><a name="l01268"></a><span class="lineno"> 1268</span>&#160;<span class="comment"> If map_mode = MM_TEXT (1), then hdc is used as described in the hdc parameter.</span></div><div class="line"><a name="l01269"></a><span class="lineno"> 1269</span>&#160;<span class="comment"> hdc - [in]</span></div><div class="line"><a name="l01270"></a><span class="lineno"> 1270</span>&#160;<span class="comment"> Windows device context.</span></div><div class="line"><a name="l01271"></a><span class="lineno"> 1271</span>&#160;<span class="comment"> If map_mode is set and not MM_TEXT, then hdc is ignored.</span></div><div class="line"><a name="l01272"></a><span class="lineno"> 1272</span>&#160;<span class="comment"> Otherwise the device context is used to get the mapping mode ( GetMapMode(hdc) ). </span></div><div class="line"><a name="l01273"></a><span class="lineno"> 1273</span>&#160;<span class="comment"> If the mapping mode is MM_TEXT, then the additional device context values</span></div><div class="line"><a name="l01274"></a><span class="lineno"> 1274</span>&#160;<span class="comment"> GetDeviceCaps(hdc, LOGPIXELSY) and conversion between device and logical pixel heights</span></div><div class="line"><a name="l01275"></a><span class="lineno"> 1275</span>&#160;<span class="comment"> DPtoLP(hdc,...) and LPtoDP(hdc,...) are used.</span></div><div class="line"><a name="l01276"></a><span class="lineno"> 1276</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01277"></a><span class="lineno"> 1277</span>&#160;<span class="comment"> A Windows LOGFONT with propeties copied from this ON_Font.</span></div><div class="line"><a name="l01278"></a><span class="lineno"> 1278</span>&#160;<span class="comment"> If WindowsLogFontIsComplete() is true, then all LOGFONT properties</span></div><div class="line"><a name="l01279"></a><span class="lineno"> 1279</span>&#160;<span class="comment"> are copied from the ON_Font. </span></div><div class="line"><a name="l01280"></a><span class="lineno"> 1280</span>&#160;<span class="comment"> If WindowsLogFontIsComplete() is false, then the LOGFONT lfHeight,</span></div><div class="line"><a name="l01281"></a><span class="lineno"> 1281</span>&#160;<span class="comment"> lfWidth, lfEscapement, lfOrientation, lfClipPrecision, lfQuality,</span></div><div class="line"><a name="l01282"></a><span class="lineno"> 1282</span>&#160;<span class="comment"> lfPitchAndFamily, and lfOutPrecision properties are set to ON_Font</span></div><div class="line"><a name="l01283"></a><span class="lineno"> 1283</span>&#160;<span class="comment"> default values.</span></div><div class="line"><a name="l01284"></a><span class="lineno"> 1284</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01285"></a><span class="lineno"> 1285</span>&#160; <span class="keyword">const</span> LOGFONT WindowsLogFont(</div><div class="line"><a name="l01286"></a><span class="lineno"> 1286</span>&#160; <span class="keywordtype">int</span> map_mode,</div><div class="line"><a name="l01287"></a><span class="lineno"> 1287</span>&#160; HDC hdc</div><div class="line"><a name="l01288"></a><span class="lineno"> 1288</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l01289"></a><span class="lineno"> 1289</span>&#160;</div><div class="line"><a name="l01290"></a><span class="lineno"> 1290</span>&#160; <span class="keyword">const</span> MAT2 WindowsFontMat2() <span class="keyword">const</span>;</div><div class="line"><a name="l01291"></a><span class="lineno"> 1291</span>&#160;</div><div class="line"><a name="l01292"></a><span class="lineno"> 1292</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l01293"></a><span class="lineno"> 1293</span>&#160;</div><div class="line"><a name="l01294"></a><span class="lineno"> 1294</span>&#160;<span class="preprocessor">#if defined (ON_RUNTIME_APPLE_OBJECTIVE_C_AVAILABLE)</span></div><div class="line"><a name="l01295"></a><span class="lineno"> 1295</span>&#160; <span class="keywordtype">bool</span> SetFromAppleFont (NSFont* apple_font);</div><div class="line"><a name="l01296"></a><span class="lineno"> 1296</span>&#160; NSFont* AppleFont() <span class="keyword">const</span>;</div><div class="line"><a name="l01297"></a><span class="lineno"> 1297</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l01298"></a><span class="lineno"> 1298</span>&#160;</div><div class="line"><a name="l01299"></a><span class="lineno"> 1299</span>&#160; <span class="keywordtype">bool</span> SetFromAppleFontName(</div><div class="line"><a name="l01300"></a><span class="lineno"> 1300</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* apple_font_name</div><div class="line"><a name="l01301"></a><span class="lineno"> 1301</span>&#160; );</div><div class="line"><a name="l01302"></a><span class="lineno"> 1302</span>&#160; </div><div class="line"><a name="l01303"></a><span class="lineno"> 1303</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d1/d11/class_o_n__w_string.html">ON_wString</a>&amp; AppleFontName() <span class="keyword">const</span>;</div><div class="line"><a name="l01304"></a><span class="lineno"> 1304</span>&#160; </div><div class="line"><a name="l01305"></a><span class="lineno"> 1305</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* AppleFontNameAsPointer() <span class="keyword">const</span>;</div><div class="line"><a name="l01306"></a><span class="lineno"> 1306</span>&#160;</div><div class="line"><a name="l01307"></a><span class="lineno"> 1307</span>&#160; <span class="keywordtype">bool</span> SetFromFontDescription(</div><div class="line"><a name="l01308"></a><span class="lineno"> 1308</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* font_description</div><div class="line"><a name="l01309"></a><span class="lineno"> 1309</span>&#160; );</div><div class="line"><a name="l01310"></a><span class="lineno"> 1310</span>&#160;</div><div class="line"><a name="l01311"></a><span class="lineno"> 1311</span>&#160; <span class="keywordtype">bool</span> SetFromFontDescription(</div><div class="line"><a name="l01312"></a><span class="lineno"> 1312</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* font_description,</div><div class="line"><a name="l01313"></a><span class="lineno"> 1313</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* apple_font_name</div><div class="line"><a name="l01314"></a><span class="lineno"> 1314</span>&#160; );</div><div class="line"><a name="l01315"></a><span class="lineno"> 1315</span>&#160;</div><div class="line"><a name="l01316"></a><span class="lineno"> 1316</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01317"></a><span class="lineno"> 1317</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01318"></a><span class="lineno"> 1318</span>&#160;<span class="comment"> Tests an object to see if its data members are correctly</span></div><div class="line"><a name="l01319"></a><span class="lineno"> 1319</span>&#160;<span class="comment"> initialized.</span></div><div class="line"><a name="l01320"></a><span class="lineno"> 1320</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01321"></a><span class="lineno"> 1321</span>&#160;<span class="comment"> text_log - [in] if the object is not valid and text_log</span></div><div class="line"><a name="l01322"></a><span class="lineno"> 1322</span>&#160;<span class="comment"> is not nullptr, then a brief englis description of the</span></div><div class="line"><a name="l01323"></a><span class="lineno"> 1323</span>&#160;<span class="comment"> reason the object is not valid is appened to the log.</span></div><div class="line"><a name="l01324"></a><span class="lineno"> 1324</span>&#160;<span class="comment"> The information appended to text_log is suitable for </span></div><div class="line"><a name="l01325"></a><span class="lineno"> 1325</span>&#160;<span class="comment"> low-level debugging purposes by programmers and is </span></div><div class="line"><a name="l01326"></a><span class="lineno"> 1326</span>&#160;<span class="comment"> not intended to be useful as a high level user </span></div><div class="line"><a name="l01327"></a><span class="lineno"> 1327</span>&#160;<span class="comment"> interface tool.</span></div><div class="line"><a name="l01328"></a><span class="lineno"> 1328</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01329"></a><span class="lineno"> 1329</span>&#160;<span class="comment"> @untitled table</span></div><div class="line"><a name="l01330"></a><span class="lineno"> 1330</span>&#160;<span class="comment"> true object is valid</span></div><div class="line"><a name="l01331"></a><span class="lineno"> 1331</span>&#160;<span class="comment"> false object is invalid, uninitialized, etc.</span></div><div class="line"><a name="l01332"></a><span class="lineno"> 1332</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01333"></a><span class="lineno"> 1333</span>&#160; <span class="keywordtype">bool</span> IsValid( <a class="code" href="../../d2/da3/class_o_n___text_log.html">ON_TextLog</a>* text_log = <span class="keyword">nullptr</span> ) <span class="keyword">const</span>;</div><div class="line"><a name="l01334"></a><span class="lineno"> 1334</span>&#160;</div><div class="line"><a name="l01335"></a><span class="lineno"> 1335</span>&#160; <span class="keywordtype">void</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html#aa1be2ecdf7d6e8b505f858701731ea90">Dump</a>( <a class="code" href="../../d2/da3/class_o_n___text_log.html">ON_TextLog</a>&amp; ) <span class="keyword">const</span>; <span class="comment">// for debugging</span></div><div class="line"><a name="l01336"></a><span class="lineno"> 1336</span>&#160;</div><div class="line"><a name="l01337"></a><span class="lineno"> 1337</span>&#160;</div><div class="line"><a name="l01338"></a><span class="lineno"> 1338</span>&#160; <span class="keywordtype">void</span> DumpFreeType(</div><div class="line"><a name="l01339"></a><span class="lineno"> 1339</span>&#160; <a class="code" href="../../d2/da3/class_o_n___text_log.html">ON_TextLog</a>&amp; text_log</div><div class="line"><a name="l01340"></a><span class="lineno"> 1340</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l01341"></a><span class="lineno"> 1341</span>&#160;</div><div class="line"><a name="l01342"></a><span class="lineno"> 1342</span>&#160; <span class="keyword">static</span> <span class="keywordtype">void</span> DumpFreeTypeFace(</div><div class="line"><a name="l01343"></a><span class="lineno"> 1343</span>&#160; ON__UINT_PTR free_type_face_ptr,</div><div class="line"><a name="l01344"></a><span class="lineno"> 1344</span>&#160; <a class="code" href="../../d2/da3/class_o_n___text_log.html">ON_TextLog</a>&amp; text_log</div><div class="line"><a name="l01345"></a><span class="lineno"> 1345</span>&#160; );</div><div class="line"><a name="l01346"></a><span class="lineno"> 1346</span>&#160;</div><div class="line"><a name="l01347"></a><span class="lineno"> 1347</span>&#160;<span class="preprocessor">#if defined(ON_OS_WINDOWS_GDI)</span></div><div class="line"><a name="l01348"></a><span class="lineno"> 1348</span>&#160; <span class="keyword">static</span> <span class="keywordtype">void</span> DumpLogfont(</div><div class="line"><a name="l01349"></a><span class="lineno"> 1349</span>&#160; <span class="keyword">const</span> LOGFONT* logfont,</div><div class="line"><a name="l01350"></a><span class="lineno"> 1350</span>&#160; <a class="code" href="../../d2/da3/class_o_n___text_log.html">ON_TextLog</a>&amp; text_log</div><div class="line"><a name="l01351"></a><span class="lineno"> 1351</span>&#160; );</div><div class="line"><a name="l01352"></a><span class="lineno"> 1352</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l01353"></a><span class="lineno"> 1353</span>&#160;</div><div class="line"><a name="l01354"></a><span class="lineno"> 1354</span>&#160; <span class="comment">// serialize definition to binary archive</span></div><div class="line"><a name="l01355"></a><span class="lineno"> 1355</span>&#160; <span class="keywordtype">bool</span> Write( <a class="code" href="../../db/d16/class_o_n___binary_archive.html">ON_BinaryArchive</a>&amp; ) <span class="keyword">const</span>;</div><div class="line"><a name="l01356"></a><span class="lineno"> 1356</span>&#160;</div><div class="line"><a name="l01357"></a><span class="lineno"> 1357</span>&#160; <span class="comment">// restore definition from binary archive</span></div><div class="line"><a name="l01358"></a><span class="lineno"> 1358</span>&#160; <span class="keywordtype">bool</span> Read( <a class="code" href="../../db/d16/class_o_n___binary_archive.html">ON_BinaryArchive</a>&amp; );</div><div class="line"><a name="l01359"></a><span class="lineno"> 1359</span>&#160;</div><div class="line"><a name="l01360"></a><span class="lineno"> 1360</span>&#160; <span class="comment">// V6 separated the V5 ON_Font into ON_TextStyle and ON_Font.</span></div><div class="line"><a name="l01361"></a><span class="lineno"> 1361</span>&#160; <span class="keywordtype">bool</span> WriteV5(</div><div class="line"><a name="l01362"></a><span class="lineno"> 1362</span>&#160; <span class="keywordtype">int</span> V5_font_index,</div><div class="line"><a name="l01363"></a><span class="lineno"> 1363</span>&#160; <a class="code" href="../../d8/db4/struct_o_n___u_u_i_d__struct.html">ON_UUID</a> V5_font_id,</div><div class="line"><a name="l01364"></a><span class="lineno"> 1364</span>&#160; <a class="code" href="../../db/d16/class_o_n___binary_archive.html">ON_BinaryArchive</a>&amp; </div><div class="line"><a name="l01365"></a><span class="lineno"> 1365</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l01366"></a><span class="lineno"> 1366</span>&#160;</div><div class="line"><a name="l01367"></a><span class="lineno"> 1367</span>&#160; <span class="comment">// V6 separated the V5 ON_Font into ON_TextStyle and ON_Font.</span></div><div class="line"><a name="l01368"></a><span class="lineno"> 1368</span>&#160; <span class="keywordtype">bool</span> ReadV5( </div><div class="line"><a name="l01369"></a><span class="lineno"> 1369</span>&#160; <a class="code" href="../../db/d16/class_o_n___binary_archive.html">ON_BinaryArchive</a>&amp;, </div><div class="line"><a name="l01370"></a><span class="lineno"> 1370</span>&#160; <span class="keywordtype">int</span>* V5_font_index,</div><div class="line"><a name="l01371"></a><span class="lineno"> 1371</span>&#160; <a class="code" href="../../d8/db4/struct_o_n___u_u_i_d__struct.html">ON_UUID</a>* V5_font_id</div><div class="line"><a name="l01372"></a><span class="lineno"> 1372</span>&#160; );</div><div class="line"><a name="l01373"></a><span class="lineno"> 1373</span>&#160;</div><div class="line"><a name="l01374"></a><span class="lineno"> 1374</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01375"></a><span class="lineno"> 1375</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01376"></a><span class="lineno"> 1376</span>&#160;<span class="comment"> 0: This is not a managed font.</span></div><div class="line"><a name="l01377"></a><span class="lineno"> 1377</span>&#160;<span class="comment"> 1: This is the managed font ON_Font::Default.</span></div><div class="line"><a name="l01378"></a><span class="lineno"> 1378</span>&#160;<span class="comment"> &gt;= 2: This is a managed font other than ON_Font::Default.</span></div><div class="line"><a name="l01379"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38"> 1379</a></span>&#160;<span class="comment"> Remark:</span></div><div class="line"><a name="l01380"></a><span class="lineno"> 1380</span>&#160;<span class="comment"> For managed fonts other than ON_Font::Default, the value of RuntimeSerialNumber()</span></div><div class="line"><a name="l01381"></a><span class="lineno"> 1381</span>&#160;<span class="comment"> typically varies between instances of the same application. </span></div><div class="line"><a name="l01382"></a><span class="lineno"> 1382</span>&#160;<span class="comment"> Different platforms and application versions may use different font faces for ON_Font::Default.</span></div><div class="line"><a name="l01383"></a><span class="lineno"> 1383</span>&#160;<span class="comment"> If an ON_Font is a managed font, then RuntimeSerialNumber() and ManagedFontSerialNumber()</span></div><div class="line"><a name="l01384"></a><span class="lineno"> 1384</span>&#160;<span class="comment"> are identical. If an ON_Font is not a managed font, then RuntimeSerialNumber() is zero.</span></div><div class="line"><a name="l01385"></a><span class="lineno"> 1385</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01386"></a><span class="lineno"> 1386</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> RuntimeSerialNumber() <span class="keyword">const</span>;</div><div class="line"><a name="l01387"></a><span class="lineno"> 1387</span>&#160;</div><div class="line"><a name="l01388"></a><span class="lineno"> 1388</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01389"></a><span class="lineno"> 1389</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01390"></a><span class="lineno"> 1390</span>&#160;<span class="comment"> Two ON_Font classes reference the same platform font and create identical glyphs </span></div><div class="line"><a name="l01391"></a><span class="lineno"> 1391</span>&#160;<span class="comment"> if and only if the have the same ManagedFontSerialNumber().</span></div><div class="line"><a name="l01392"></a><span class="lineno"> 1392</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01393"></a><span class="lineno"> 1393</span>&#160;<span class="comment"> 0: This font is unset.</span></div><div class="line"><a name="l01394"></a><span class="lineno"> 1394</span>&#160;<span class="comment"> &gt;= 1: Serial number of the managed font with the same characteristics.</span></div><div class="line"><a name="l01395"></a><span class="lineno"> 1395</span>&#160;<span class="comment"> Remark:</span></div><div class="line"><a name="l01396"></a><span class="lineno"> 1396</span>&#160;<span class="comment"> For managed fonts other than ON_Font::Default, the value of ManagedFontSerialNumber()</span></div><div class="line"><a name="l01397"></a><span class="lineno"> 1397</span>&#160;<span class="comment"> typically varies between instances of the same application. </span></div><div class="line"><a name="l01398"></a><span class="lineno"> 1398</span>&#160;<span class="comment"> Different platforms and application versions may use different font faces </span></div><div class="line"><a name="l01399"></a><span class="lineno"> 1399</span>&#160;<span class="comment"> for ON_Font::Default.</span></div><div class="line"><a name="l01400"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38a4cd1ec148d80517b57de5a9d1f9e9892"> 1400</a></span>&#160;<span class="comment"> If an ON_Font is a managed font, then RuntimeSerialNumber() and ManagedFontSerialNumber()</span></div><div class="line"><a name="l01401"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38a0570807fdc3560f77f6ff61b35b80532"> 1401</a></span>&#160;<span class="comment"> are identical. If an ON_Font is not a managed font, then RuntimeSerialNumber() is zero.</span></div><div class="line"><a name="l01402"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38a26502dfefeebee05b76f2de69b770c9c"> 1402</a></span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01403"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38a864ac43e20b3142ae64436c16200bdec"> 1403</a></span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> ManagedFontSerialNumber() <span class="keyword">const</span>;</div><div class="line"><a name="l01404"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38a8d709c649c10491f7e466cfe3869e4ad"> 1404</a></span>&#160;<span class="comment"></span></div><div class="line"><a name="l01405"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38a4a0db9463138f2e8ff825e41a64961c5"> 1405</a></span>&#160;<span class="comment"> //////////////////////////////////////////////////////////////////////</span></div><div class="line"><a name="l01406"></a><span class="lineno"> 1406</span>&#160;<span class="comment"></span> <span class="comment">//</span></div><div class="line"><a name="l01407"></a><span class="lineno"> 1407</span>&#160; <span class="comment">// Interface</span></div><div class="line"><a name="l01408"></a><span class="lineno"> 1408</span>&#160; </div><div class="line"><a name="l01409"></a><span class="lineno"> 1409</span>&#160; <span class="keyword">enum</span> <a class="code" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38">WindowsConstants</a> : <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span></div><div class="line"><a name="l01410"></a><span class="lineno"> 1410</span>&#160; { </div><div class="line"><a name="l01411"></a><span class="lineno"> 1411</span>&#160; <span class="comment">// Values used to set Windows LOGFONT fields.</span></div><div class="line"><a name="l01412"></a><span class="lineno"> 1412</span>&#160;<span class="preprocessor">#if defined(ON_OS_WINDOWS_GDI)</span></div><div class="line"><a name="l01413"></a><span class="lineno"> 1413</span>&#160; logfont_ansi_charset = ANSI_CHARSET,</div><div class="line"><a name="l01414"></a><span class="lineno"> 1414</span>&#160; logfont_default_charset = DEFAULT_CHARSET, <span class="comment">// LOGFONT.lfCharSet</span></div><div class="line"><a name="l01415"></a><span class="lineno"> 1415</span>&#160; logfont_symbol_charset = SYMBOL_CHARSET, <span class="comment">// LOGFONT.lfCharSet</span></div><div class="line"><a name="l01416"></a><span class="lineno"> 1416</span>&#160; logfont_out_precis = OUT_TT_ONLY_PRECIS, <span class="comment">// LOGFONT.lfOutPrecision</span></div><div class="line"><a name="l01417"></a><span class="lineno"> 1417</span>&#160;</div><div class="line"><a name="l01418"></a><span class="lineno"> 1418</span>&#160; <span class="comment">// 2017-07-27, Brian Gillespie</span></div><div class="line"><a name="l01419"></a><span class="lineno"> 1419</span>&#160; <span class="comment">// Changed ON_Font::WindowsConstants::logfont_quality from ANTIALIASED_QUALITY to DEFAULT_QUALITY.</span></div><div class="line"><a name="l01420"></a><span class="lineno"> 1420</span>&#160; <span class="comment">// This makes it so that ON_Font conversion to LOGFONT results in a good-looking font when rendered by MFC.</span></div><div class="line"><a name="l01421"></a><span class="lineno"> 1421</span>&#160; <span class="comment">// With lfQuality set to ANTIALIASED_QUALITY, the font looks crummy - probably because all the rest of the fonts</span></div><div class="line"><a name="l01422"></a><span class="lineno"> 1422</span>&#160; <span class="comment">// are being rendered today with CLEARTYPE_QUALITY. Letting Windows decide what to do is probably better.</span></div><div class="line"><a name="l01423"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#ab55ead78e0fc5501a58ba69cc1f5d023"> 1423</a></span>&#160; logfont_quality = DEFAULT_QUALITY, <span class="comment">// LOGFONT.lfQuality</span></div><div class="line"><a name="l01424"></a><span class="lineno"> 1424</span>&#160;</div><div class="line"><a name="l01425"></a><span class="lineno"> 1425</span>&#160; logfont_pitch_and_family = (DEFAULT_PITCH | FF_DONTCARE), <span class="comment">// LOGFONT.lfPitchAndFamily</span></div><div class="line"><a name="l01426"></a><span class="lineno"> 1426</span>&#160;#<span class="keywordflow">else</span></div><div class="line"><a name="l01427"></a><span class="lineno"> 1427</span>&#160; <span class="comment">// The values below are identical to the ones above and</span></div><div class="line"><a name="l01428"></a><span class="lineno"> 1428</span>&#160; <span class="comment">// are used to insure code compiles for Apple and other</span></div><div class="line"><a name="l01429"></a><span class="lineno"> 1429</span>&#160; <span class="comment">// platforms. </span></div><div class="line"><a name="l01430"></a><span class="lineno"> 1430</span>&#160; logfont_ansi_charset = 0,</div><div class="line"><a name="l01431"></a><span class="lineno"> 1431</span>&#160; logfont_default_charset = 1,</div><div class="line"><a name="l01432"></a><span class="lineno"> 1432</span>&#160; logfont_symbol_charset = 2,</div><div class="line"><a name="l01433"></a><span class="lineno"> 1433</span>&#160; logfont_out_precis = 7,</div><div class="line"><a name="l01434"></a><span class="lineno"> 1434</span>&#160; logfont_quality = 4,</div><div class="line"><a name="l01435"></a><span class="lineno"> 1435</span>&#160; logfont_pitch_and_family = 0</div><div class="line"><a name="l01436"></a><span class="lineno"> 1436</span>&#160;#endif</div><div class="line"><a name="l01437"></a><span class="lineno"> 1437</span>&#160; }; </div><div class="line"><a name="l01438"></a><span class="lineno"> 1438</span>&#160;</div><div class="line"><a name="l01439"></a><span class="lineno"> 1439</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01440"></a><span class="lineno"> 1440</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01441"></a><span class="lineno"> 1441</span>&#160;<span class="comment"> face_name - [in] </span></div><div class="line"><a name="l01442"></a><span class="lineno"> 1442</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01443"></a><span class="lineno"> 1443</span>&#160;<span class="comment"> If the code is running on Windows:</span></div><div class="line"><a name="l01444"></a><span class="lineno"> 1444</span>&#160;<span class="comment"> The appropriate value of LOGFONT.lfCharSet for the input facename.</span></div><div class="line"><a name="l01445"></a><span class="lineno"> 1445</span>&#160;<span class="comment"> If the code is not running on Windows:</span></div><div class="line"><a name="l01446"></a><span class="lineno"> 1446</span>&#160;<span class="comment"> ON_Font::WindowsConstants::logfont_default_charset.</span></div><div class="line"><a name="l01447"></a><span class="lineno"> 1447</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01448"></a><span class="lineno"> 1448</span>&#160; <span class="keyword">static</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> WindowsLogfontCharSetFromFaceName(</div><div class="line"><a name="l01449"></a><span class="lineno"> 1449</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* face_name </div><div class="line"><a name="l01450"></a><span class="lineno"> 1450</span>&#160; );</div><div class="line"><a name="l01451"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#ab55ead78e0fc5501a58ba69cc1f5d023ae798466615e328a2329d9ce5982cb4b5"> 1451</a></span>&#160; </div><div class="line"><a name="l01452"></a><span class="lineno"> 1452</span>&#160; <span class="comment">// miscellaneous constants use to initialize Windows LOGFONT fields</span></div><div class="line"><a name="l01453"></a><span class="lineno"> 1453</span>&#160; <span class="keyword">enum</span> <a class="code" href="../../d8/df5/class_o_n___font.html#ab55ead78e0fc5501a58ba69cc1f5d023">Constants</a>: <span class="keywordtype">int</span></div><div class="line"><a name="l01454"></a><span class="lineno"> 1454</span>&#160; { </div><div class="line"><a name="l01455"></a><span class="lineno"> 1455</span>&#160; <span class="comment">// 1995 - 2015:</span></div><div class="line"><a name="l01456"></a><span class="lineno"> 1456</span>&#160; <span class="comment">// Windows fonts have variations in glyph size, design and kerning</span></div><div class="line"><a name="l01457"></a><span class="lineno"> 1457</span>&#160; <span class="comment">// for different point sizes. Text in Rhino is generally</span></div><div class="line"><a name="l01458"></a><span class="lineno"> 1458</span>&#160; <span class="comment">// placed around geometry and the relative spatial</span></div><div class="line"><a name="l01459"></a><span class="lineno"> 1459</span>&#160; <span class="comment">// relationships between the text and the geometry must </span></div><div class="line"><a name="l01460"></a><span class="lineno"> 1460</span>&#160; <span class="comment">// remain constant on all devices and at all &quot;zoom&quot; levels.</span></div><div class="line"><a name="l01461"></a><span class="lineno"> 1461</span>&#160; <span class="comment">// We have to choose a point size and then apply appropriate</span></div><div class="line"><a name="l01462"></a><span class="lineno"> 1462</span>&#160; <span class="comment">// scaling during display, printing, and in other rendering</span></div><div class="line"><a name="l01463"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#ab55ead78e0fc5501a58ba69cc1f5d023a0c726d7265af66178ddb104e396ae648"> 1463</a></span>&#160; <span class="comment">// calculations. After many experiments and 20 years of commercial use, </span></div><div class="line"><a name="l01464"></a><span class="lineno"> 1464</span>&#160; <span class="comment">// (1995-2015) we have found 256 works best.</span></div><div class="line"><a name="l01465"></a><span class="lineno"> 1465</span>&#160; <span class="comment">// This value is used on all platforms because the calculations</span></div><div class="line"><a name="l01466"></a><span class="lineno"> 1466</span>&#160; <span class="comment">// it is used in occur on all platforms. These calculations must return </span></div><div class="line"><a name="l01467"></a><span class="lineno"> 1467</span>&#160; <span class="comment">// consistent results so models exchanged between platforms maintain</span></div><div class="line"><a name="l01468"></a><span class="lineno"> 1468</span>&#160; <span class="comment">// spatial relationships between text and geometry.</span></div><div class="line"><a name="l01469"></a><span class="lineno"> 1469</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01470"></a><span class="lineno"> 1470</span>&#160; <span class="comment">// 2017:</span></div><div class="line"><a name="l01471"></a><span class="lineno"> 1471</span>&#160; <span class="comment">// (switching to freetype)</span></div><div class="line"><a name="l01472"></a><span class="lineno"> 1472</span>&#160; <span class="comment">// The value ON_Font::Constants::AnnotationFontCellHeight is used to define</span></div><div class="line"><a name="l01473"></a><span class="lineno"> 1473</span>&#160; <span class="comment">// &quot;opennurbs normalized font coordinates&quot;. The scale</span></div><div class="line"><a name="l01474"></a><span class="lineno"> 1474</span>&#160; <span class="comment">// ((double)ON_Font::Constants::AnnotationFontCellHeight)/(font definition grid height)</span></div><div class="line"><a name="l01475"></a><span class="lineno"> 1475</span>&#160; <span class="comment">// is used to convert bounding information and outlines from a native</span></div><div class="line"><a name="l01476"></a><span class="lineno"> 1476</span>&#160; <span class="comment">// font definition to opennurbs normalized font coordinates.</span></div><div class="line"><a name="l01477"></a><span class="lineno"> 1477</span>&#160; <span class="comment">// Many TrueType fonts have font definition grid height = 2048.</span></div><div class="line"><a name="l01478"></a><span class="lineno"> 1478</span>&#160; <span class="comment">// Many PostScript fonts have font definition grid height = 1000.</span></div><div class="line"><a name="l01479"></a><span class="lineno"> 1479</span>&#160; AnnotationFontCellHeight = 256, <span class="comment">// LOGFONT.lfHeight value</span></div><div class="line"><a name="l01480"></a><span class="lineno"> 1480</span>&#160;</div><div class="line"><a name="l01481"></a><span class="lineno"> 1481</span>&#160; <span class="comment">// ON_Font::Constants::metric_char is the unicode code point value</span></div><div class="line"><a name="l01482"></a><span class="lineno"> 1482</span>&#160; <span class="comment">// for the glpyh used to calculate critical glyph metrics.</span></div><div class="line"><a name="l01483"></a><span class="lineno"> 1483</span>&#160; <span class="comment">// It must be an &#39;I&#39; or &#39;H&#39;, but we have not tested &#39;H&#39;.</span></div><div class="line"><a name="l01484"></a><span class="lineno"> 1484</span>&#160; <span class="comment">// There are problems with any other upper case latin letter in common fonts.</span></div><div class="line"><a name="l01485"></a><span class="lineno"> 1485</span>&#160; <span class="comment">// In particular, the standard &#39;M&#39; does not work.</span></div><div class="line"><a name="l01486"></a><span class="lineno"> 1486</span>&#160; <span class="comment">// We have used &#39;I&#39; for 22 years (1995 - 2017).</span></div><div class="line"><a name="l01487"></a><span class="lineno"> 1487</span>&#160; <span class="comment">// This value is used on all platforms because the calculations</span></div><div class="line"><a name="l01488"></a><span class="lineno"> 1488</span>&#160; <span class="comment">// it is used in occur on all platforms. These calculations must return </span></div><div class="line"><a name="l01489"></a><span class="lineno"> 1489</span>&#160; <span class="comment">// consistent results so models exchanged between platforms maintain</span></div><div class="line"><a name="l01490"></a><span class="lineno"> 1490</span>&#160; <span class="comment">// spatial relationships between text and geometry.</span></div><div class="line"><a name="l01491"></a><span class="lineno"> 1491</span>&#160; MetricsGlyphCodePoint = <span class="charliteral">&#39;I&#39;</span></div><div class="line"><a name="l01492"></a><span class="lineno"> 1492</span>&#160; }; </div><div class="line"><a name="l01493"></a><span class="lineno"> 1493</span>&#160;</div><div class="line"><a name="l01494"></a><span class="lineno"> 1494</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01495"></a><span class="lineno"> 1495</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01496"></a><span class="lineno"> 1496</span>&#160;<span class="comment"> Get a text description of the font.</span></div><div class="line"><a name="l01497"></a><span class="lineno"> 1497</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01498"></a><span class="lineno"> 1498</span>&#160;<span class="comment"> font_description - [out]</span></div><div class="line"><a name="l01499"></a><span class="lineno"> 1499</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01500"></a><span class="lineno"> 1500</span>&#160;<span class="comment"> A pointer to the font description string stored in the font_description parameter.</span></div><div class="line"><a name="l01501"></a><span class="lineno"> 1501</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01502"></a><span class="lineno"> 1502</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d1/d11/class_o_n__w_string.html">ON_wString</a>&amp; FontDescription() <span class="keyword">const</span>;</div><div class="line"><a name="l01503"></a><span class="lineno"> 1503</span>&#160;</div><div class="line"><a name="l01504"></a><span class="lineno"> 1504</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01505"></a><span class="lineno"> 1505</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01506"></a><span class="lineno"> 1506</span>&#160;<span class="comment"> Get a text description of the font.</span></div><div class="line"><a name="l01507"></a><span class="lineno"> 1507</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01508"></a><span class="lineno"> 1508</span>&#160;<span class="comment"> font_description - [out]</span></div><div class="line"><a name="l01509"></a><span class="lineno"> 1509</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01510"></a><span class="lineno"> 1510</span>&#160;<span class="comment"> A pointer to the font description string stored in the font_description parameter.</span></div><div class="line"><a name="l01511"></a><span class="lineno"> 1511</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01512"></a><span class="lineno"> 1512</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* FontDescriptionAsPointer() <span class="keyword">const</span>;</div><div class="line"><a name="l01513"></a><span class="lineno"> 1513</span>&#160; </div><div class="line"><a name="l01514"></a><span class="lineno"> 1514</span>&#160; ON_DEPRECATED_MSG(<span class="stringliteral">&quot;Use ON_FontMetrics::DefaultLineFeedRatio&quot;</span>)</div><div class="line"><a name="l01515"></a><span class="lineno"> 1515</span>&#160; double LinefeedRatio() const;</div><div class="line"><a name="l01516"></a><span class="lineno"> 1516</span>&#160;</div><div class="line"><a name="l01517"></a><span class="lineno"> 1517</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01518"></a><span class="lineno"> 1518</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01519"></a><span class="lineno"> 1519</span>&#160;<span class="comment"> Normalized font metrics.</span></div><div class="line"><a name="l01520"></a><span class="lineno"> 1520</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01521"></a><span class="lineno"> 1521</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l01522"></a><span class="lineno"> 1522</span>&#160;<span class="comment"> Font metric &quot;normalized&quot; units are comparable between different fonts.</span></div><div class="line"><a name="l01523"></a><span class="lineno"> 1523</span>&#160;<span class="comment"> Normalized font metrics exist so that code that positions glyphs from </span></div><div class="line"><a name="l01524"></a><span class="lineno"> 1524</span>&#160;<span class="comment"> multiple fonts does not have to take the unit system and resolution used</span></div><div class="line"><a name="l01525"></a><span class="lineno"> 1525</span>&#160;<span class="comment"> in the design of each font.</span></div><div class="line"><a name="l01526"></a><span class="lineno"> 1526</span>&#160;<span class="comment"> In opennurbs, much of this code that positions glyphs is located in ON_Annotation,</span></div><div class="line"><a name="l01527"></a><span class="lineno"> 1527</span>&#160;<span class="comment"> ON_TextContent, and ON_TextRun member functions and is used when rendering </span></div><div class="line"><a name="l01528"></a><span class="lineno"> 1528</span>&#160;<span class="comment"> annotation objects.</span></div><div class="line"><a name="l01529"></a><span class="lineno"> 1529</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01530"></a><span class="lineno"> 1530</span>&#160;<span class="comment"> Fonts can be designed and defined at different resolutions and</span></div><div class="line"><a name="l01531"></a><span class="lineno"> 1531</span>&#160;<span class="comment"> relative scaling is necessary when text contains glyphs from </span></div><div class="line"><a name="l01532"></a><span class="lineno"> 1532</span>&#160;<span class="comment"> fonts desinged at different grid resolutions. For example, </span></div><div class="line"><a name="l01533"></a><span class="lineno"> 1533</span>&#160;<span class="comment"> TrueType font grid with and height is often 1024x1024 or </span></div><div class="line"><a name="l01534"></a><span class="lineno"> 1534</span>&#160;<span class="comment"> 2048x2014, OpenType grids are often 1000x1000, and PostScript </span></div><div class="line"><a name="l01535"></a><span class="lineno"> 1535</span>&#160;<span class="comment"> grids are often 1000x1000. Opennurbs &quot;font units&quot; are the units</span></div><div class="line"><a name="l01536"></a><span class="lineno"> 1536</span>&#160;<span class="comment"> the font was designed in.</span></div><div class="line"><a name="l01537"></a><span class="lineno"> 1537</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01538"></a><span class="lineno"> 1538</span>&#160;<span class="comment"> Long ago, opennurbs and Rhino used only Windows TrueType fonts</span></div><div class="line"><a name="l01539"></a><span class="lineno"> 1539</span>&#160;<span class="comment"> and ran only in Microsoft Windows. During this era,</span></div><div class="line"><a name="l01540"></a><span class="lineno"> 1540</span>&#160;<span class="comment"> the &quot;normalized units&quot; were for a Windows LOGFONT created</span></div><div class="line"><a name="l01541"></a><span class="lineno"> 1541</span>&#160;<span class="comment"> with lfHeight = ON_Font::Constants::AnnotationFontCellHeight.</span></div><div class="line"><a name="l01542"></a><span class="lineno"> 1542</span>&#160;<span class="comment"> </span></div><div class="line"><a name="l01543"></a><span class="lineno"> 1543</span>&#160;<span class="comment"> Currently opennurbs and Rhino work on Microsoft Windows and Apple</span></div><div class="line"><a name="l01544"></a><span class="lineno"> 1544</span>&#160;<span class="comment"> platforms and use FreeType to access font information. When a font </span></div><div class="line"><a name="l01545"></a><span class="lineno"> 1545</span>&#160;<span class="comment"> is not &quot;tricky&quot;, the &quot;font design&quot; units are the the units FreeType</span></div><div class="line"><a name="l01546"></a><span class="lineno"> 1546</span>&#160;<span class="comment"> uses when a font is loaded with FT_LOAD_NO_SCALE.</span></div><div class="line"><a name="l01547"></a><span class="lineno"> 1547</span>&#160;<span class="comment"> </span></div><div class="line"><a name="l01548"></a><span class="lineno"> 1548</span>&#160;<span class="comment"> When working with fonts and glyhphs in opennurbs and Rhino, </span></div><div class="line"><a name="l01549"></a><span class="lineno"> 1549</span>&#160;<span class="comment"> SDK users almost always want to use normalized font and glyph metrics.</span></div><div class="line"><a name="l01550"></a><span class="lineno"> 1550</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01551"></a><span class="lineno"> 1551</span>&#160; const <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>&amp; FontMetrics() const;</div><div class="line"><a name="l01552"></a><span class="lineno"> 1552</span>&#160;</div><div class="line"><a name="l01553"></a><span class="lineno"> 1553</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01554"></a><span class="lineno"> 1554</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01555"></a><span class="lineno"> 1555</span>&#160;<span class="comment"> This function is for expert users doing something complicated.</span></div><div class="line"><a name="l01556"></a><span class="lineno"> 1556</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01557"></a><span class="lineno"> 1557</span>&#160;<span class="comment"> Font metrics read directly from the font definition with no or minimal</span></div><div class="line"><a name="l01558"></a><span class="lineno"> 1558</span>&#160;<span class="comment"> scaling.</span></div><div class="line"><a name="l01559"></a><span class="lineno"> 1559</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l01560"></a><span class="lineno"> 1560</span>&#160;<span class="comment"> See ON_Font.FontMetrics() documentation for important information</span></div><div class="line"><a name="l01561"></a><span class="lineno"> 1561</span>&#160;<span class="comment"> about the differnce bewteen normalized and font unit metrics.</span></div><div class="line"><a name="l01562"></a><span class="lineno"> 1562</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01563"></a><span class="lineno"> 1563</span>&#160; const <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>&amp; FontUnitFontMetrics() const;</div><div class="line"><a name="l01564"></a><span class="lineno"> 1564</span>&#160;</div><div class="line"><a name="l01565"></a><span class="lineno"> 1565</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01566"></a><span class="lineno"> 1566</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01567"></a><span class="lineno"> 1567</span>&#160;<span class="comment"> scale to apply when converting from a FT_LOAD_NO_SCALE FreeType</span></div><div class="line"><a name="l01568"></a><span class="lineno"> 1568</span>&#160;<span class="comment"> glyph metric or outline to normalized opennurbs font coordinates. </span></div><div class="line"><a name="l01569"></a><span class="lineno"> 1569</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01570"></a><span class="lineno"> 1570</span>&#160; <span class="keywordtype">double</span> FontUnitToNormalizedScale() const;</div><div class="line"><a name="l01571"></a><span class="lineno"> 1571</span>&#160; </div><div class="line"><a name="l01572"></a><span class="lineno"> 1572</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01573"></a><span class="lineno"> 1573</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01574"></a><span class="lineno"> 1574</span>&#160;<span class="comment"> scale to apply when converting from a FT_LOAD_NO_SCALE FreeType</span></div><div class="line"><a name="l01575"></a><span class="lineno"> 1575</span>&#160;<span class="comment"> glyph metric or outline to normalized opennurbs font coordinates.</span></div><div class="line"><a name="l01576"></a><span class="lineno"> 1576</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01577"></a><span class="lineno"> 1577</span>&#160; <span class="keywordtype">double</span> NormalizedToFontUnitScale() const;</div><div class="line"><a name="l01578"></a><span class="lineno"> 1578</span>&#160;</div><div class="line"><a name="l01579"></a><span class="lineno"> 1579</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01580"></a><span class="lineno"> 1580</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01581"></a><span class="lineno"> 1581</span>&#160;<span class="comment"> Font character height in points (1 point = 1/72 inch).</span></div><div class="line"><a name="l01582"></a><span class="lineno"> 1582</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01583"></a><span class="lineno"> 1583</span>&#160;<span class="comment"> See the remarks for a defintion of &quot;character height&quot;.</span></div><div class="line"><a name="l01584"></a><span class="lineno"> 1584</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01585"></a><span class="lineno"> 1585</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l01586"></a><span class="lineno"> 1586</span>&#160;<span class="comment"> A &quot;point&quot; is a length unit system.</span></div><div class="line"><a name="l01587"></a><span class="lineno"> 1587</span>&#160;<span class="comment"> 1 point = 1/72 inch = 25.4/72 millimeters. </span></div><div class="line"><a name="l01588"></a><span class="lineno"> 1588</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01589"></a><span class="lineno"> 1589</span>&#160;<span class="comment"> Typically, fonts are designed for maximum clarity when the rendered </span></div><div class="line"><a name="l01590"></a><span class="lineno"> 1590</span>&#160;<span class="comment"> character height is close to PointSize().</span></div><div class="line"><a name="l01591"></a><span class="lineno"> 1591</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01592"></a><span class="lineno"> 1592</span>&#160;<span class="comment"> font cell height = font ascent + font descent.</span></div><div class="line"><a name="l01593"></a><span class="lineno"> 1593</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01594"></a><span class="lineno"> 1594</span>&#160;<span class="comment"> font character height = font cell height - font internal leading.</span></div><div class="line"><a name="l01595"></a><span class="lineno"> 1595</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01596"></a><span class="lineno"> 1596</span>&#160;<span class="comment"> For fonts designed for languages that use latin letters, it is common for </span></div><div class="line"><a name="l01597"></a><span class="lineno"> 1597</span>&#160;<span class="comment"> the character height to be equal to or a little larger than the distance </span></div><div class="line"><a name="l01598"></a><span class="lineno"> 1598</span>&#160;<span class="comment"> from the bottom of a lower case g to the top of an upper case M. </span></div><div class="line"><a name="l01599"></a><span class="lineno"> 1599</span>&#160;<span class="comment"> The character height is also called the &quot;em hieght&quot;.</span></div><div class="line"><a name="l01600"></a><span class="lineno"> 1600</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01601"></a><span class="lineno"> 1601</span>&#160;<span class="comment"> Font internal leading is the space above typical capital latin letters</span></div><div class="line"><a name="l01602"></a><span class="lineno"> 1602</span>&#160;<span class="comment"> that is reseved for diacritical marks like the ring above the A in </span></div><div class="line"><a name="l01603"></a><span class="lineno"> 1603</span>&#160;<span class="comment"> the UNICODE &quot;LATIN LETTER A WITH RING&quot; U+00C5 glyph (Angstrom symbol).</span></div><div class="line"><a name="l01604"></a><span class="lineno"> 1604</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01605"></a><span class="lineno"> 1605</span>&#160; <span class="keywordtype">double</span> PointSize() const;</div><div class="line"><a name="l01606"></a><span class="lineno"> 1606</span>&#160;</div><div class="line"><a name="l01607"></a><span class="lineno"> 1607</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01608"></a><span class="lineno"> 1608</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l01609"></a><span class="lineno"> 1609</span>&#160;<span class="comment"> point_size - [in]</span></div><div class="line"><a name="l01610"></a><span class="lineno"> 1610</span>&#160;<span class="comment"> font character height in point units.</span></div><div class="line"><a name="l01611"></a><span class="lineno"> 1611</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01612"></a><span class="lineno"> 1612</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l01613"></a><span class="lineno"> 1613</span>&#160;<span class="comment"> See the remarks section ON_Font::PointSize() for more information</span></div><div class="line"><a name="l01614"></a><span class="lineno"> 1614</span>&#160;<span class="comment"> about point units and character height.</span></div><div class="line"><a name="l01615"></a><span class="lineno"> 1615</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01616"></a><span class="lineno"> 1616</span>&#160; <span class="keywordtype">bool</span> SetPointSize(</div><div class="line"><a name="l01617"></a><span class="lineno"> 1617</span>&#160; <span class="keywordtype">double</span> point_size</div><div class="line"><a name="l01618"></a><span class="lineno"> 1618</span>&#160; );</div><div class="line"><a name="l01619"></a><span class="lineno"> 1619</span>&#160;</div><div class="line"><a name="l01620"></a><span class="lineno"> 1620</span>&#160; <span class="keywordtype">bool</span> SetFontFaceName( </div><div class="line"><a name="l01621"></a><span class="lineno"> 1621</span>&#160; const <span class="keywordtype">wchar_t</span>* face_name</div><div class="line"><a name="l01622"></a><span class="lineno"> 1622</span>&#160; );</div><div class="line"><a name="l01623"></a><span class="lineno"> 1623</span>&#160; const <span class="keywordtype">wchar_t</span>* FontFaceName() const;</div><div class="line"><a name="l01624"></a><span class="lineno"> 1624</span>&#160;</div><div class="line"><a name="l01625"></a><span class="lineno"> 1625</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">Weight</a> FontWeight() const;</div><div class="line"><a name="l01626"></a><span class="lineno"> 1626</span>&#160;</div><div class="line"><a name="l01627"></a><span class="lineno"> 1627</span>&#160; <span class="keywordtype">int</span> WindowsLogfontWeight() const;</div><div class="line"><a name="l01628"></a><span class="lineno"> 1628</span>&#160; <span class="keywordtype">int</span> AppleWeightOfFont() const;</div><div class="line"><a name="l01629"></a><span class="lineno"> 1629</span>&#160; <span class="keywordtype">double</span> AppleFontWeightTrait() const;</div><div class="line"><a name="l01630"></a><span class="lineno"> 1630</span>&#160;</div><div class="line"><a name="l01631"></a><span class="lineno"> 1631</span>&#160; <span class="keywordtype">bool</span> SetFontWeight(</div><div class="line"><a name="l01632"></a><span class="lineno"> 1632</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">Weight</a> font_weight</div><div class="line"><a name="l01633"></a><span class="lineno"> 1633</span>&#160; );</div><div class="line"><a name="l01634"></a><span class="lineno"> 1634</span>&#160;</div><div class="line"><a name="l01635"></a><span class="lineno"> 1635</span>&#160; <span class="keywordtype">bool</span> SetWindowsLogfontWeight(</div><div class="line"><a name="l01636"></a><span class="lineno"> 1636</span>&#160; <span class="keywordtype">int</span> windows_logfont_weight</div><div class="line"><a name="l01637"></a><span class="lineno"> 1637</span>&#160; );</div><div class="line"><a name="l01638"></a><span class="lineno"> 1638</span>&#160;</div><div class="line"><a name="l01639"></a><span class="lineno"> 1639</span>&#160; <span class="keywordtype">bool</span> SetAppleWeightOfFont(</div><div class="line"><a name="l01640"></a><span class="lineno"> 1640</span>&#160; <span class="keywordtype">int</span> apple_weight_of_font</div><div class="line"><a name="l01641"></a><span class="lineno"> 1641</span>&#160; );</div><div class="line"><a name="l01642"></a><span class="lineno"> 1642</span>&#160;</div><div class="line"><a name="l01643"></a><span class="lineno"> 1643</span>&#160; <span class="keywordtype">bool</span> SetAppleFontWeightTrait(</div><div class="line"><a name="l01644"></a><span class="lineno"> 1644</span>&#160; <span class="keywordtype">double</span> apple_font_weight_trait</div><div class="line"><a name="l01645"></a><span class="lineno"> 1645</span>&#160; );</div><div class="line"><a name="l01646"></a><span class="lineno"> 1646</span>&#160;</div><div class="line"><a name="l01647"></a><span class="lineno"> 1647</span>&#160;private:</div><div class="line"><a name="l01648"></a><span class="lineno"> 1648</span>&#160; <span class="keywordtype">bool</span> Internal_SetFontWeightTrio(</div><div class="line"><a name="l01649"></a><span class="lineno"> 1649</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">Weight</a> font_weight,</div><div class="line"><a name="l01650"></a><span class="lineno"> 1650</span>&#160; <span class="keywordtype">int</span> windows_logfont_weight,</div><div class="line"><a name="l01651"></a><span class="lineno"> 1651</span>&#160; <span class="keywordtype">double</span> apple_font_weight_trait,</div><div class="line"><a name="l01652"></a><span class="lineno"> 1652</span>&#160; <span class="keywordtype">bool</span> bUpdateFontDescription</div><div class="line"><a name="l01653"></a><span class="lineno"> 1653</span>&#160; );</div><div class="line"><a name="l01654"></a><span class="lineno"> 1654</span>&#160;</div><div class="line"><a name="l01655"></a><span class="lineno"> 1655</span>&#160;public:</div><div class="line"><a name="l01656"></a><span class="lineno"> 1656</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01657"></a><span class="lineno"> 1657</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01658"></a><span class="lineno"> 1658</span>&#160;<span class="comment"> User interfaces that want to behave as if there are 3 font weights,</span></div><div class="line"><a name="l01659"></a><span class="lineno"> 1659</span>&#160;<span class="comment"> light &lt; normal &lt; &lt; bold, can use the functions</span></div><div class="line"><a name="l01660"></a><span class="lineno"> 1660</span>&#160;<span class="comment"> ON_Font.IsLight(),</span></div><div class="line"><a name="l01661"></a><span class="lineno"> 1661</span>&#160;<span class="comment"> ON_Font.IsNormalWeight(),</span></div><div class="line"><a name="l01662"></a><span class="lineno"> 1662</span>&#160;<span class="comment"> ON_Font.IsBold(),</span></div><div class="line"><a name="l01663"></a><span class="lineno"> 1663</span>&#160;<span class="comment"> to query font weight ranges.</span></div><div class="line"><a name="l01664"></a><span class="lineno"> 1664</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01665"></a><span class="lineno"> 1665</span>&#160;<span class="comment"> True if FontWeight() is lighter than ON_Font::Weight::Normal</span></div><div class="line"><a name="l01666"></a><span class="lineno"> 1666</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01667"></a><span class="lineno"> 1667</span>&#160; <span class="keywordtype">bool</span> IsLight() const;</div><div class="line"><a name="l01668"></a><span class="lineno"> 1668</span>&#160;</div><div class="line"><a name="l01669"></a><span class="lineno"> 1669</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01670"></a><span class="lineno"> 1670</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01671"></a><span class="lineno"> 1671</span>&#160;<span class="comment"> User interfaces that want to behave as if there are 3 font weights,</span></div><div class="line"><a name="l01672"></a><span class="lineno"> 1672</span>&#160;<span class="comment"> light &lt; normal &lt; &lt; bold, can use the functions</span></div><div class="line"><a name="l01673"></a><span class="lineno"> 1673</span>&#160;<span class="comment"> ON_Font.IsLight(),</span></div><div class="line"><a name="l01674"></a><span class="lineno"> 1674</span>&#160;<span class="comment"> ON_Font.IsNormalWeight(),</span></div><div class="line"><a name="l01675"></a><span class="lineno"> 1675</span>&#160;<span class="comment"> ON_Font.IsBold(),</span></div><div class="line"><a name="l01676"></a><span class="lineno"> 1676</span>&#160;<span class="comment"> to query font weight ranges.</span></div><div class="line"><a name="l01677"></a><span class="lineno"> 1677</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01678"></a><span class="lineno"> 1678</span>&#160;<span class="comment"> True if FontWeight() is ON_Font::Normal or ON_Font::Weight::Medium</span></div><div class="line"><a name="l01679"></a><span class="lineno"> 1679</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01680"></a><span class="lineno"> 1680</span>&#160; <span class="keywordtype">bool</span> IsNormalWeight() const;</div><div class="line"><a name="l01681"></a><span class="lineno"> 1681</span>&#160;</div><div class="line"><a name="l01682"></a><span class="lineno"> 1682</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01683"></a><span class="lineno"> 1683</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01684"></a><span class="lineno"> 1684</span>&#160;<span class="comment"> User interfaces that want to behave as if there are 3 font weights,</span></div><div class="line"><a name="l01685"></a><span class="lineno"> 1685</span>&#160;<span class="comment"> light &lt; normal &lt; &lt; bold, can use the functions</span></div><div class="line"><a name="l01686"></a><span class="lineno"> 1686</span>&#160;<span class="comment"> ON_Font.IsLight(),</span></div><div class="line"><a name="l01687"></a><span class="lineno"> 1687</span>&#160;<span class="comment"> ON_Font.IsNormalWeight(),</span></div><div class="line"><a name="l01688"></a><span class="lineno"> 1688</span>&#160;<span class="comment"> ON_Font.IsBold(),</span></div><div class="line"><a name="l01689"></a><span class="lineno"> 1689</span>&#160;<span class="comment"> to query font weight ranges.</span></div><div class="line"><a name="l01690"></a><span class="lineno"> 1690</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01691"></a><span class="lineno"> 1691</span>&#160;<span class="comment"> True if heavier than ON_Font::Weight::Medium.</span></div><div class="line"><a name="l01692"></a><span class="lineno"> 1692</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01693"></a><span class="lineno"> 1693</span>&#160; <span class="keywordtype">bool</span> IsBold() const;</div><div class="line"><a name="l01694"></a><span class="lineno"> 1694</span>&#160; </div><div class="line"><a name="l01695"></a><span class="lineno"> 1695</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">Style</a> FontStyle() const;</div><div class="line"><a name="l01696"></a><span class="lineno"> 1696</span>&#160;</div><div class="line"><a name="l01697"></a><span class="lineno"> 1697</span>&#160; <span class="keywordtype">bool</span> SetFontStyle(</div><div class="line"><a name="l01698"></a><span class="lineno"> 1698</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">Style</a> font_style</div><div class="line"><a name="l01699"></a><span class="lineno"> 1699</span>&#160; );</div><div class="line"><a name="l01700"></a><span class="lineno"> 1700</span>&#160;</div><div class="line"><a name="l01701"></a><span class="lineno"> 1701</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01702"></a><span class="lineno"> 1702</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01703"></a><span class="lineno"> 1703</span>&#160;<span class="comment"> true if FontStyle() is ON_Font::Style::Italic.</span></div><div class="line"><a name="l01704"></a><span class="lineno"> 1704</span>&#160;<span class="comment"> false if FontStyle() is ON_Font::Style::Upright or .ON_Font::Style::Oblique.</span></div><div class="line"><a name="l01705"></a><span class="lineno"> 1705</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01706"></a><span class="lineno"> 1706</span>&#160; <span class="keywordtype">bool</span> IsItalic() const;</div><div class="line"><a name="l01707"></a><span class="lineno"> 1707</span>&#160;</div><div class="line"><a name="l01708"></a><span class="lineno"> 1708</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01709"></a><span class="lineno"> 1709</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01710"></a><span class="lineno"> 1710</span>&#160;<span class="comment"> true if FontStyle() is ON_Font::Style::Upright.</span></div><div class="line"><a name="l01711"></a><span class="lineno"> 1711</span>&#160;<span class="comment"> false if FontStyle() is ON_Font::Style::Italic or .ON_Font::Style::Oblique.</span></div><div class="line"><a name="l01712"></a><span class="lineno"> 1712</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01713"></a><span class="lineno"> 1713</span>&#160; <span class="keywordtype">bool</span> IsUpright() const;</div><div class="line"><a name="l01714"></a><span class="lineno"> 1714</span>&#160;</div><div class="line"><a name="l01715"></a><span class="lineno"> 1715</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01716"></a><span class="lineno"> 1716</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01717"></a><span class="lineno"> 1717</span>&#160;<span class="comment"> true if FontStyle() is ON_Font::Style::Oblique.</span></div><div class="line"><a name="l01718"></a><span class="lineno"> 1718</span>&#160;<span class="comment"> false if FontStyle() is ON_Font::Style::Upright or .ON_Font::Style::Italic.</span></div><div class="line"><a name="l01719"></a><span class="lineno"> 1719</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01720"></a><span class="lineno"> 1720</span>&#160; <span class="keywordtype">bool</span> IsOblique();</div><div class="line"><a name="l01721"></a><span class="lineno"> 1721</span>&#160;</div><div class="line"><a name="l01722"></a><span class="lineno"> 1722</span>&#160; </div><div class="line"><a name="l01723"></a><span class="lineno"> 1723</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">Stretch</a> FontStretch() const;</div><div class="line"><a name="l01724"></a><span class="lineno"> 1724</span>&#160;</div><div class="line"><a name="l01725"></a><span class="lineno"> 1725</span>&#160; <span class="keywordtype">bool</span> SetFontStretch(</div><div class="line"><a name="l01726"></a><span class="lineno"> 1726</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">Stretch</a> font_stretch</div><div class="line"><a name="l01727"></a><span class="lineno"> 1727</span>&#160; );</div><div class="line"><a name="l01728"></a><span class="lineno"> 1728</span>&#160;</div><div class="line"><a name="l01729"></a><span class="lineno"> 1729</span>&#160; <span class="keywordtype">bool</span> IsUnderlined() const;</div><div class="line"><a name="l01730"></a><span class="lineno"> 1730</span>&#160; <span class="keywordtype">bool</span> SetUnderlined(</div><div class="line"><a name="l01731"></a><span class="lineno"> 1731</span>&#160; <span class="keywordtype">bool</span> bUnderlined </div><div class="line"><a name="l01732"></a><span class="lineno"> 1732</span>&#160; );</div><div class="line"><a name="l01733"></a><span class="lineno"> 1733</span>&#160;</div><div class="line"><a name="l01734"></a><span class="lineno"> 1734</span>&#160; <span class="keywordtype">bool</span> IsStrikethrough() const;</div><div class="line"><a name="l01735"></a><span class="lineno"> 1735</span>&#160; <span class="keywordtype">bool</span> SetStrikethrough( </div><div class="line"><a name="l01736"></a><span class="lineno"> 1736</span>&#160; <span class="keywordtype">bool</span> bStrikethrough</div><div class="line"><a name="l01737"></a><span class="lineno"> 1737</span>&#160; );</div><div class="line"><a name="l01738"></a><span class="lineno"> 1738</span>&#160;</div><div class="line"><a name="l01739"></a><span class="lineno"> 1739</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> LogfontCharSet() const;</div><div class="line"><a name="l01740"></a><span class="lineno"> 1740</span>&#160; </div><div class="line"><a name="l01741"></a><span class="lineno"> 1741</span>&#160; <span class="keywordtype">bool</span> SetLogfontCharSet(</div><div class="line"><a name="l01742"></a><span class="lineno"> 1742</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> logfont_charset</div><div class="line"><a name="l01743"></a><span class="lineno"> 1743</span>&#160; );</div><div class="line"><a name="l01744"></a><span class="lineno"> 1744</span>&#160;</div><div class="line"><a name="l01745"></a><span class="lineno"> 1745</span>&#160; ON_DEPRECATED_MSG(&quot;Use FontMetrics().AscentOfI()&quot;)</div><div class="line"><a name="l01746"></a><span class="lineno"> 1746</span>&#160; <span class="keywordtype">int</span> HeightOfI() const;</div><div class="line"><a name="l01747"></a><span class="lineno"> 1747</span>&#160;</div><div class="line"><a name="l01748"></a><span class="lineno"> 1748</span>&#160; ON_DEPRECATED_MSG(&quot;Use FontMetrics().LineSpace()&quot;)</div><div class="line"><a name="l01749"></a><span class="lineno"> 1749</span>&#160; <span class="keywordtype">int</span> HeightOfLinefeed() const;</div><div class="line"><a name="l01750"></a><span class="lineno"> 1750</span>&#160; </div><div class="line"><a name="l01751"></a><span class="lineno"> 1751</span>&#160; ON_DEPRECATED_MSG(&quot;Use FontMetrics().GlyphScale()&quot;)</div><div class="line"><a name="l01752"></a><span class="lineno"> 1752</span>&#160; <span class="keywordtype">double</span> HeightScale(<span class="keywordtype">double</span> text_height) const;</div><div class="line"><a name="l01753"></a><span class="lineno"> 1753</span>&#160; </div><div class="line"><a name="l01754"></a><span class="lineno"> 1754</span>&#160; ON_DEPRECATED_MSG(&quot;Use FontMetrics().StrikeoutThickness()&quot;)</div><div class="line"><a name="l01755"></a><span class="lineno"> 1755</span>&#160; <span class="keywordtype">int</span> GetStrikeoutSize() const;</div><div class="line"><a name="l01756"></a><span class="lineno"> 1756</span>&#160;</div><div class="line"><a name="l01757"></a><span class="lineno"> 1757</span>&#160; ON_DEPRECATED_MSG(&quot;Use FontMetrics().StrikeoutPosition()&quot;)</div><div class="line"><a name="l01758"></a><span class="lineno"> 1758</span>&#160; <span class="keywordtype">int</span> GetStrikeoutPosition() const;</div><div class="line"><a name="l01759"></a><span class="lineno"> 1759</span>&#160;</div><div class="line"><a name="l01760"></a><span class="lineno"> 1760</span>&#160; ON_DEPRECATED_MSG(&quot;Use FontMetrics().UnderscoreThickness()&quot;)</div><div class="line"><a name="l01761"></a><span class="lineno"> 1761</span>&#160; <span class="keywordtype">int</span> GetUnderscoreSize() const;</div><div class="line"><a name="l01762"></a><span class="lineno"> 1762</span>&#160;</div><div class="line"><a name="l01763"></a><span class="lineno"> 1763</span>&#160;</div><div class="line"><a name="l01764"></a><span class="lineno"> 1764</span>&#160; ON_DEPRECATED_MSG(&quot;Use FontMetrics().UnderscorePosition()&quot;)</div><div class="line"><a name="l01765"></a><span class="lineno"> 1765</span>&#160; <span class="keywordtype">int</span> GetUnderscorePosition() const;</div><div class="line"><a name="l01766"></a><span class="lineno"> 1766</span>&#160;</div><div class="line"><a name="l01767"></a><span class="lineno"> 1767</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01768"></a><span class="lineno"> 1768</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01769"></a><span class="lineno"> 1769</span>&#160;<span class="comment"> A SHA-1 hash of all font characteristics, including platform specific settings. </span></div><div class="line"><a name="l01770"></a><span class="lineno"> 1770</span>&#160;<span class="comment"> Two fonts have identical font characteristics, if and only if they have identical </span></div><div class="line"><a name="l01771"></a><span class="lineno"> 1771</span>&#160;<span class="comment"> FontCharacteristicsHash() values.</span></div><div class="line"><a name="l01772"></a><span class="lineno"> 1772</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01773"></a><span class="lineno"> 1773</span>&#160;<span class="comment"> Example:</span></div><div class="line"><a name="l01774"></a><span class="lineno"> 1774</span>&#160;<span class="comment"> ON_Font f1 = ...</span></div><div class="line"><a name="l01775"></a><span class="lineno"> 1775</span>&#160;<span class="comment"> ON_Font f2 = ...</span></div><div class="line"><a name="l01776"></a><span class="lineno"> 1776</span>&#160;<span class="comment"> if ( f1.FontCharacteristicsHash() == f2.FontCharacteristicsHash() )</span></div><div class="line"><a name="l01777"></a><span class="lineno"> 1777</span>&#160;<span class="comment"> {</span></div><div class="line"><a name="l01778"></a><span class="lineno"> 1778</span>&#160;<span class="comment"> // f1 and f2 have identical font characteristics</span></div><div class="line"><a name="l01779"></a><span class="lineno"> 1779</span>&#160;<span class="comment"> }</span></div><div class="line"><a name="l01780"></a><span class="lineno"> 1780</span>&#160;<span class="comment"> else</span></div><div class="line"><a name="l01781"></a><span class="lineno"> 1781</span>&#160;<span class="comment"> {</span></div><div class="line"><a name="l01782"></a><span class="lineno"> 1782</span>&#160;<span class="comment"> // f1 and f2 have different font characteristics</span></div><div class="line"><a name="l01783"></a><span class="lineno"> 1783</span>&#160;<span class="comment"> }</span></div><div class="line"><a name="l01784"></a><span class="lineno"> 1784</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01785"></a><span class="lineno"> 1785</span>&#160; const class <a class="code" href="../../dd/ddf/class_o_n___s_h_a1___hash.html">ON_SHA1_Hash</a>&amp; FontCharacteristicsHash() const;</div><div class="line"><a name="l01786"></a><span class="lineno"> 1786</span>&#160;</div><div class="line"><a name="l01787"></a><span class="lineno"> 1787</span>&#160;private:</div><div class="line"><a name="l01788"></a><span class="lineno"> 1788</span>&#160;</div><div class="line"><a name="l01789"></a><span class="lineno"> 1789</span>&#160;public:</div><div class="line"><a name="l01790"></a><span class="lineno"> 1790</span>&#160;</div><div class="line"><a name="l01791"></a><span class="lineno"> 1791</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01792"></a><span class="lineno"> 1792</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01793"></a><span class="lineno"> 1793</span>&#160;<span class="comment"> Compares the font weight, style, stretch, underline, strikethrough, linefeed_ratio</span></div><div class="line"><a name="l01794"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a9ab52facef254b3f5ae1247eac395ae1"> 1794</a></span>&#160;<span class="comment"> and facename characteristics. </span></div><div class="line"><a name="l01795"></a><span class="lineno"> 1795</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01796"></a><span class="lineno"> 1796</span>&#160;<span class="comment"> -1: a characteristics &lt; b characteristics</span></div><div class="line"><a name="l01797"></a><span class="lineno"> 1797</span>&#160;<span class="comment"> 0: a characteristics = b characteristics</span></div><div class="line"><a name="l01798"></a><span class="lineno"> 1798</span>&#160;<span class="comment"> +1: a characteristics &gt; b characteristics</span></div><div class="line"><a name="l01799"></a><span class="lineno"> 1799</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l01800"></a><span class="lineno"> 1800</span>&#160;<span class="comment"> This is a legacy function and to preserve past behavior, some platform specific </span></div><div class="line"><a name="l01801"></a><span class="lineno"> 1801</span>&#160;<span class="comment"> characteristics are not checked. </span></div><div class="line"><a name="l01802"></a><span class="lineno"> 1802</span>&#160;<span class="comment"> Use FontCharacteristicsHash() when every characteristic needs to be compared.</span></div><div class="line"><a name="l01803"></a><span class="lineno"> 1803</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01804"></a><span class="lineno"> 1804</span>&#160; static <span class="keywordtype">int</span> CompareFontCharacteristics(</div><div class="line"><a name="l01805"></a><span class="lineno"> 1805</span>&#160; const <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; a,</div><div class="line"><a name="l01806"></a><span class="lineno"> 1806</span>&#160; const <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; b</div><div class="line"><a name="l01807"></a><span class="lineno"> 1807</span>&#160; );</div><div class="line"><a name="l01808"></a><span class="lineno"> 1808</span>&#160;</div><div class="line"><a name="l01809"></a><span class="lineno"> 1809</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01810"></a><span class="lineno"> 1810</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l01811"></a><span class="lineno"> 1811</span>&#160;<span class="comment"> Compares the font weight, style, stretch, underline, strikethrough, linefeed_ratio</span></div><div class="line"><a name="l01812"></a><span class="lineno"> 1812</span>&#160;<span class="comment"> and facename characteristics.</span></div><div class="line"><a name="l01813"></a><span class="lineno"> 1813</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l01814"></a><span class="lineno"> 1814</span>&#160;<span class="comment"> 0 == ON_Font::CompareFontCharacteristics(a,b).</span></div><div class="line"><a name="l01815"></a><span class="lineno"> 1815</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l01816"></a><span class="lineno"> 1816</span>&#160;<span class="comment"> This is a legacy function and to preserve past behavior, some platform specific </span></div><div class="line"><a name="l01817"></a><span class="lineno"> 1817</span>&#160;<span class="comment"> characteristics are not checked. </span></div><div class="line"><a name="l01818"></a><span class="lineno"> 1818</span>&#160;<span class="comment"> Use FontCharacteristicsHash() when every characteristic needs to be compared.</span></div><div class="line"><a name="l01819"></a><span class="lineno"> 1819</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01820"></a><span class="lineno"> 1820</span>&#160; static <span class="keywordtype">bool</span> EqualFontCharacteristics(</div><div class="line"><a name="l01821"></a><span class="lineno"> 1821</span>&#160; const <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; a,</div><div class="line"><a name="l01822"></a><span class="lineno"> 1822</span>&#160; const <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; b</div><div class="line"><a name="l01823"></a><span class="lineno"> 1823</span>&#160; );</div><div class="line"><a name="l01824"></a><span class="lineno"> 1824</span>&#160;</div><div class="line"><a name="l01825"></a><span class="lineno"> 1825</span>&#160;private:</div><div class="line"><a name="l01826"></a><span class="lineno"> 1826</span>&#160; friend class <a class="code" href="../../d9/dd8/class_o_n___managed_fonts.html">ON_ManagedFonts</a>;</div><div class="line"><a name="l01827"></a><span class="lineno"> 1827</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01828"></a><span class="lineno"> 1828</span>&#160;<span class="comment"> //////////////////////////////////////////////////////////////////////////////////</span></div><div class="line"><a name="l01829"></a><span class="lineno"> 1829</span>&#160;<span class="comment"></span> <span class="comment">//</span></div><div class="line"><a name="l01830"></a><span class="lineno"> 1830</span>&#160; <span class="comment">// The &quot;font glpyh definition&quot; parameters completely determine the appearance</span></div><div class="line"><a name="l01831"></a><span class="lineno"> 1831</span>&#160; <span class="comment">// of font glyphs.</span></div><div class="line"><a name="l01832"></a><span class="lineno"> 1832</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01833"></a><span class="lineno"> 1833</span>&#160; <span class="comment">// If all &quot;font glpyh definition&quot; parameters have identical values, </span></div><div class="line"><a name="l01834"></a><span class="lineno"> 1834</span>&#160; <span class="comment">// text rendered using those fonts will look identical.</span></div><div class="line"><a name="l01835"></a><span class="lineno"> 1835</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01836"></a><span class="lineno"> 1836</span>&#160; <span class="comment">// If two fonts have a &quot;font glpyh definition&quot; parameter with different values,</span></div><div class="line"><a name="l01837"></a><span class="lineno"> 1837</span>&#160; <span class="comment">// text rendered using those fonts will not look identical.</span></div><div class="line"><a name="l01838"></a><span class="lineno"> 1838</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01839"></a><span class="lineno"> 1839</span>&#160; <span class="comment">// BEGIN &quot;font glpyh definition&quot; parameters:</span></div><div class="line"><a name="l01840"></a><span class="lineno"> 1840</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01841"></a><span class="lineno"> 1841</span>&#160;</div><div class="line"><a name="l01842"></a><span class="lineno"> 1842</span>&#160; <span class="comment">// The font ON_Font::Default has m_runtime_serial_number = 1.</span></div><div class="line"><a name="l01843"></a><span class="lineno"> 1843</span>&#160; <span class="comment">// Managed fonts have m_runtime_serial_number &gt;= 1.</span></div><div class="line"><a name="l01844"></a><span class="lineno"> 1844</span>&#160; <span class="comment">// Unmanaged fonts have m_runtime_serial_number = 0;</span></div><div class="line"><a name="l01845"></a><span class="lineno"> 1845</span>&#160; static <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> __runtime_serial_number_generator;</div><div class="line"><a name="l01846"></a><span class="lineno"> 1846</span>&#160; const <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> m_runtime_serial_number = 0;</div><div class="line"><a name="l01847"></a><span class="lineno"> 1847</span>&#160; </div><div class="line"><a name="l01848"></a><span class="lineno"> 1848</span>&#160; <span class="keywordtype">int</span> m_windows_logfont_weight = 400; <span class="comment">// 100 &lt;= m_windows_logfont_weight &lt;= 1000</span></div><div class="line"><a name="l01849"></a><span class="lineno"> 1849</span>&#160; <span class="keywordtype">double</span> m_point_size = 0.0;</div><div class="line"><a name="l01850"></a><span class="lineno"> 1850</span>&#160; <span class="keywordtype">double</span> m_apple_font_weight_trait = 0.0; <span class="comment">// = Apple NSFontWeightTrait value -1.0 &lt;= m_apple_font_weight &lt; 1.0, 0.0 = &quot;normal&quot;</span></div><div class="line"><a name="l01851"></a><span class="lineno"> 1851</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">Weight</a> m_font_weight = <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">Weight</a>::Normal;</div><div class="line"><a name="l01852"></a><span class="lineno"> 1852</span>&#160;</div><div class="line"><a name="l01853"></a><span class="lineno"> 1853</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">Style</a> m_font_style = <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">Style</a>::Upright; <span class="comment">// m_font_style corresponds to Windows LOGFONT.lfItalic field</span></div><div class="line"><a name="l01854"></a><span class="lineno"> 1854</span>&#160; <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">Stretch</a> m_font_stretch = <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">Stretch</a>::Medium;</div><div class="line"><a name="l01855"></a><span class="lineno"> 1855</span>&#160; <span class="keywordtype">bool</span> m_font_bUnderlined = false; <span class="comment">// Same as Windows LOGFONT.lfUnderlined</span></div><div class="line"><a name="l01856"></a><span class="lineno"> 1856</span>&#160; <span class="keywordtype">bool</span> m_font_bStrikethrough = false; <span class="comment">// Same as Windows LOGFONT.lfStrikeOut</span></div><div class="line"><a name="l01857"></a><span class="lineno"> 1857</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> m_logfont_charset = <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>::<a class="code" href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38">WindowsConstants</a>::logfont_default_charset;</div><div class="line"><a name="l01858"></a><span class="lineno"> 1858</span>&#160;</div><div class="line"><a name="l01859"></a><span class="lineno"> 1859</span>&#160;private:</div><div class="line"><a name="l01860"></a><span class="lineno"> 1860</span>&#160; <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> m_reserved_char1 = 0;</div><div class="line"><a name="l01861"></a><span class="lineno"> 1861</span>&#160;</div><div class="line"><a name="l01862"></a><span class="lineno"> 1862</span>&#160;private:</div><div class="line"><a name="l01863"></a><span class="lineno"> 1863</span>&#160; <span class="comment">// If m_bCompleteLOGFONT is true, then the m_LOGFONT_* values are set.</span></div><div class="line"><a name="l01864"></a><span class="lineno"> 1864</span>&#160; <span class="comment">// If m_bCompleteLOGFONT is false, then the m_LOGFONT_* values are undefined and must be ignored.</span></div><div class="line"><a name="l01865"></a><span class="lineno"> 1865</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l01866"></a><span class="lineno"> 1866</span>&#160;<span class="comment"> unsigned char m_bCompleteLOGFONT = 0;</span></div><div class="line"><a name="l01867"></a><span class="lineno"> 1867</span>&#160;<span class="comment"> unsigned char m_LOGFONT_lfClipPrecision = 0;</span></div><div class="line"><a name="l01868"></a><span class="lineno"> 1868</span>&#160;<span class="comment"> unsigned char m_LOGFONT_lfQuality = 0;</span></div><div class="line"><a name="l01869"></a><span class="lineno"> 1869</span>&#160;<span class="comment"> unsigned char m_LOGFONT_lfPitchAndFamily = 0;</span></div><div class="line"><a name="l01870"></a><span class="lineno"> 1870</span>&#160;<span class="comment"> unsigned char m_LOGFONT_lfOutPrecision = 0;</span></div><div class="line"><a name="l01871"></a><span class="lineno"> 1871</span>&#160;<span class="comment"> int m_LOGFONT_lfHeight = 0;</span></div><div class="line"><a name="l01872"></a><span class="lineno"> 1872</span>&#160;<span class="comment"> int m_LOGFONT_lfWidth = 0;</span></div><div class="line"><a name="l01873"></a><span class="lineno"> 1873</span>&#160;<span class="comment"> int m_LOGFONT_lfEscapement = 0;</span></div><div class="line"><a name="l01874"></a><span class="lineno"> 1874</span>&#160;<span class="comment"> int m_LOGFONT_lfOrientation = 0;</span></div><div class="line"><a name="l01875"></a><span class="lineno"> 1875</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l01876"></a><span class="lineno"> 1876</span>&#160;</div><div class="line"><a name="l01877"></a><span class="lineno"> 1877</span>&#160;private:</div><div class="line"><a name="l01878"></a><span class="lineno"> 1878</span>&#160; enum : <span class="keywordtype">int</span></div><div class="line"><a name="l01879"></a><span class="lineno"> 1879</span>&#160; {</div><div class="line"><a name="l01880"></a><span class="lineno"> 1880</span>&#160; face_name_capacity = 32</div><div class="line"><a name="l01881"></a><span class="lineno"> 1881</span>&#160; };</div><div class="line"><a name="l01882"></a><span class="lineno"> 1882</span>&#160; <span class="comment">// https://en.wikipedia.org/wiki/List_of_typefaces_included_with_Microsoft_Windows</span></div><div class="line"><a name="l01883"></a><span class="lineno"> 1883</span>&#160; <span class="keywordtype">wchar_t</span> m_face_name[ON_Font::face_name_capacity+2]; <span class="comment">// same as Windows LOGFONT.lfFaceName </span></div><div class="line"><a name="l01884"></a><span class="lineno"> 1884</span>&#160;</div><div class="line"><a name="l01885"></a><span class="lineno"> 1885</span>&#160; <span class="comment">// If m_linefeed_ratio needs to become a variable or variables are required for tracking or stretch,</span></div><div class="line"><a name="l01886"></a><span class="lineno"> 1886</span>&#160; <span class="comment">// these fields will be used.</span></div><div class="line"><a name="l01887"></a><span class="lineno"> 1887</span>&#160; <span class="keywordtype">double</span> m_reserved_double_0 = 0.0;</div><div class="line"><a name="l01888"></a><span class="lineno"> 1888</span>&#160; <span class="keywordtype">double</span> m_reserved_double_1 = 0.0;</div><div class="line"><a name="l01889"></a><span class="lineno"> 1889</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01890"></a><span class="lineno"> 1890</span>&#160; <span class="comment">// END &quot;font glpyh definition&quot; parameters:</span></div><div class="line"><a name="l01891"></a><span class="lineno"> 1891</span>&#160; <span class="comment">//</span><span class="comment"></span></div><div class="line"><a name="l01892"></a><span class="lineno"> 1892</span>&#160;<span class="comment"> //////////////////////////////////////////////////////////////////////////////////</span></div><div class="line"><a name="l01893"></a><span class="lineno"> 1893</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01894"></a><span class="lineno"> 1894</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01895"></a><span class="lineno"> 1895</span>&#160; <span class="comment">// https://support.apple.com/en-us/HT201375</span></div><div class="line"><a name="l01896"></a><span class="lineno"> 1896</span>&#160; <span class="comment">// https://en.wikipedia.org/wiki/List_of_typefaces_included_with_OS_X</span></div><div class="line"><a name="l01897"></a><span class="lineno"> 1897</span>&#160; <a class="code" href="../../d1/d11/class_o_n__w_string.html">ON_wString</a> m_apple_font_name;</div><div class="line"><a name="l01898"></a><span class="lineno"> 1898</span>&#160;</div><div class="line"><a name="l01899"></a><span class="lineno"> 1899</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01900"></a><span class="lineno"> 1900</span>&#160; <a class="code" href="../../d1/d11/class_o_n__w_string.html">ON_wString</a> m_font_description;</div><div class="line"><a name="l01901"></a><span class="lineno"> 1901</span>&#160;</div><div class="line"><a name="l01902"></a><span class="lineno"> 1902</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01903"></a><span class="lineno"> 1903</span>&#160; <span class="comment">// A sha1 hash of all font characteristics.</span></div><div class="line"><a name="l01904"></a><span class="lineno"> 1904</span>&#160; <span class="comment">// This value is set using lazy evaluation.</span></div><div class="line"><a name="l01905"></a><span class="lineno"> 1905</span>&#160; <span class="comment">// A zero digest indicates it is not set.</span></div><div class="line"><a name="l01906"></a><span class="lineno"> 1906</span>&#160; <span class="keyword">mutable</span> <a class="code" href="../../dd/ddf/class_o_n___s_h_a1___hash.html">ON_SHA1_Hash</a> m_font_characteristics_hash;</div><div class="line"><a name="l01907"></a><span class="lineno"> 1907</span>&#160;</div><div class="line"><a name="l01908"></a><span class="lineno"> 1908</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01909"></a><span class="lineno"> 1909</span>&#160; <span class="keywordtype">bool</span> ModificationPermitted(</div><div class="line"><a name="l01910"></a><span class="lineno"> 1910</span>&#160; <span class="keyword">const</span> <span class="keywordtype">char</span>* function_name,</div><div class="line"><a name="l01911"></a><span class="lineno"> 1911</span>&#160; <span class="keyword">const</span> <span class="keywordtype">char</span>* file_name,</div><div class="line"><a name="l01912"></a><span class="lineno"> 1912</span>&#160; <span class="keywordtype">int</span> line_number</div><div class="line"><a name="l01913"></a><span class="lineno"> 1913</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l01914"></a><span class="lineno"> 1914</span>&#160;</div><div class="line"><a name="l01915"></a><span class="lineno"> 1915</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01916"></a><span class="lineno"> 1916</span>&#160; <span class="keywordtype">void</span> Internal_SetFontDescription();</div><div class="line"><a name="l01917"></a><span class="lineno"> 1917</span>&#160;</div><div class="line"><a name="l01918"></a><span class="lineno"> 1918</span>&#160;</div><div class="line"><a name="l01919"></a><span class="lineno"> 1919</span>&#160;<span class="keyword">private</span>:<span class="comment"></span></div><div class="line"><a name="l01920"></a><span class="lineno"> 1920</span>&#160;<span class="comment"> //////////////////////////////////////////////////////////////////////////////////</span></div><div class="line"><a name="l01921"></a><span class="lineno"> 1921</span>&#160;<span class="comment"></span> <span class="comment">//</span></div><div class="line"><a name="l01922"></a><span class="lineno"> 1922</span>&#160; <span class="comment">// BEGIN global font glyph cache interface</span></div><div class="line"><a name="l01923"></a><span class="lineno"> 1923</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01924"></a><span class="lineno"> 1924</span>&#160; <span class="comment">// There is a single font glyph cache for each managed font.</span></div><div class="line"><a name="l01925"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#abdbd0cbf02f8fecc25d975bfa2903a81"> 1925</a></span>&#160; <span class="comment">// Fonts that are not managed use a glyph cache from a managed font.</span></div><div class="line"><a name="l01926"></a><span class="lineno"> 1926</span>&#160; <span class="comment">// This make functions like ON_Font.FindGlyph() efficient and reliable.</span></div><div class="line"><a name="l01927"></a><span class="lineno"> 1927</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01928"></a><span class="lineno"> 1928</span>&#160; <span class="keywordtype">void</span> DestroyFontGlyphCache();</div><div class="line"><a name="l01929"></a><span class="lineno"> 1929</span>&#160; <span class="keyword">class </span>ON_FontGlyphCache* FontGlyphCache(</div><div class="line"><a name="l01930"></a><span class="lineno"> 1930</span>&#160; <span class="keywordtype">bool</span> bCreateIfMissing</div><div class="line"><a name="l01931"></a><span class="lineno"><a class="line" href="../../d8/df5/class_o_n___font.html#a22633899e9c5bfe5cfcd9031fb5f31ac"> 1931</a></span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l01932"></a><span class="lineno"> 1932</span>&#160;<span class="preprocessor">#pragma ON_PRAGMA_WARNING_PUSH</span></div><div class="line"><a name="l01933"></a><span class="lineno"> 1933</span>&#160;<span class="preprocessor">#pragma ON_PRAGMA_WARNING_DISABLE_MSC( 4251 ) </span></div><div class="line"><a name="l01934"></a><span class="lineno"> 1934</span>&#160; <span class="comment">// C4251: &#39;...std::shared_ptr&lt;class ON_FontGlyphCache&gt;...&#39; </span></div><div class="line"><a name="l01935"></a><span class="lineno"> 1935</span>&#160; <span class="comment">// needs to have dll-interface to be used by clients of class &#39;ON_Font&#39;</span></div><div class="line"><a name="l01936"></a><span class="lineno"> 1936</span>&#160; <span class="comment">// m_font_glyph_cache is private and all code that manages m_font_glyph_cache is explicitly implemented in the DLL.</span></div><div class="line"><a name="l01937"></a><span class="lineno"> 1937</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01938"></a><span class="lineno"> 1938</span>&#160; <span class="keyword">mutable</span> std::shared_ptr&lt;class ON_FontGlyphCache&gt; m_font_glyph_cache;</div><div class="line"><a name="l01939"></a><span class="lineno"> 1939</span>&#160;<span class="preprocessor">#pragma ON_PRAGMA_WARNING_POP</span></div><div class="line"><a name="l01940"></a><span class="lineno"> 1940</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l01941"></a><span class="lineno"> 1941</span>&#160; <span class="comment">// END global font cache interface</span></div><div class="line"><a name="l01942"></a><span class="lineno"> 1942</span>&#160; <span class="comment">//</span><span class="comment"></span></div><div class="line"><a name="l01943"></a><span class="lineno"> 1943</span>&#160;<span class="comment"> //////////////////////////////////////////////////////////////////////////////////</span></div><div class="line"><a name="l01944"></a><span class="lineno"> 1944</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01945"></a><span class="lineno"> 1945</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01946"></a><span class="lineno"> 1946</span>&#160; <span class="comment">// Only managed fonts have a non-null m_free_type_face face.</span></div><div class="line"><a name="l01947"></a><span class="lineno"> 1947</span>&#160; <span class="keyword">mutable</span> <span class="keyword">class </span>ON_FreeTypeFace* m_free_type_face = <span class="keyword">nullptr</span>;</div><div class="line"><a name="l01948"></a><span class="lineno"> 1948</span>&#160;</div><div class="line"><a name="l01949"></a><span class="lineno"> 1949</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01950"></a><span class="lineno"> 1950</span>&#160; ON__UINT_PTR m_reserved_ptr = 0;</div><div class="line"><a name="l01951"></a><span class="lineno"> 1951</span>&#160;</div><div class="line"><a name="l01952"></a><span class="lineno"> 1952</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l01953"></a><span class="lineno"> 1953</span>&#160; <span class="comment">// Returns free type glyph index (or nonzero equivalent) if glyph is defined fo the glyph.CodePoint() in glyph.Font()</span></div><div class="line"><a name="l01954"></a><span class="lineno"> 1954</span>&#160; <span class="comment">// and glyph_box is set.</span></div><div class="line"><a name="l01955"></a><span class="lineno"> 1955</span>&#160; <span class="keyword">typedef</span> ON__UINT_PTR (*ON_GetGlyphMetricsFuncType)(</div><div class="line"><a name="l01956"></a><span class="lineno"> 1956</span>&#160; <span class="keyword">const</span> <span class="keyword">class </span><a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font, </div><div class="line"><a name="l01957"></a><span class="lineno"> 1957</span>&#160; ON__UINT32 unicode_code_point,</div><div class="line"><a name="l01958"></a><span class="lineno"><a class="line" href="../../dc/dec/class_o_n___text_box.html"> 1958</a></span>&#160; <span class="keyword">class </span><a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; font_unit_glyph_box</div><div class="line"><a name="l01959"></a><span class="lineno"> 1959</span>&#160; );</div><div class="line"><a name="l01960"></a><span class="lineno"> 1960</span>&#160;</div><div class="line"><a name="l01961"></a><span class="lineno"> 1961</span>&#160; <span class="keyword">typedef</span> void (*ON_GetFontMetricsFuncType)(</div><div class="line"><a name="l01962"></a><span class="lineno"> 1962</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l01963"></a><span class="lineno"> 1963</span>&#160; <a class="code" href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a>&amp; font_unit_font_metrics</div><div class="line"><a name="l01964"></a><span class="lineno"> 1964</span>&#160; );</div><div class="line"><a name="l01965"></a><span class="lineno"> 1965</span>&#160;</div><div class="line"><a name="l01966"></a><span class="lineno"> 1966</span>&#160; <span class="keyword">static</span> <span class="keywordtype">void</span> SetCustomMeasurementFunctions(</div><div class="line"><a name="l01967"></a><span class="lineno"> 1967</span>&#160; ON_GetGlyphMetricsFuncType measureGlyphFunc,</div><div class="line"><a name="l01968"></a><span class="lineno"> 1968</span>&#160; ON_GetFontMetricsFuncType metricsFunction</div><div class="line"><a name="l01969"></a><span class="lineno"> 1969</span>&#160; );</div><div class="line"><a name="l01970"></a><span class="lineno"> 1970</span>&#160;</div><div class="line"><a name="l01971"></a><span class="lineno"> 1971</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l01972"></a><span class="lineno"> 1972</span>&#160; <span class="keyword">static</span> ON_GetGlyphMetricsFuncType Internal_CustomGetGlyphMetricsFunc;</div><div class="line"><a name="l01973"></a><span class="lineno"> 1973</span>&#160; <span class="keyword">static</span> ON_GetFontMetricsFuncType Internal_CustomGetFontMetricsFunc;</div><div class="line"><a name="l01974"></a><span class="lineno"> 1974</span>&#160;</div><div class="line"><a name="l01975"></a><span class="lineno"> 1975</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l01976"></a><span class="lineno"> 1976</span>&#160; <span class="keyword">static</span> <span class="keywordtype">void</span> GetRunBounds(</div><div class="line"><a name="l01977"></a><span class="lineno"> 1977</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>&amp; font,</div><div class="line"><a name="l01978"></a><span class="lineno"> 1978</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* text,</div><div class="line"><a name="l01979"></a><span class="lineno"> 1979</span>&#160; <span class="keywordtype">double</span> fontSizePixels,</div><div class="line"><a name="l01980"></a><span class="lineno"> 1980</span>&#160; ON::TextHorizontalAlignment horizontalAlignment,</div><div class="line"><a name="l01981"></a><span class="lineno"> 1981</span>&#160; ON::TextVerticalAlignment verticalAlignment,</div><div class="line"><a name="l01982"></a><span class="lineno"> 1982</span>&#160; <a class="code" href="../../dd/dd9/class_o_n__2d_point.html">ON_2dPoint</a>&amp; boundsMin,</div><div class="line"><a name="l01983"></a><span class="lineno"> 1983</span>&#160; <a class="code" href="../../dd/dd9/class_o_n__2d_point.html">ON_2dPoint</a>&amp; boundsMax, </div><div class="line"><a name="l01984"></a><span class="lineno"> 1984</span>&#160; <span class="keywordtype">int</span>&amp; lineCount</div><div class="line"><a name="l01985"></a><span class="lineno"> 1985</span>&#160; );</div><div class="line"><a name="l01986"></a><span class="lineno"> 1986</span>&#160;};</div><div class="line"><a name="l01987"></a><span class="lineno"> 1987</span>&#160;</div><div class="line"><a name="l01988"></a><span class="lineno"> 1988</span>&#160;<span class="keyword">class </span>ON_CLASS <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a></div><div class="line"><a name="l01989"></a><span class="lineno"> 1989</span>&#160;{</div><div class="line"><a name="l01990"></a><span class="lineno"> 1990</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l01991"></a><span class="lineno"> 1991</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l01992"></a><span class="lineno"> 1992</span>&#160; ~<a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l01993"></a><span class="lineno"> 1993</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>(<span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp;) = <span class="keywordflow">default</span>;</div><div class="line"><a name="l01994"></a><span class="lineno"> 1994</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; operator=(<span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp;) = <span class="keywordflow">default</span>;</div><div class="line"><a name="l01995"></a><span class="lineno"> 1995</span>&#160;</div><div class="line"><a name="l01996"></a><span class="lineno"> 1996</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>(</div><div class="line"><a name="l01997"></a><span class="lineno"> 1997</span>&#160; <a class="code" href="../../dd/dd9/class_o_n__2d_point.html">ON_2dPoint</a> bbmin,</div><div class="line"><a name="l01998"></a><span class="lineno"> 1998</span>&#160; <a class="code" href="../../dd/dd9/class_o_n__2d_point.html">ON_2dPoint</a> bbmax</div><div class="line"><a name="l01999"></a><span class="lineno"> 1999</span>&#160; );</div><div class="line"><a name="l02000"></a><span class="lineno"> 2000</span>&#160;</div><div class="line"><a name="l02001"></a><span class="lineno"> 2001</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02002"></a><span class="lineno"> 2002</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02003"></a><span class="lineno"> 2003</span>&#160;<span class="comment"> true if bounding box is set.</span></div><div class="line"><a name="l02004"></a><span class="lineno"> 2004</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02005"></a><span class="lineno"> 2005</span>&#160; <span class="keywordtype">bool</span> IsSet() <span class="keyword">const</span>;</div><div class="line"><a name="l02006"></a><span class="lineno"> 2006</span>&#160;</div><div class="line"><a name="l02007"></a><span class="lineno"> 2007</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a> Scale(</div><div class="line"><a name="l02008"></a><span class="lineno"> 2008</span>&#160; <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; text_box,</div><div class="line"><a name="l02009"></a><span class="lineno"><a class="line" href="../../dc/dec/class_o_n___text_box.html#abc6225b9f30405a30650389d4d2a707c"> 2009</a></span>&#160; <span class="keywordtype">double</span> scale</div><div class="line"><a name="l02010"></a><span class="lineno"> 2010</span>&#160; );</div><div class="line"><a name="l02011"></a><span class="lineno"> 2011</span>&#160;</div><div class="line"><a name="l02012"></a><span class="lineno"> 2012</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02013"></a><span class="lineno"> 2013</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02014"></a><span class="lineno"> 2014</span>&#160;<span class="comment"> A text box with m_bbmin, m_bbmax, m_max_basepoint are translated by delta.</span></div><div class="line"><a name="l02015"></a><span class="lineno"> 2015</span>&#160;<span class="comment"> m_advance is not changed.</span></div><div class="line"><a name="l02016"></a><span class="lineno"> 2016</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02017"></a><span class="lineno"> 2017</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a> Translate(</div><div class="line"><a name="l02018"></a><span class="lineno"> 2018</span>&#160; <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; text_box,</div><div class="line"><a name="l02019"></a><span class="lineno"><a class="line" href="../../dc/dec/class_o_n___text_box.html#ac914a568b2c4d091e3adcf44baba0a26"> 2019</a></span>&#160; <span class="keyword">const</span> <a class="code" href="../../da/d08/class_o_n__2d_vector.html">ON_2dVector</a>&amp; delta</div><div class="line"><a name="l02020"></a><span class="lineno"><a class="line" href="../../dc/dec/class_o_n___text_box.html#a3fd1c1c7eb1111071f93950c83e82d48"> 2020</a></span>&#160; );</div><div class="line"><a name="l02021"></a><span class="lineno"> 2021</span>&#160;</div><div class="line"><a name="l02022"></a><span class="lineno"> 2022</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a> Translate(</div><div class="line"><a name="l02023"></a><span class="lineno"> 2023</span>&#160; <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; text_box,</div><div class="line"><a name="l02024"></a><span class="lineno"><a class="line" href="../../dc/dec/class_o_n___text_box.html#a298ede872dbd12999034c53a1f445cd2"> 2024</a></span>&#160; <span class="keyword">const</span> ON_2dex&amp; delta</div><div class="line"><a name="l02025"></a><span class="lineno"> 2025</span>&#160; );</div><div class="line"><a name="l02026"></a><span class="lineno"> 2026</span>&#160;</div><div class="line"><a name="l02027"></a><span class="lineno"> 2027</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02028"></a><span class="lineno"> 2028</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l02029"></a><span class="lineno"> 2029</span>&#160;<span class="comment"> lhs - [in]</span></div><div class="line"><a name="l02030"></a><span class="lineno"> 2030</span>&#160;<span class="comment"> lhs.m_advance is ignored</span></div><div class="line"><a name="l02031"></a><span class="lineno"> 2031</span>&#160;<span class="comment"> rhs - [in]</span></div><div class="line"><a name="l02032"></a><span class="lineno"> 2032</span>&#160;<span class="comment"> rhs.m_advance is ignored</span></div><div class="line"><a name="l02033"></a><span class="lineno"> 2033</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02034"></a><span class="lineno"> 2034</span>&#160;<span class="comment"> Returned m_bbmin, m_bbmax, m_max_basepoint are the union of the lhs and rhs bounding box.</span></div><div class="line"><a name="l02035"></a><span class="lineno"> 2035</span>&#160;<span class="comment"> Returned m_advance = (0,0)</span></div><div class="line"><a name="l02036"></a><span class="lineno"><a class="line" href="../../dc/dec/class_o_n___text_box.html#a4cf01949d6227e17a7ae8f7df69d1929"> 2036</a></span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02037"></a><span class="lineno"> 2037</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a> Union(</div><div class="line"><a name="l02038"></a><span class="lineno"> 2038</span>&#160; <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; lhs,</div><div class="line"><a name="l02039"></a><span class="lineno"><a class="line" href="../../da/d62/class_o_n___font_glyph_outline_point.html"> 2039</a></span>&#160; <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; rhs</div><div class="line"><a name="l02040"></a><span class="lineno"> 2040</span>&#160; );</div><div class="line"><a name="l02041"></a><span class="lineno"> 2041</span>&#160;</div><div class="line"><a name="l02042"></a><span class="lineno"> 2042</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l02043"></a><span class="lineno"> 2043</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a> Unset;</div><div class="line"><a name="l02044"></a><span class="lineno"> 2044</span>&#160;</div><div class="line"><a name="l02045"></a><span class="lineno"> 2045</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l02046"></a><span class="lineno"> 2046</span>&#160; <span class="comment">// Default units are with respect to a LOGFONT height = ON_Font::Constants::AnnotationFontCellHeight.</span></div><div class="line"><a name="l02047"></a><span class="lineno"><a class="line" href="../../da/d62/class_o_n___font_glyph_outline_point.html#aef12c67de9caa9dd638f8bfe5c874c9e"> 2047</a></span>&#160; <span class="comment">// and (0,0) is the font glyph base point.</span></div><div class="line"><a name="l02048"></a><span class="lineno"> 2048</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l02049"></a><span class="lineno"> 2049</span>&#160; <span class="comment">// Application of a Scale or Translate will change distance units and base point.</span></div><div class="line"><a name="l02050"></a><span class="lineno"> 2050</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l02051"></a><span class="lineno"> 2051</span>&#160;</div><div class="line"><a name="l02052"></a><span class="lineno"> 2052</span>&#160; <span class="comment">// Tight bounding box of the rendered glyphs.</span></div><div class="line"><a name="l02053"></a><span class="lineno"> 2053</span>&#160; ON_2dex m_bbmin = ON_2dex::Unset;</div><div class="line"><a name="l02054"></a><span class="lineno"> 2054</span>&#160; ON_2dex m_bbmax = ON_2dex::Unset;</div><div class="line"><a name="l02055"></a><span class="lineno"> 2055</span>&#160;</div><div class="line"><a name="l02056"></a><span class="lineno"> 2056</span>&#160; <span class="comment">// m_max_basepoint.i = maximum horizontal delta in any line. Increases to the right, decreases to the left.</span></div><div class="line"><a name="l02057"></a><span class="lineno"> 2057</span>&#160; <span class="comment">// m_max_basepoint.i = vertical delta to basline of bottom line. Increases upward, decreases downward.</span></div><div class="line"><a name="l02058"></a><span class="lineno"> 2058</span>&#160; ON_2dex m_max_basepoint = ON_2dex::Zero;</div><div class="line"><a name="l02059"></a><span class="lineno"> 2059</span>&#160;</div><div class="line"><a name="l02060"></a><span class="lineno"> 2060</span>&#160; <span class="comment">// m_advance is a vector that specifies where the basepoint should be moved</span></div><div class="line"><a name="l02061"></a><span class="lineno"> 2061</span>&#160; <span class="comment">// to after the text is rendered. m_advance.i and m_advance.j are is always &gt;= 0. </span></div><div class="line"><a name="l02062"></a><span class="lineno"> 2062</span>&#160; <span class="comment">// When glyphs are rendered right to left (Arabic and Hebrew being examples)</span></div><div class="line"><a name="l02063"></a><span class="lineno"> 2063</span>&#160; <span class="comment">// or bottom to top, the rendering code must apply the correct sign. One reason</span></div><div class="line"><a name="l02064"></a><span class="lineno"> 2064</span>&#160; <span class="comment">// is that Arabic and Hebrew text can be mixed with latin and Cyrillic text</span></div><div class="line"><a name="l02065"></a><span class="lineno"> 2065</span>&#160; <span class="comment">// and text rendering is much more complicated than a signed advance can handle.</span></div><div class="line"><a name="l02066"></a><span class="lineno"><a class="line" href="../../da/d62/class_o_n___font_glyph_outline_point.html#a25ad5aa26640a0e3da1f4df4fe341a5e"> 2066</a></span>&#160; <span class="comment">// Another is that the sign of y associated with &quot;up&quot; is sometimes positive and sometimes negative.</span></div><div class="line"><a name="l02067"></a><span class="lineno"> 2067</span>&#160; <span class="comment">// ON_TextBox::Translate does not modify the vector m_advance. </span></div><div class="line"><a name="l02068"></a><span class="lineno"> 2068</span>&#160; <span class="comment">// ON_TextBox::Union ignored input advance values and returns a box with advance = (0,0).</span></div><div class="line"><a name="l02069"></a><span class="lineno"><a class="line" href="../../da/d62/class_o_n___font_glyph_outline_point.html#a7ab162eef38cf2469cce3ca50d485574"> 2069</a></span>&#160; <span class="comment">// 0 &lt;= m_advance.i will be &lt;= m_max_basepoint.i.</span></div><div class="line"><a name="l02070"></a><span class="lineno"><a class="line" href="../../da/d62/class_o_n___font_glyph_outline_point.html#a8c0f3c2f43e36643203d8b69da60cb93"> 2070</a></span>&#160; ON_2dex m_advance = ON_2dex::Zero;</div><div class="line"><a name="l02071"></a><span class="lineno"> 2071</span>&#160;};</div><div class="line"><a name="l02072"></a><span class="lineno"><a class="line" href="../../da/d62/class_o_n___font_glyph_outline_point.html#a57f0f661c91c88a671dc1aacc186d2ae"> 2072</a></span>&#160;</div><div class="line"><a name="l02073"></a><span class="lineno"><a class="line" href="../../da/d62/class_o_n___font_glyph_outline_point.html#af56bdf7dfe83d84d93f33a5ab420fbe3"> 2073</a></span>&#160;<span class="keyword">class </span>ON_CLASS <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a></div><div class="line"><a name="l02074"></a><span class="lineno"> 2074</span>&#160;{</div><div class="line"><a name="l02075"></a><span class="lineno"> 2075</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l02076"></a><span class="lineno"> 2076</span>&#160; <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l02077"></a><span class="lineno"> 2077</span>&#160; ~<a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l02078"></a><span class="lineno"> 2078</span>&#160; <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a>(<span class="keyword">const</span> <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a>&amp;) = <span class="keywordflow">default</span>;</div><div class="line"><a name="l02079"></a><span class="lineno"> 2079</span>&#160; <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a>&amp; operator= (<span class="keyword">const</span> <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a>&amp;) = <span class="keywordflow">default</span>;</div><div class="line"><a name="l02080"></a><span class="lineno"> 2080</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l02081"></a><span class="lineno"><a class="line" href="../../d7/d29/class_o_n___font_glyph.html"> 2081</a></span>&#160; <span class="keyword">enum class</span> ContourPointType : ON__UINT8</div><div class="line"><a name="l02082"></a><span class="lineno"> 2082</span>&#160; {</div><div class="line"><a name="l02083"></a><span class="lineno"> 2083</span>&#160; Unset = 0,</div><div class="line"><a name="l02084"></a><span class="lineno"> 2084</span>&#160; MoveTo = 1,</div><div class="line"><a name="l02085"></a><span class="lineno"> 2085</span>&#160; LineTo = 2,</div><div class="line"><a name="l02086"></a><span class="lineno"> 2086</span>&#160; </div><div class="line"><a name="l02087"></a><span class="lineno"> 2087</span>&#160; <span class="comment">// quadratic bezier (degree=2, order=3) control point.</span></div><div class="line"><a name="l02088"></a><span class="lineno"> 2088</span>&#160; QuadraticBezierPoint = 3,</div><div class="line"><a name="l02089"></a><span class="lineno"> 2089</span>&#160;</div><div class="line"><a name="l02090"></a><span class="lineno"> 2090</span>&#160; <span class="comment">// cubic bezier (degree=3, order=4) control point.</span></div><div class="line"><a name="l02091"></a><span class="lineno"> 2091</span>&#160; CubicBezierPoint = 4,</div><div class="line"><a name="l02092"></a><span class="lineno"> 2092</span>&#160;</div><div class="line"><a name="l02093"></a><span class="lineno"> 2093</span>&#160; <span class="comment">// a line segment added to close an open contour.</span></div><div class="line"><a name="l02094"></a><span class="lineno"> 2094</span>&#160; <span class="comment">// This is common. It does not indicate the glyph is a single stroke glyph.</span></div><div class="line"><a name="l02095"></a><span class="lineno"> 2095</span>&#160; LineToCloseContour = 5</div><div class="line"><a name="l02096"></a><span class="lineno"> 2096</span>&#160; };</div><div class="line"><a name="l02097"></a><span class="lineno"> 2097</span>&#160;</div><div class="line"><a name="l02098"></a><span class="lineno"> 2098</span>&#160; <span class="keyword">static</span> <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html#aef12c67de9caa9dd638f8bfe5c874c9e">ON_FontGlyphOutlinePoint::ContourPointType</a> ContourPointTypeFromUnsigned(<span class="keywordtype">unsigned</span> contour_point_type_as_unsigned);</div><div class="line"><a name="l02099"></a><span class="lineno"> 2099</span>&#160;</div><div class="line"><a name="l02100"></a><span class="lineno"> 2100</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a> Unset;</div><div class="line"><a name="l02101"></a><span class="lineno"> 2101</span>&#160;</div><div class="line"><a name="l02102"></a><span class="lineno"> 2102</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l02103"></a><span class="lineno"> 2103</span>&#160; <a class="code" href="../../da/d62/class_o_n___font_glyph_outline_point.html#aef12c67de9caa9dd638f8bfe5c874c9e">ON_FontGlyphOutlinePoint::ContourPointType</a> m_point_type = ContourPointType::Unset; </div><div class="line"><a name="l02104"></a><span class="lineno"> 2104</span>&#160; ON__UINT8 m_bToPoint = 0; <span class="comment">// 1 if the point is a move to, line to, or the start or end of a bezier segment.</span></div><div class="line"><a name="l02105"></a><span class="lineno"><a class="line" href="../../d7/d29/class_o_n___font_glyph.html#adf58bc26e08d1b822cbcd6236493ec8b"> 2105</a></span>&#160; <span class="comment">// 0 otherwise</span></div><div class="line"><a name="l02106"></a><span class="lineno"> 2106</span>&#160; ON__UINT16 m_contour_index = 0; <span class="comment">// 0 = unset. The first contour has m_contour_index = 1.</span></div><div class="line"><a name="l02107"></a><span class="lineno"> 2107</span>&#160; <a class="code" href="../../de/dd6/class_o_n__2i_point.html">ON_2iPoint</a> m_point = <a class="code" href="../../de/dd6/class_o_n__2i_point.html#a21721819ea51e0fae5b56aed251184bd">ON_2iPoint::Unset</a>;</div><div class="line"><a name="l02108"></a><span class="lineno"> 2108</span>&#160;};</div><div class="line"><a name="l02109"></a><span class="lineno"> 2109</span>&#160;</div><div class="line"><a name="l02110"></a><span class="lineno"> 2110</span>&#160;</div><div class="line"><a name="l02111"></a><span class="lineno"> 2111</span>&#160;<span class="comment">/*</span></div><div class="line"><a name="l02112"></a><span class="lineno"> 2112</span>&#160;<span class="comment"> The best way to get a useful ON_FontGlyph is to call</span></div><div class="line"><a name="l02113"></a><span class="lineno"> 2113</span>&#160;<span class="comment"> ON_Font.CodePointGlyph(unicode_code_point)</span></div><div class="line"><a name="l02114"></a><span class="lineno"> 2114</span>&#160;<span class="comment">*/</span></div><div class="line"><a name="l02115"></a><span class="lineno"> 2115</span>&#160;<span class="keyword">class </span>ON_CLASS <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a> </div><div class="line"><a name="l02116"></a><span class="lineno"> 2116</span>&#160;{</div><div class="line"><a name="l02117"></a><span class="lineno"> 2117</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l02118"></a><span class="lineno"> 2118</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02119"></a><span class="lineno"> 2119</span>&#160;<span class="comment"> The best way to get a useful ON_FontGlyph is to call</span></div><div class="line"><a name="l02120"></a><span class="lineno"> 2120</span>&#160;<span class="comment"> ON_Font.CodePointGlyph(unicode_code_point)</span></div><div class="line"><a name="l02121"></a><span class="lineno"> 2121</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02122"></a><span class="lineno"> 2122</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l02123"></a><span class="lineno"> 2123</span>&#160; ~<a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>() = <span class="keywordflow">default</span>;</div><div class="line"><a name="l02124"></a><span class="lineno"> 2124</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>(<span class="keyword">const</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>&amp; src);</div><div class="line"><a name="l02125"></a><span class="lineno"> 2125</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>&amp; operator=(<span class="keyword">const</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>&amp; src);</div><div class="line"><a name="l02126"></a><span class="lineno"> 2126</span>&#160;</div><div class="line"><a name="l02127"></a><span class="lineno"> 2127</span>&#160;</div><div class="line"><a name="l02128"></a><span class="lineno"> 2128</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02129"></a><span class="lineno"> 2129</span>&#160;<span class="comment"> If the font and code point are valid, constructs an unmanaged </span></div><div class="line"><a name="l02130"></a><span class="lineno"> 2130</span>&#160;<span class="comment"> glyph with the specified font and code point.</span></div><div class="line"><a name="l02131"></a><span class="lineno"> 2131</span>&#160;<span class="comment"> The glyph box is not set.</span></div><div class="line"><a name="l02132"></a><span class="lineno"> 2132</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02133"></a><span class="lineno"> 2133</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>(</div><div class="line"><a name="l02134"></a><span class="lineno"> 2134</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l02135"></a><span class="lineno"> 2135</span>&#160; ON__UINT32 code_point</div><div class="line"><a name="l02136"></a><span class="lineno"> 2136</span>&#160; );</div><div class="line"><a name="l02137"></a><span class="lineno"> 2137</span>&#160;</div><div class="line"><a name="l02138"></a><span class="lineno"> 2138</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l02139"></a><span class="lineno"> 2139</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a> Unset;</div><div class="line"><a name="l02140"></a><span class="lineno"> 2140</span>&#160;</div><div class="line"><a name="l02141"></a><span class="lineno"> 2141</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* Font() <span class="keyword">const</span>;</div><div class="line"><a name="l02142"></a><span class="lineno"> 2142</span>&#160; </div><div class="line"><a name="l02143"></a><span class="lineno"> 2143</span>&#160; <span class="keyword">const</span> ON__UINT32 CodePoint() <span class="keyword">const</span>;</div><div class="line"><a name="l02144"></a><span class="lineno"> 2144</span>&#160;</div><div class="line"><a name="l02145"></a><span class="lineno"> 2145</span>&#160; <span class="keywordtype">bool</span> IsEndOfLineCodePoint() <span class="keyword">const</span>;</div><div class="line"><a name="l02146"></a><span class="lineno"> 2146</span>&#160;</div><div class="line"><a name="l02147"></a><span class="lineno"> 2147</span>&#160; <span class="keyword">static</span> <span class="keywordtype">bool</span> IsEndOfLineCodePoint(</div><div class="line"><a name="l02148"></a><span class="lineno"> 2148</span>&#160; ON__UINT32 unicode_code_point</div><div class="line"><a name="l02149"></a><span class="lineno"> 2149</span>&#160; );</div><div class="line"><a name="l02150"></a><span class="lineno"> 2150</span>&#160;</div><div class="line"><a name="l02151"></a><span class="lineno"> 2151</span>&#160; <span class="keyword">static</span> <span class="keywordtype">bool</span> IsCarriageReturnAndLineFeed(</div><div class="line"><a name="l02152"></a><span class="lineno"> 2152</span>&#160; ON__UINT32 unicode_code_point,</div><div class="line"><a name="l02153"></a><span class="lineno"> 2153</span>&#160; ON__UINT32 next_unicode_code_point</div><div class="line"><a name="l02154"></a><span class="lineno"> 2154</span>&#160; );</div><div class="line"><a name="l02155"></a><span class="lineno"> 2155</span>&#160;</div><div class="line"><a name="l02156"></a><span class="lineno"> 2156</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02157"></a><span class="lineno"> 2157</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02158"></a><span class="lineno"> 2158</span>&#160;<span class="comment"> Glyph box in opennurbs normalized font coordinates.</span></div><div class="line"><a name="l02159"></a><span class="lineno"> 2159</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02160"></a><span class="lineno"> 2160</span>&#160; <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; GlyphBox() <span class="keyword">const</span>;</div><div class="line"><a name="l02161"></a><span class="lineno"> 2161</span>&#160;</div><div class="line"><a name="l02162"></a><span class="lineno"> 2162</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02163"></a><span class="lineno"> 2163</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02164"></a><span class="lineno"> 2164</span>&#160;<span class="comment"> Font unit glyph box. </span></div><div class="line"><a name="l02165"></a><span class="lineno"> 2165</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l02166"></a><span class="lineno"> 2166</span>&#160;<span class="comment"> Must be used with ON_Font::FontUnitFontMetrics() and a single font to obtain useful results.</span></div><div class="line"><a name="l02167"></a><span class="lineno"> 2167</span>&#160;<span class="comment"> You are probably better of using normalized font coordinates in a ON_FontGlyph.GlyphBox().</span></div><div class="line"><a name="l02168"></a><span class="lineno"> 2168</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02169"></a><span class="lineno"> 2169</span>&#160; <span class="keyword">const</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; FontUnitGlyphBox() <span class="keyword">const</span>;</div><div class="line"><a name="l02170"></a><span class="lineno"> 2170</span>&#160;</div><div class="line"><a name="l02171"></a><span class="lineno"> 2171</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> CompareCodePointAndFont(</div><div class="line"><a name="l02172"></a><span class="lineno"> 2172</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>&amp; lhs,</div><div class="line"><a name="l02173"></a><span class="lineno"> 2173</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>&amp; rhs</div><div class="line"><a name="l02174"></a><span class="lineno"> 2174</span>&#160; );</div><div class="line"><a name="l02175"></a><span class="lineno"> 2175</span>&#160;</div><div class="line"><a name="l02176"></a><span class="lineno"> 2176</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02177"></a><span class="lineno"> 2177</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l02178"></a><span class="lineno"> 2178</span>&#160;<span class="comment"> text - [in]</span></div><div class="line"><a name="l02179"></a><span class="lineno"> 2179</span>&#160;<span class="comment"> Null terminated wchar_t string.</span></div><div class="line"><a name="l02180"></a><span class="lineno"> 2180</span>&#160;<span class="comment"> font - [in]</span></div><div class="line"><a name="l02181"></a><span class="lineno"> 2181</span>&#160;<span class="comment"> The font used to render the glyphs.</span></div><div class="line"><a name="l02182"></a><span class="lineno"> 2182</span>&#160;<span class="comment"> unicode_CRLF_code_point - [in]</span></div><div class="line"><a name="l02183"></a><span class="lineno"> 2183</span>&#160;<span class="comment"> If unicode_CRLF_code_point is a valid unicode code point,</span></div><div class="line"><a name="l02184"></a><span class="lineno"> 2184</span>&#160;<span class="comment"> then consecutive carriage return line feed pairs are converted</span></div><div class="line"><a name="l02185"></a><span class="lineno"> 2185</span>&#160;<span class="comment"> to a single glyph with code point = unicode_CRLF_code_point.</span></div><div class="line"><a name="l02186"></a><span class="lineno"> 2186</span>&#160;<span class="comment"></span></div><div class="line"><a name="l02187"></a><span class="lineno"> 2187</span>&#160;<span class="comment"> ON_UnicodeCodePoint::ON_LineSeparator is a good choice when you want to </span></div><div class="line"><a name="l02188"></a><span class="lineno"> 2188</span>&#160;<span class="comment"> condense carriage return line feed pairs to a single unambiguous code point.</span></div><div class="line"><a name="l02189"></a><span class="lineno"> 2189</span>&#160;<span class="comment"></span></div><div class="line"><a name="l02190"></a><span class="lineno"> 2190</span>&#160;<span class="comment"> ON_UnicodeCodePoint::ON_InvalidCodePoint is a good choice when you want to</span></div><div class="line"><a name="l02191"></a><span class="lineno"> 2191</span>&#160;<span class="comment"> preserve carriage return line feed pairs as two separate glyphs.</span></div><div class="line"><a name="l02192"></a><span class="lineno"> 2192</span>&#160;<span class="comment"></span></div><div class="line"><a name="l02193"></a><span class="lineno"> 2193</span>&#160;<span class="comment"> glyph_list - [out]</span></div><div class="line"><a name="l02194"></a><span class="lineno"> 2194</span>&#160;<span class="comment"> Note that glyph_list.Count() is often different than the </span></div><div class="line"><a name="l02195"></a><span class="lineno"> 2195</span>&#160;<span class="comment"> length of the text string or the number of unicode codepoints</span></div><div class="line"><a name="l02196"></a><span class="lineno"> 2196</span>&#160;<span class="comment"> in the decoded text. </span></div><div class="line"><a name="l02197"></a><span class="lineno"> 2197</span>&#160;<span class="comment"> Adjacent carriage return and line feed codepoints are </span></div><div class="line"><a name="l02198"></a><span class="lineno"> 2198</span>&#160;<span class="comment"> converted to single a hard end of line.</span></div><div class="line"><a name="l02199"></a><span class="lineno"> 2199</span>&#160;<span class="comment"> All trailing end of line code points are removed from text.</span></div><div class="line"><a name="l02200"></a><span class="lineno"> 2200</span>&#160;<span class="comment"> Invalid unicode encoding sequences are replaced with</span></div><div class="line"><a name="l02201"></a><span class="lineno"> 2201</span>&#160;<span class="comment"> ON_UnicodeCodePoint::ReplacementCharacter glyphs.</span></div><div class="line"><a name="l02202"></a><span class="lineno"> 2202</span>&#160;<span class="comment"></span></div><div class="line"><a name="l02203"></a><span class="lineno"> 2203</span>&#160;<span class="comment"> text_box - [out]</span></div><div class="line"><a name="l02204"></a><span class="lineno"> 2204</span>&#160;<span class="comment"> tight bounding boxt of text extents.</span></div><div class="line"><a name="l02205"></a><span class="lineno"> 2205</span>&#160;<span class="comment"> text_box.m_advance.i = maximum of all line horizontal advance values..</span></div><div class="line"><a name="l02206"></a><span class="lineno"> 2206</span>&#160;<span class="comment"> text_box.m_advance.j = vertical advance to baseline of last line</span></div><div class="line"><a name="l02207"></a><span class="lineno"> 2207</span>&#160;<span class="comment"> If if the font height</span></div><div class="line"><a name="l02208"></a><span class="lineno"> 2208</span>&#160;<span class="comment"> is ON_Font::Constants::AnnotationFontCellHeight. If you will render the font</span></div><div class="line"><a name="l02209"></a><span class="lineno"> 2209</span>&#160;<span class="comment"> at a different height from ON_Font::Constants::AnnotationFontCellHeight, then</span></div><div class="line"><a name="l02210"></a><span class="lineno"> 2210</span>&#160;<span class="comment"> use ON_TextBox::Scale as follows:</span></div><div class="line"><a name="l02211"></a><span class="lineno"> 2211</span>&#160;<span class="comment"> ON_TextBox scaled_box </span></div><div class="line"><a name="l02212"></a><span class="lineno"> 2212</span>&#160;<span class="comment"> = ON_TextBox::Scale(</span></div><div class="line"><a name="l02213"></a><span class="lineno"> 2213</span>&#160;<span class="comment"> text_box,</span></div><div class="line"><a name="l02214"></a><span class="lineno"> 2214</span>&#160;<span class="comment"> (font render height)/((double)ON_Font::Constants::AnnotationFontCellHeight)</span></div><div class="line"><a name="l02215"></a><span class="lineno"> 2215</span>&#160;<span class="comment"> );</span></div><div class="line"><a name="l02216"></a><span class="lineno"> 2216</span>&#160;<span class="comment"> Return:</span></div><div class="line"><a name="l02217"></a><span class="lineno"> 2217</span>&#160;<span class="comment"> number of lines of text or 0 if input is not valid or text is empty.</span></div><div class="line"><a name="l02218"></a><span class="lineno"> 2218</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02219"></a><span class="lineno"> 2219</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> GetGlyphList</div><div class="line"><a name="l02220"></a><span class="lineno"> 2220</span>&#160; (</div><div class="line"><a name="l02221"></a><span class="lineno"> 2221</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* text,</div><div class="line"><a name="l02222"></a><span class="lineno"> 2222</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l02223"></a><span class="lineno"> 2223</span>&#160; ON__UINT32 unicode_CRLF_code_point,</div><div class="line"><a name="l02224"></a><span class="lineno"> 2224</span>&#160; <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt;const ON_FontGlyph*&gt;</a>&amp; glyph_list,</div><div class="line"><a name="l02225"></a><span class="lineno"> 2225</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; text_box</div><div class="line"><a name="l02226"></a><span class="lineno"> 2226</span>&#160; );</div><div class="line"><a name="l02227"></a><span class="lineno"> 2227</span>&#160;</div><div class="line"><a name="l02228"></a><span class="lineno"> 2228</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> GetGlyphList</div><div class="line"><a name="l02229"></a><span class="lineno"> 2229</span>&#160; (</div><div class="line"><a name="l02230"></a><span class="lineno"> 2230</span>&#160; <span class="keywordtype">size_t</span> code_point_count,</div><div class="line"><a name="l02231"></a><span class="lineno"> 2231</span>&#160; ON__UINT32* code_points,</div><div class="line"><a name="l02232"></a><span class="lineno"> 2232</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l02233"></a><span class="lineno"> 2233</span>&#160; ON__UINT32 unicode_CRLF_code_point,</div><div class="line"><a name="l02234"></a><span class="lineno"> 2234</span>&#160; <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt;const ON_FontGlyph*&gt;</a>&amp; glyph_list,</div><div class="line"><a name="l02235"></a><span class="lineno"> 2235</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; text_box</div><div class="line"><a name="l02236"></a><span class="lineno"> 2236</span>&#160; );</div><div class="line"><a name="l02237"></a><span class="lineno"> 2237</span>&#160;</div><div class="line"><a name="l02238"></a><span class="lineno"> 2238</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02239"></a><span class="lineno"> 2239</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l02240"></a><span class="lineno"> 2240</span>&#160;<span class="comment"> font - [in]</span></div><div class="line"><a name="l02241"></a><span class="lineno"> 2241</span>&#160;<span class="comment"> The font used to render the glyphs.</span></div><div class="line"><a name="l02242"></a><span class="lineno"> 2242</span>&#160;<span class="comment"> text_box - [out]</span></div><div class="line"><a name="l02243"></a><span class="lineno"> 2243</span>&#160;<span class="comment"> tight bounding boxt of text extents.</span></div><div class="line"><a name="l02244"></a><span class="lineno"> 2244</span>&#160;<span class="comment"> text_box.m_advance.i = maximum of all line horizontal advance values..</span></div><div class="line"><a name="l02245"></a><span class="lineno"> 2245</span>&#160;<span class="comment"> text_box.m_advance.j = vertical advance to baseline of last line</span></div><div class="line"><a name="l02246"></a><span class="lineno"> 2246</span>&#160;<span class="comment"> If if the font height</span></div><div class="line"><a name="l02247"></a><span class="lineno"> 2247</span>&#160;<span class="comment"> is ON_Font::Constants::AnnotationFontCellHeight. If you will render the font</span></div><div class="line"><a name="l02248"></a><span class="lineno"> 2248</span>&#160;<span class="comment"> at a different height from ON_Font::Constants::AnnotationFontCellHeight, then</span></div><div class="line"><a name="l02249"></a><span class="lineno"> 2249</span>&#160;<span class="comment"> use ON_TextBox::Scale as follows:</span></div><div class="line"><a name="l02250"></a><span class="lineno"> 2250</span>&#160;<span class="comment"> ON_TextBox scaled_box </span></div><div class="line"><a name="l02251"></a><span class="lineno"> 2251</span>&#160;<span class="comment"> = ON_TextBox::Scale(</span></div><div class="line"><a name="l02252"></a><span class="lineno"> 2252</span>&#160;<span class="comment"> text_box,</span></div><div class="line"><a name="l02253"></a><span class="lineno"> 2253</span>&#160;<span class="comment"> (font render height)/((double)ON_Font::Constants::AnnotationFontCellHeight)</span></div><div class="line"><a name="l02254"></a><span class="lineno"> 2254</span>&#160;<span class="comment"> );</span></div><div class="line"><a name="l02255"></a><span class="lineno"> 2255</span>&#160;<span class="comment"> Return:</span></div><div class="line"><a name="l02256"></a><span class="lineno"> 2256</span>&#160;<span class="comment"> number of lines of text or 0 if input is not valid or text is empty.</span></div><div class="line"><a name="l02257"></a><span class="lineno"> 2257</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02258"></a><span class="lineno"> 2258</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> GetGlyphListBoundingBox</div><div class="line"><a name="l02259"></a><span class="lineno"> 2259</span>&#160; (</div><div class="line"><a name="l02260"></a><span class="lineno"> 2260</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* text,</div><div class="line"><a name="l02261"></a><span class="lineno"> 2261</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l02262"></a><span class="lineno"> 2262</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; text_box</div><div class="line"><a name="l02263"></a><span class="lineno"> 2263</span>&#160; );</div><div class="line"><a name="l02264"></a><span class="lineno"> 2264</span>&#160;</div><div class="line"><a name="l02265"></a><span class="lineno"> 2265</span>&#160; <span class="keyword">static</span> <span class="keywordtype">int</span> GetGlyphListBoundingBox</div><div class="line"><a name="l02266"></a><span class="lineno"> 2266</span>&#160; (</div><div class="line"><a name="l02267"></a><span class="lineno"> 2267</span>&#160; <span class="keywordtype">size_t</span> code_point_count,</div><div class="line"><a name="l02268"></a><span class="lineno"> 2268</span>&#160; ON__UINT32* code_points,</div><div class="line"><a name="l02269"></a><span class="lineno"> 2269</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l02270"></a><span class="lineno"> 2270</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; text_box</div><div class="line"><a name="l02271"></a><span class="lineno"> 2271</span>&#160; );</div><div class="line"><a name="l02272"></a><span class="lineno"> 2272</span>&#160;</div><div class="line"><a name="l02273"></a><span class="lineno"> 2273</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02274"></a><span class="lineno"> 2274</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l02275"></a><span class="lineno"> 2275</span>&#160;<span class="comment"> Sets the font and code point and unsets every other property including the</span></div><div class="line"><a name="l02276"></a><span class="lineno"> 2276</span>&#160;<span class="comment"> glyph box and substitute information.</span></div><div class="line"><a name="l02277"></a><span class="lineno"> 2277</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l02278"></a><span class="lineno"> 2278</span>&#160;<span class="comment"> font - [in]</span></div><div class="line"><a name="l02279"></a><span class="lineno"> 2279</span>&#160;<span class="comment"> code_point - [in]</span></div><div class="line"><a name="l02280"></a><span class="lineno"> 2280</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02281"></a><span class="lineno"> 2281</span>&#160; <span class="keywordtype">bool</span> SetCodePoint(</div><div class="line"><a name="l02282"></a><span class="lineno"> 2282</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l02283"></a><span class="lineno"> 2283</span>&#160; ON__UINT32 code_point</div><div class="line"><a name="l02284"></a><span class="lineno"> 2284</span>&#160; );</div><div class="line"><a name="l02285"></a><span class="lineno"> 2285</span>&#160;</div><div class="line"><a name="l02286"></a><span class="lineno"> 2286</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02287"></a><span class="lineno"> 2287</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02288"></a><span class="lineno"> 2288</span>&#160;<span class="comment"> True if the unicode code point and font are set</span></div><div class="line"><a name="l02289"></a><span class="lineno"> 2289</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02290"></a><span class="lineno"> 2290</span>&#160; <span class="keywordtype">bool</span> CodePointIsSet() <span class="keyword">const</span>;</div><div class="line"><a name="l02291"></a><span class="lineno"> 2291</span>&#160;</div><div class="line"><a name="l02292"></a><span class="lineno"> 2292</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02293"></a><span class="lineno"> 2293</span>&#160;<span class="comment"> Returns: </span></div><div class="line"><a name="l02294"></a><span class="lineno"> 2294</span>&#160;<span class="comment"> true if this is a managed instance.</span></div><div class="line"><a name="l02295"></a><span class="lineno"> 2295</span>&#160;<span class="comment"> Managed instances persist for the lifetime of the application</span></div><div class="line"><a name="l02296"></a><span class="lineno"> 2296</span>&#160;<span class="comment"> and the pointer can be safely saved and referenced at any time.</span></div><div class="line"><a name="l02297"></a><span class="lineno"> 2297</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02298"></a><span class="lineno"> 2298</span>&#160; <span class="keywordtype">bool</span> IsManaged() <span class="keyword">const</span>;</div><div class="line"><a name="l02299"></a><span class="lineno"> 2299</span>&#160;</div><div class="line"><a name="l02300"></a><span class="lineno"> 2300</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02301"></a><span class="lineno"> 2301</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02302"></a><span class="lineno"> 2302</span>&#160;<span class="comment"> If this-&gt;CodePointIsSet() is true, then a persistent pointer</span></div><div class="line"><a name="l02303"></a><span class="lineno"> 2303</span>&#160;<span class="comment"> to a managed glyph with the same code point and font is returned.</span></div><div class="line"><a name="l02304"></a><span class="lineno"> 2304</span>&#160;<span class="comment"> Otherwise nullptr is returned.</span></div><div class="line"><a name="l02305"></a><span class="lineno"> 2305</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02306"></a><span class="lineno"> 2306</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>* ManagedGlyph() <span class="keyword">const</span>;</div><div class="line"><a name="l02307"></a><span class="lineno"> 2307</span>&#160;</div><div class="line"><a name="l02308"></a><span class="lineno"> 2308</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02309"></a><span class="lineno"> 2309</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l02310"></a><span class="lineno"> 2310</span>&#160;<span class="comment"> bUseReplacementCharacter - [in]</span></div><div class="line"><a name="l02311"></a><span class="lineno"> 2311</span>&#160;<span class="comment"> When this-&gt;CodePointIsSet() is true, </span></div><div class="line"><a name="l02312"></a><span class="lineno"> 2312</span>&#160;<span class="comment"> and bUseReplacementCharacter is true,</span></div><div class="line"><a name="l02313"></a><span class="lineno"> 2313</span>&#160;<span class="comment"> and no reasonable glyph definition exists,</span></div><div class="line"><a name="l02314"></a><span class="lineno"> 2314</span>&#160;<span class="comment"> and no substitued is available, </span></div><div class="line"><a name="l02315"></a><span class="lineno"> 2315</span>&#160;<span class="comment"> then the replacement character glyph for UNICODE code point</span></div><div class="line"><a name="l02316"></a><span class="lineno"> 2316</span>&#160;<span class="comment"> ON_UnicodeCodePoint::ON_ReplacementCharacter (U+FFFD) will be returned.</span></div><div class="line"><a name="l02317"></a><span class="lineno"> 2317</span>&#160;<span class="comment"></span></div><div class="line"><a name="l02318"></a><span class="lineno"> 2318</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02319"></a><span class="lineno"> 2319</span>&#160;<span class="comment"> A managed glyph that can be used to render &quot;this&quot;.</span></div><div class="line"><a name="l02320"></a><span class="lineno"> 2320</span>&#160;<span class="comment"> If this-&gt;CodePointIsSet() is false, nullptr is returned.</span></div><div class="line"><a name="l02321"></a><span class="lineno"> 2321</span>&#160;<span class="comment"> If this-&gt;CodePointIsSet() is true, the returned glyph may</span></div><div class="line"><a name="l02322"></a><span class="lineno"> 2322</span>&#160;<span class="comment"> have a different font and code point when the current </span></div><div class="line"><a name="l02323"></a><span class="lineno"> 2323</span>&#160;<span class="comment"> computer requires font or glyph substitution to draw</span></div><div class="line"><a name="l02324"></a><span class="lineno"> 2324</span>&#160;<span class="comment"> the glyph. When the current platform cannot render this,</span></div><div class="line"><a name="l02325"></a><span class="lineno"> 2325</span>&#160;<span class="comment"> nullptr or the replacement glyph is returned depending on</span></div><div class="line"><a name="l02326"></a><span class="lineno"> 2326</span>&#160;<span class="comment"> the value of bUseReplacementCharacter.</span></div><div class="line"><a name="l02327"></a><span class="lineno"> 2327</span>&#160;<span class="comment"></span></div><div class="line"><a name="l02328"></a><span class="lineno"> 2328</span>&#160;<span class="comment"> See Also:</span></div><div class="line"><a name="l02329"></a><span class="lineno"> 2329</span>&#160;<span class="comment"> ON_FontGlyph.SubstituteGlyph().</span></div><div class="line"><a name="l02330"></a><span class="lineno"> 2330</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02331"></a><span class="lineno"> 2331</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>* RenderGlyph(</div><div class="line"><a name="l02332"></a><span class="lineno"> 2332</span>&#160; <span class="keywordtype">bool</span> bUseReplacementCharacter</div><div class="line"><a name="l02333"></a><span class="lineno"> 2333</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l02334"></a><span class="lineno"> 2334</span>&#160;</div><div class="line"><a name="l02335"></a><span class="lineno"> 2335</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02336"></a><span class="lineno"> 2336</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02337"></a><span class="lineno"> 2337</span>&#160;<span class="comment"> If this is a managed glyph or a copy of a managed glyph, </span></div><div class="line"><a name="l02338"></a><span class="lineno"> 2338</span>&#160;<span class="comment"> and a substitute font or code point is used to render the glyph, </span></div><div class="line"><a name="l02339"></a><span class="lineno"> 2339</span>&#160;<span class="comment"> then the substitue is returned.</span></div><div class="line"><a name="l02340"></a><span class="lineno"> 2340</span>&#160;<span class="comment"> In all other cases, nullptr is returned.</span></div><div class="line"><a name="l02341"></a><span class="lineno"> 2341</span>&#160;<span class="comment"> See Also:</span></div><div class="line"><a name="l02342"></a><span class="lineno"> 2342</span>&#160;<span class="comment"> ON_FontGlyph.RenderGlyph().</span></div><div class="line"><a name="l02343"></a><span class="lineno"> 2343</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02344"></a><span class="lineno"> 2344</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>* SubstituteGlyph() <span class="keyword">const</span>;</div><div class="line"><a name="l02345"></a><span class="lineno"> 2345</span>&#160;</div><div class="line"><a name="l02346"></a><span class="lineno"> 2346</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02347"></a><span class="lineno"> 2347</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l02348"></a><span class="lineno"> 2348</span>&#160;<span class="comment"> bIncludeCharMaps - [in]</span></div><div class="line"><a name="l02349"></a><span class="lineno"> 2349</span>&#160;<span class="comment"> If true, then char information is printed.</span></div><div class="line"><a name="l02350"></a><span class="lineno"> 2350</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02351"></a><span class="lineno"> 2351</span>&#160; <span class="keywordtype">void</span> Dump(</div><div class="line"><a name="l02352"></a><span class="lineno"> 2352</span>&#160; <span class="keywordtype">bool</span> bIncludeCharMaps,</div><div class="line"><a name="l02353"></a><span class="lineno"> 2353</span>&#160; <a class="code" href="../../d2/da3/class_o_n___text_log.html">ON_TextLog</a>&amp; text_log</div><div class="line"><a name="l02354"></a><span class="lineno"> 2354</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l02355"></a><span class="lineno"> 2355</span>&#160;</div><div class="line"><a name="l02356"></a><span class="lineno"> 2356</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02357"></a><span class="lineno"> 2357</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l02358"></a><span class="lineno"> 2358</span>&#160;<span class="comment"> This is a debugging tool to test the code that starts with a font and </span></div><div class="line"><a name="l02359"></a><span class="lineno"> 2359</span>&#160;<span class="comment"> Unicode code point and and finds a glyph in the font definition for </span></div><div class="line"><a name="l02360"></a><span class="lineno"> 2360</span>&#160;<span class="comment"> that code point.</span></div><div class="line"><a name="l02361"></a><span class="lineno"> 2361</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l02362"></a><span class="lineno"> 2362</span>&#160;<span class="comment"> text_log - [in]</span></div><div class="line"><a name="l02363"></a><span class="lineno"> 2363</span>&#160;<span class="comment"> If text_log is not nullptr, then diagnostic messages are sent to this log.</span></div><div class="line"><a name="l02364"></a><span class="lineno"> 2364</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02365"></a><span class="lineno"> 2365</span>&#160;<span class="comment"> True: </span></div><div class="line"><a name="l02366"></a><span class="lineno"> 2366</span>&#160;<span class="comment"> No errors were found. Every available charmap either returned the same glyph id</span></div><div class="line"><a name="l02367"></a><span class="lineno"> 2367</span>&#160;<span class="comment"> that FontGlyphId() function returns or had no glyph id for this code point.</span></div><div class="line"><a name="l02368"></a><span class="lineno"> 2368</span>&#160;<span class="comment"> False:</span></div><div class="line"><a name="l02369"></a><span class="lineno"> 2369</span>&#160;<span class="comment"> Inconsistent results were returned from different charmaps.</span></div><div class="line"><a name="l02370"></a><span class="lineno"> 2370</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l02371"></a><span class="lineno"> 2371</span>&#160;<span class="comment"> If a font or charmap is known to contain a bug and that bug is</span></div><div class="line"><a name="l02372"></a><span class="lineno"> 2372</span>&#160;<span class="comment"> handled by opennurbs, then true is returned and a message is printed</span></div><div class="line"><a name="l02373"></a><span class="lineno"> 2373</span>&#160;<span class="comment"> to the log.</span></div><div class="line"><a name="l02374"></a><span class="lineno"> 2374</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02375"></a><span class="lineno"> 2375</span>&#160; <span class="keywordtype">bool</span> TestFaceCharMaps(</div><div class="line"><a name="l02376"></a><span class="lineno"> 2376</span>&#160; <a class="code" href="../../d2/da3/class_o_n___text_log.html">ON_TextLog</a>* text_log</div><div class="line"><a name="l02377"></a><span class="lineno"> 2377</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l02378"></a><span class="lineno"> 2378</span>&#160;</div><div class="line"><a name="l02379"></a><span class="lineno"> 2379</span>&#160;<span class="keyword">public</span>:</div><div class="line"><a name="l02380"></a><span class="lineno"> 2380</span>&#160;</div><div class="line"><a name="l02381"></a><span class="lineno"> 2381</span>&#160; <span class="keyword">const</span> ON__UINT_PTR FreeTypeFace() <span class="keyword">const</span>;</div><div class="line"><a name="l02382"></a><span class="lineno"> 2382</span>&#160;</div><div class="line"><a name="l02383"></a><span class="lineno"> 2383</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02384"></a><span class="lineno"> 2384</span>&#160;<span class="comment"> Returns:</span></div><div class="line"><a name="l02385"></a><span class="lineno"> 2385</span>&#160;<span class="comment"> Font glyph id.</span></div><div class="line"><a name="l02386"></a><span class="lineno"> 2386</span>&#160;<span class="comment"> Remarks:</span></div><div class="line"><a name="l02387"></a><span class="lineno"> 2387</span>&#160;<span class="comment"> The glyph id depends on the font and is assigned by the font designer.</span></div><div class="line"><a name="l02388"></a><span class="lineno"><a class="line" href="../../d7/d29/class_o_n___font_glyph.html#a2452018fd47700a6ea2e12bdf20431e5"> 2388</a></span>&#160;<span class="comment"> In particular the font glyph id for the same Unicode code point</span></div><div class="line"><a name="l02389"></a><span class="lineno"><a class="line" href="../../d7/d29/class_o_n___font_glyph.html#a003e28c4b7e4c4ced7fbe3fa422074ec"> 2389</a></span>&#160;<span class="comment"> often varies from font to font. In a font, it is often the case that</span></div><div class="line"><a name="l02390"></a><span class="lineno"> 2390</span>&#160;<span class="comment"> multiple Unicode code points map to the same glyph. For example,</span></div><div class="line"><a name="l02391"></a><span class="lineno"> 2391</span>&#160;<span class="comment"> space an non-breaking space typically map to the same font glyph id.</span></div><div class="line"><a name="l02392"></a><span class="lineno"> 2392</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02393"></a><span class="lineno"> 2393</span>&#160; <span class="keyword">const</span> ON__UINT_PTR FontGlyphId() <span class="keyword">const</span>;</div><div class="line"><a name="l02394"></a><span class="lineno"> 2394</span>&#160;</div><div class="line"><a name="l02395"></a><span class="lineno"> 2395</span>&#160; <span class="comment">/*</span></div><div class="line"><a name="l02396"></a><span class="lineno"> 2396</span>&#160;<span class="comment"> Description:</span></div><div class="line"><a name="l02397"></a><span class="lineno"> 2397</span>&#160;<span class="comment"> Get glyph contours as NURBS curves.</span></div><div class="line"><a name="l02398"></a><span class="lineno"> 2398</span>&#160;<span class="comment"> Parameters:</span></div><div class="line"><a name="l02399"></a><span class="lineno"> 2399</span>&#160;<span class="comment"> bSingleStrokeFont - [in]</span></div><div class="line"><a name="l02400"></a><span class="lineno"> 2400</span>&#160;<span class="comment"> If true, open contours will not be closed by adding a line segment.</span></div><div class="line"><a name="l02401"></a><span class="lineno"> 2401</span>&#160;<span class="comment"> text_height - [in]</span></div><div class="line"><a name="l02402"></a><span class="lineno"> 2402</span>&#160;<span class="comment"> If &gt; 0, ouptut curves, bounding box, and advance vector are scaled </span></div><div class="line"><a name="l02403"></a><span class="lineno"> 2403</span>&#160;<span class="comment"> so that a capital latin letter I would have a height of text_height.</span></div><div class="line"><a name="l02404"></a><span class="lineno"> 2404</span>&#160;<span class="comment"> Otherwise, no scaling is applied to the output curves, bounding box,</span></div><div class="line"><a name="l02405"></a><span class="lineno"> 2405</span>&#160;<span class="comment"> and advance vector.</span></div><div class="line"><a name="l02406"></a><span class="lineno"> 2406</span>&#160;<span class="comment"> Pass 0.0 or in this-&gt;Font()-&gt;HeightOfI() to get the contours to be in opennurbs</span></div><div class="line"><a name="l02407"></a><span class="lineno"> 2407</span>&#160;<span class="comment"> normalized font coordinates.</span></div><div class="line"><a name="l02408"></a><span class="lineno"> 2408</span>&#160;<span class="comment"> Pass ON_UNSET_VALUE to get the contours to be in native font definition units.</span></div><div class="line"><a name="l02409"></a><span class="lineno"> 2409</span>&#160;<span class="comment"> All other values &lt; 0 are treated as 0.0.</span></div><div class="line"><a name="l02410"></a><span class="lineno"> 2410</span>&#160;<span class="comment"> glyph_contours - [out]</span></div><div class="line"><a name="l02411"></a><span class="lineno"> 2411</span>&#160;<span class="comment"> glyph_bbox - [out]</span></div><div class="line"><a name="l02412"></a><span class="lineno"> 2412</span>&#160;<span class="comment"> glyph bounding box.</span></div><div class="line"><a name="l02413"></a><span class="lineno"> 2413</span>&#160;<span class="comment"> glyph_advance - [out]</span></div><div class="line"><a name="l02414"></a><span class="lineno"> 2414</span>&#160;<span class="comment"> glyph_advance-&gt;x = horizontal advance to apply when rendering glyphs horizontally.</span></div><div class="line"><a name="l02415"></a><span class="lineno"> 2415</span>&#160;<span class="comment"> A positive horizontal advance indicates advance to the right.</span></div><div class="line"><a name="l02416"></a><span class="lineno"> 2416</span>&#160;<span class="comment"> glyph_advance-&gt;y = vertical advance to apply when rendering glyphs vertically.</span></div><div class="line"><a name="l02417"></a><span class="lineno"> 2417</span>&#160;<span class="comment"> A positive vertical advance indicates advance downwards.</span></div><div class="line"><a name="l02418"></a><span class="lineno"> 2418</span>&#160;<span class="comment"> */</span></div><div class="line"><a name="l02419"></a><span class="lineno"> 2419</span>&#160; <span class="keywordtype">bool</span> GetGlyphContours(</div><div class="line"><a name="l02420"></a><span class="lineno"> 2420</span>&#160; <span class="keywordtype">bool</span> bSingleStrokeFont,</div><div class="line"><a name="l02421"></a><span class="lineno"> 2421</span>&#160; <span class="keywordtype">double</span> text_height,</div><div class="line"><a name="l02422"></a><span class="lineno"> 2422</span>&#160; <a class="code" href="../../dd/d40/class_o_n___class_array.html">ON_ClassArray</a>&lt; <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt; ON_Curve* &gt;</a> &gt;&amp; glyph_contours,</div><div class="line"><a name="l02423"></a><span class="lineno"> 2423</span>&#160; <a class="code" href="../../d1/d17/class_o_n___bounding_box.html">ON_BoundingBox</a>* glyph_bbox,</div><div class="line"><a name="l02424"></a><span class="lineno"> 2424</span>&#160; <a class="code" href="../../d5/dae/class_o_n__3d_vector.html">ON_3dVector</a>* glyph_advance</div><div class="line"><a name="l02425"></a><span class="lineno"> 2425</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l02426"></a><span class="lineno"> 2426</span>&#160;</div><div class="line"><a name="l02427"></a><span class="lineno"> 2427</span>&#160; <span class="keyword">static</span> <span class="keywordtype">bool</span> GetStringContours(</div><div class="line"><a name="l02428"></a><span class="lineno"> 2428</span>&#160; <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* text_string,</div><div class="line"><a name="l02429"></a><span class="lineno"> 2429</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l02430"></a><span class="lineno"> 2430</span>&#160; <span class="keywordtype">bool</span> bSingleStrokeFont,</div><div class="line"><a name="l02431"></a><span class="lineno"> 2431</span>&#160; <span class="keywordtype">double</span> text_height,</div><div class="line"><a name="l02432"></a><span class="lineno"> 2432</span>&#160; <span class="keywordtype">double</span> small_caps_scale,</div><div class="line"><a name="l02433"></a><span class="lineno"> 2433</span>&#160; <a class="code" href="../../dd/d40/class_o_n___class_array.html">ON_ClassArray</a>&lt; <a class="code" href="../../dd/d40/class_o_n___class_array.html">ON_ClassArray</a>&lt; <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt; ON_Curve* &gt;</a> &gt; &gt;&amp; string_contours</div><div class="line"><a name="l02434"></a><span class="lineno"> 2434</span>&#160; );</div><div class="line"><a name="l02435"></a><span class="lineno"> 2435</span>&#160;</div><div class="line"><a name="l02436"></a><span class="lineno"> 2436</span>&#160;</div><div class="line"><a name="l02437"></a><span class="lineno"> 2437</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l02438"></a><span class="lineno"> 2438</span>&#160; <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="../../d3/df5/class_o_n___glyph_map.html">ON_GlyphMap</a>;</div><div class="line"><a name="l02439"></a><span class="lineno"> 2439</span>&#160; <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>;</div><div class="line"><a name="l02440"></a><span class="lineno"> 2440</span>&#160; </div><div class="line"><a name="l02441"></a><span class="lineno"> 2441</span>&#160; <span class="comment">// NOTE WELL: </span></div><div class="line"><a name="l02442"></a><span class="lineno"> 2442</span>&#160; <span class="comment">// The offset of m_codepoint in ON_FontGlyph must be &gt;= 8 bytes.</span></div><div class="line"><a name="l02443"></a><span class="lineno"> 2443</span>&#160; <span class="comment">// so the ON_FixeSizePool that manages memory for the glyph cache</span></div><div class="line"><a name="l02444"></a><span class="lineno"> 2444</span>&#160; <span class="comment">// can efficiently iteratate all active managed glyphs.</span></div><div class="line"><a name="l02445"></a><span class="lineno"> 2445</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l02446"></a><span class="lineno"> 2446</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a> m_font_unit_glyph_bbox; <span class="comment">// values in the native font definition units (freetype FT_LOAD_NO_SCALE units)</span></div><div class="line"><a name="l02447"></a><span class="lineno"> 2447</span>&#160; <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a> m_normalized_glyph_bbox; <span class="comment">// bounding box in opennurbs normalized font coordinates</span></div><div class="line"><a name="l02448"></a><span class="lineno"> 2448</span>&#160;</div><div class="line"><a name="l02449"></a><span class="lineno"> 2449</span>&#160; <span class="comment">// This box is for the platform native glyph. It can be different than m_glyph_box.</span></div><div class="line"><a name="l02450"></a><span class="lineno"> 2450</span>&#160; <span class="comment">// Example:</span></div><div class="line"><a name="l02451"></a><span class="lineno"> 2451</span>&#160; <span class="comment">// Start with a Windows LOGFONT with face = Arial, height = ON_Font::Constants::AnnotationFontCellHeight (256)</span></div><div class="line"><a name="l02452"></a><span class="lineno"> 2452</span>&#160; <span class="comment">// Native Windows height of Arial I = 165, height of LF = ...</span></div><div class="line"><a name="l02453"></a><span class="lineno"> 2453</span>&#160; <span class="comment">// FreeType made from the same LOGFONT on the same has height of Arial I = 184, height of LF = ...</span></div><div class="line"><a name="l02454"></a><span class="lineno"> 2454</span>&#160;</div><div class="line"><a name="l02455"></a><span class="lineno"> 2455</span>&#160; <span class="comment">// When font does not contain a glyph to render a specified unicode codepoint,</span></div><div class="line"><a name="l02456"></a><span class="lineno"> 2456</span>&#160; <span class="comment">// then one or more glyphs from one or more subsitution fonts are used to</span></div><div class="line"><a name="l02457"></a><span class="lineno"> 2457</span>&#160; <span class="comment">// render the codepoint. In this case, m_substitutes points to a linked</span></div><div class="line"><a name="l02458"></a><span class="lineno"> 2458</span>&#160; <span class="comment">// list of substitute used to render the glyph.</span></div><div class="line"><a name="l02459"></a><span class="lineno"> 2459</span>&#160; <span class="comment">//</span></div><div class="line"><a name="l02460"></a><span class="lineno"> 2460</span>&#160; ON__UINT32 m_code_point = ON_UnicodeCodePoint::ON_InvalidCodePoint;</div><div class="line"><a name="l02461"></a><span class="lineno"> 2461</span>&#160; </div><div class="line"><a name="l02462"></a><span class="lineno"> 2462</span>&#160; ON__UINT8 m_is_managed = 0; <span class="comment">// 1 = managed glyph</span></div><div class="line"><a name="l02463"></a><span class="lineno"> 2463</span>&#160; ON__UINT8 m_reserved1 = 0;</div><div class="line"><a name="l02464"></a><span class="lineno"> 2464</span>&#160; ON__UINT16 m_reserved2 = 0;</div><div class="line"><a name="l02465"></a><span class="lineno"> 2465</span>&#160; ON__UINT_PTR m_font_glyph_id = 0;</div><div class="line"><a name="l02466"></a><span class="lineno"> 2466</span>&#160; <span class="keyword">const</span> <span class="keyword">class </span><a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* m_managed_font = <span class="keyword">nullptr</span>;</div><div class="line"><a name="l02467"></a><span class="lineno"> 2467</span>&#160; <span class="keyword">const</span> <span class="keyword">class </span><a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>* m_substitute = <span class="keyword">nullptr</span>;</div><div class="line"><a name="l02468"></a><span class="lineno"> 2468</span>&#160;</div><div class="line"><a name="l02469"></a><span class="lineno"> 2469</span>&#160;</div><div class="line"><a name="l02470"></a><span class="lineno"> 2470</span>&#160;<span class="keyword">private</span>:</div><div class="line"><a name="l02471"></a><span class="lineno"> 2471</span>&#160; <span class="keywordtype">void</span> Internal_SetFontGlyphId(ON__UINT_PTR font_glyph_id);</div><div class="line"><a name="l02472"></a><span class="lineno"> 2472</span>&#160; <span class="keywordtype">void</span> Internal_CopyFrom(<span class="keyword">const</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>&amp; src);</div><div class="line"><a name="l02473"></a><span class="lineno"> 2473</span>&#160; <span class="keyword">static</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>* Internal_AllocateManagedGlyph(<span class="keyword">const</span> <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>&amp; src);</div><div class="line"><a name="l02474"></a><span class="lineno"> 2474</span>&#160; <span class="keywordtype">bool</span> Internal_GetPlatformSubstitute(</div><div class="line"><a name="l02475"></a><span class="lineno"> 2475</span>&#160; <a class="code" href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a>&amp; substitue</div><div class="line"><a name="l02476"></a><span class="lineno"> 2476</span>&#160; ) <span class="keyword">const</span>;</div><div class="line"><a name="l02477"></a><span class="lineno"> 2477</span>&#160;};</div><div class="line"><a name="l02478"></a><span class="lineno"> 2478</span>&#160;</div><div class="line"><a name="l02479"></a><span class="lineno"> 2479</span>&#160;</div><div class="line"><a name="l02480"></a><span class="lineno"> 2480</span>&#160;<span class="preprocessor">#if defined(ON_RUNTIME_WIN)</span></div><div class="line"><a name="l02481"></a><span class="lineno"> 2481</span>&#160;</div><div class="line"><a name="l02482"></a><span class="lineno"> 2482</span>&#160;<span class="comment">/*</span></div><div class="line"><a name="l02483"></a><span class="lineno"> 2483</span>&#160;<span class="comment">Remarks:</span></div><div class="line"><a name="l02484"></a><span class="lineno"> 2484</span>&#160;<span class="comment"> Windows GDI functions used by ON_WindowsMeasureGlyph fail when the</span></div><div class="line"><a name="l02485"></a><span class="lineno"> 2485</span>&#160;<span class="comment"> UTF-16 encoding of unicode_code_point requires a surrogate pair.</span></div><div class="line"><a name="l02486"></a><span class="lineno"> 2486</span>&#160;<span class="comment">*/</span></div><div class="line"><a name="l02487"></a><span class="lineno"> 2487</span>&#160;ON_DECL</div><div class="line"><a name="l02488"></a><span class="lineno"> 2488</span>&#160;<span class="keywordtype">bool</span> ON_WindowsGetGlyphMetrics(</div><div class="line"><a name="l02489"></a><span class="lineno"> 2489</span>&#160; <span class="keyword">const</span> <a class="code" href="../../d8/df5/class_o_n___font.html">ON_Font</a>* font,</div><div class="line"><a name="l02490"></a><span class="lineno"> 2490</span>&#160; ON__UINT32 unicode_code_point,</div><div class="line"><a name="l02491"></a><span class="lineno"> 2491</span>&#160; <span class="keyword">class</span> <a class="code" href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a>&amp; font_unit_glyph_box</div><div class="line"><a name="l02492"></a><span class="lineno"> 2492</span>&#160;);</div><div class="line"><a name="l02493"></a><span class="lineno"> 2493</span>&#160;</div><div class="line"><a name="l02494"></a><span class="lineno"> 2494</span>&#160;</div><div class="line"><a name="l02495"></a><span class="lineno"> 2495</span>&#160;</div><div class="line"><a name="l02496"></a><span class="lineno"> 2496</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l02497"></a><span class="lineno"> 2497</span>&#160;</div><div class="line"><a name="l02498"></a><span class="lineno"> 2498</span>&#160;</div><div class="line"><a name="l02499"></a><span class="lineno"> 2499</span>&#160;<span class="preprocessor">#if defined(ON_DLL_TEMPLATE)</span></div><div class="line"><a name="l02500"></a><span class="lineno"> 2500</span>&#160;ON_DLL_TEMPLATE <span class="keyword">template</span> <span class="keyword">class </span>ON_CLASS <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt;ON_Font*&gt;</a>;</div><div class="line"><a name="l02501"></a><span class="lineno"> 2501</span>&#160;ON_DLL_TEMPLATE <span class="keyword">template</span> <span class="keyword">class </span>ON_CLASS <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt;const ON_Font*&gt;</a>;</div><div class="line"><a name="l02502"></a><span class="lineno"> 2502</span>&#160;ON_DLL_TEMPLATE <span class="keyword">template</span> <span class="keyword">class </span>ON_CLASS <a class="code" href="../../dd/d40/class_o_n___class_array.html">ON_ClassArray&lt;ON_Font&gt;</a>;</div><div class="line"><a name="l02503"></a><span class="lineno"> 2503</span>&#160;ON_DLL_TEMPLATE <span class="keyword">template</span> <span class="keyword">class </span>ON_CLASS <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt;ON_FontGlyph*&gt;</a>;</div><div class="line"><a name="l02504"></a><span class="lineno"> 2504</span>&#160;ON_DLL_TEMPLATE <span class="keyword">template</span> <span class="keyword">class </span>ON_CLASS <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt;const ON_FontGlyph*&gt;</a>;</div><div class="line"><a name="l02505"></a><span class="lineno"> 2505</span>&#160;ON_DLL_TEMPLATE <span class="keyword">template</span> <span class="keyword">class </span>ON_CLASS <a class="code" href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray&lt;ON_FontGlyph&gt;</a>;</div><div class="line"><a name="l02506"></a><span class="lineno"> 2506</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l02507"></a><span class="lineno"> 2507</span>&#160;</div><div class="line"><a name="l02508"></a><span class="lineno"> 2508</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l02509"></a><span class="lineno"> 2509</span>&#160;</div><div class="line"><a name="l02510"></a><span class="lineno"> 2510</span>&#160;</div><div class="ttc" id="class_o_n___font_html_ab55ead78e0fc5501a58ba69cc1f5d023"><div class="ttname"><a href="../../d8/df5/class_o_n___font.html#ab55ead78e0fc5501a58ba69cc1f5d023">ON_Font::Constants</a></div><div class="ttdeci">Constants</div><div class="ttdoc">miscellaneous constants use to initialize Windows LOGFONT fields </div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:1423</div></div>
<div class="ttc" id="class_o_n___font_glyph_html_a003e28c4b7e4c4ced7fbe3fa422074ec"><div class="ttname"><a href="../../d7/d29/class_o_n___font_glyph.html#a003e28c4b7e4c4ced7fbe3fa422074ec">ON_FontGlyph::ON_Font</a></div><div class="ttdeci">friend class ON_Font</div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:2389</div></div>
<div class="ttc" id="class_o_n__2i_point_html"><div class="ttname"><a href="../../de/dd6/class_o_n__2i_point.html">ON_2iPoint</a></div><div class="ttdef"><b>Definition:</b> opennurbs_ipoint.h:24</div></div>
<div class="ttc" id="struct_o_n___u_u_i_d__struct_html"><div class="ttname"><a href="../../d8/db4/struct_o_n___u_u_i_d__struct.html">ON_UUID_struct</a></div><div class="ttdoc">ON_UUID is a 16 byte universally unique identifier. </div><div class="ttdef"><b>Definition:</b> opennurbs_uuid.h:32</div></div>
<div class="ttc" id="class_o_n___font_html_a00ce657702926f66bcbc70a7209d757d"><div class="ttname"><a href="../../d8/df5/class_o_n___font.html#a00ce657702926f66bcbc70a7209d757d">ON_Font::Weight</a></div><div class="ttdeci">Weight</div><div class="ttdoc">Weight enum values Avoid casting these values to int. Use ON_Font::WindowsLogfontWeightFromWeight() o...</div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:237</div></div>
<div class="ttc" id="class_o_n___text_box_html"><div class="ttname"><a href="../../dc/dec/class_o_n___text_box.html">ON_TextBox</a></div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:1958</div></div>
<div class="ttc" id="class_o_n___font_html_a0fe463dc04930a703fd3d6c696285d38"><div class="ttname"><a href="../../d8/df5/class_o_n___font.html#a0fe463dc04930a703fd3d6c696285d38">ON_Font::WindowsConstants</a></div><div class="ttdeci">WindowsConstants</div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:1379</div></div>
<div class="ttc" id="class_o_n__2i_point_html_a21721819ea51e0fae5b56aed251184bd"><div class="ttname"><a href="../../de/dd6/class_o_n__2i_point.html#a21721819ea51e0fae5b56aed251184bd">ON_2iPoint::Unset</a></div><div class="ttdeci">static const ON_2iPoint Unset</div><div class="ttdef"><b>Definition:</b> opennurbs_ipoint.h:46</div></div>
<div class="ttc" id="class_o_n___simple_array_html"><div class="ttname"><a href="../../dc/dfe/class_o_n___simple_array.html">ON_SimpleArray</a></div><div class="ttdef"><b>Definition:</b> opennurbs_array.h:36</div></div>
<div class="ttc" id="class_o_n___font_html_a260244d29871bd942706652123d0e2f1"><div class="ttname"><a href="../../d8/df5/class_o_n___font.html#a260244d29871bd942706652123d0e2f1">ON_Font::Stretch</a></div><div class="ttdeci">Stretch</div><div class="ttdoc">Horizontal expansion or contraction of font </div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:422</div></div>
<div class="ttc" id="class_o_n___font_metrics_html_a09a14df60aa3a72ffa0580f2dc86fac1"><div class="ttname"><a href="../../dd/d29/class_o_n___font_metrics.html#a09a14df60aa3a72ffa0580f2dc86fac1">ON_FontMetrics::HeightOfCapitalCodePoint</a></div><div class="ttdeci">static const ON__UINT32 HeightOfCapitalCodePoint</div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:44</div></div>
<div class="ttc" id="class_o_n___s_h_a1___hash_html"><div class="ttname"><a href="../../dd/ddf/class_o_n___s_h_a1___hash.html">ON_SHA1_Hash</a></div><div class="ttdef"><b>Definition:</b> opennurbs_sha1.h:19</div></div>
<div class="ttc" id="class_o_n___font_glyph_html_a940ce31d13be5e4f3fe2ec87ed2db238"><div class="ttname"><a href="../../d7/d29/class_o_n___font_glyph.html#a940ce31d13be5e4f3fe2ec87ed2db238">ON_FontGlyph::operator=</a></div><div class="ttdeci">ON_FontGlyph &amp; operator=(const ON_FontGlyph &amp;src)</div></div>
<div class="ttc" id="class_o_n___managed_fonts_html"><div class="ttname"><a href="../../d9/dd8/class_o_n___managed_fonts.html">ON_ManagedFonts</a></div><div class="ttdef"><b>Definition:</b> opennurbs_internal_glyph.h:30</div></div>
<div class="ttc" id="class_o_n__w_string_html"><div class="ttname"><a href="../../d1/d11/class_o_n__w_string.html">ON_wString</a></div><div class="ttdef"><b>Definition:</b> opennurbs_string.h:2020</div></div>
<div class="ttc" id="class_o_n___font_glyph_html_afa54bf369e6920c9e663a04798cdbc8f"><div class="ttname"><a href="../../d7/d29/class_o_n___font_glyph.html#afa54bf369e6920c9e663a04798cdbc8f">ON_FontGlyph::FreeTypeFace</a></div><div class="ttdeci">const ON__UINT_PTR FreeTypeFace() const</div></div>
<div class="ttc" id="class_o_n__2d_point_html"><div class="ttname"><a href="../../dd/dd9/class_o_n__2d_point.html">ON_2dPoint</a></div><div class="ttdef"><b>Definition:</b> opennurbs_point.h:277</div></div>
<div class="ttc" id="class_o_n___font_metrics_html_abe44d95515dabcce5ed56759c7ab770f"><div class="ttname"><a href="../../dd/d29/class_o_n___font_metrics.html#abe44d95515dabcce5ed56759c7ab770f">ON_FontMetrics::DefaultLineFeedRatio</a></div><div class="ttdeci">static const double DefaultLineFeedRatio</div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:37</div></div>
<div class="ttc" id="class_o_n___font_glyph_html"><div class="ttname"><a href="../../d7/d29/class_o_n___font_glyph.html">ON_FontGlyph</a></div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:2081</div></div>
<div class="ttc" id="class_o_n___font_metrics_html"><div class="ttname"><a href="../../dd/d29/class_o_n___font_metrics.html">ON_FontMetrics</a></div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:18</div></div>
<div class="ttc" id="class_o_n___bounding_box_html"><div class="ttname"><a href="../../d1/d17/class_o_n___bounding_box.html">ON_BoundingBox</a></div><div class="ttdef"><b>Definition:</b> opennurbs_bounding_box.h:25</div></div>
<div class="ttc" id="class_o_n___font_glyph_outline_point_html"><div class="ttname"><a href="../../da/d62/class_o_n___font_glyph_outline_point.html">ON_FontGlyphOutlinePoint</a></div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:2039</div></div>
<div class="ttc" id="class_o_n___glyph_map_html"><div class="ttname"><a href="../../d3/df5/class_o_n___glyph_map.html">ON_GlyphMap</a></div><div class="ttdef"><b>Definition:</b> opennurbs_internal_glyph.h:84</div></div>
<div class="ttc" id="class_o_n___font_html"><div class="ttname"><a href="../../d8/df5/class_o_n___font.html">ON_Font</a></div><div class="ttdoc">An ON_Font is a face in a font family. It corresponds to a Windows LOGFONT, a .NET System...</div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:225</div></div>
<div class="ttc" id="class_o_n___font_glyph_html_aa1be2ecdf7d6e8b505f858701731ea90"><div class="ttname"><a href="../../d7/d29/class_o_n___font_glyph.html#aa1be2ecdf7d6e8b505f858701731ea90">ON_FontGlyph::Dump</a></div><div class="ttdeci">void Dump(bool bIncludeCharMaps, ON_TextLog &amp;text_log) const</div></div>
<div class="ttc" id="class_o_n___font_metrics_html_a9f0b2b89127afdb35f994e648d816884"><div class="ttname"><a href="../../dd/d29/class_o_n___font_metrics.html#a9f0b2b89127afdb35f994e648d816884">ON_FontMetrics::Unset</a></div><div class="ttdeci">static const ON_FontMetrics Unset</div><div class="ttdoc">All properties are zero. </div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:29</div></div>
<div class="ttc" id="class_o_n___class_array_html"><div class="ttname"><a href="../../dd/d40/class_o_n___class_array.html">ON_ClassArray</a></div><div class="ttdef"><b>Definition:</b> opennurbs_array.h:409</div></div>
<div class="ttc" id="class_o_n___text_log_html"><div class="ttname"><a href="../../d2/da3/class_o_n___text_log.html">ON_TextLog</a></div><div class="ttdef"><b>Definition:</b> opennurbs_textlog.h:20</div></div>
<div class="ttc" id="class_o_n___binary_archive_html"><div class="ttname"><a href="../../db/d16/class_o_n___binary_archive.html">ON_BinaryArchive</a></div><div class="ttdef"><b>Definition:</b> opennurbs_archive.h:1783</div></div>
<div class="ttc" id="class_o_n___font_html_a620a36120633b9420686f76ec405f277"><div class="ttname"><a href="../../d8/df5/class_o_n___font.html#a620a36120633b9420686f76ec405f277">ON_Font::Style</a></div><div class="ttdeci">Style</div><div class="ttdoc">Vertical angle of font Upright, Italic, or Oblique </div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:467</div></div>
<div class="ttc" id="class_o_n__2d_vector_html"><div class="ttname"><a href="../../da/d08/class_o_n__2d_vector.html">ON_2dVector</a></div><div class="ttdef"><b>Definition:</b> opennurbs_point.h:839</div></div>
<div class="ttc" id="class_o_n__3d_vector_html"><div class="ttname"><a href="../../d5/dae/class_o_n__3d_vector.html">ON_3dVector</a></div><div class="ttdef"><b>Definition:</b> opennurbs_point.h:1152</div></div>
<div class="ttc" id="class_o_n___font_glyph_outline_point_html_aef12c67de9caa9dd638f8bfe5c874c9e"><div class="ttname"><a href="../../da/d62/class_o_n___font_glyph_outline_point.html#aef12c67de9caa9dd638f8bfe5c874c9e">ON_FontGlyphOutlinePoint::ContourPointType</a></div><div class="ttdeci">ContourPointType</div><div class="ttdef"><b>Definition:</b> opennurbs_font.h:2047</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- HTML footer for doxygen 1.8.13-->
<!-- start footer part -->
</div> <!-- page-content -->
<hr class="footer"/><address class="footer"><small>
Generated on Sat Feb 3 2018 11:08:27 for openNURBS SDK Help by <a href="http://www.doxygen.org/index.html">
<!-- <img class="footer" src="../../doxygen.png" alt="doxygen"/> -->
Doxygen
</a> 1.8.13
</small></address>
</div> <!-- container -->
<!-- doxy-boot -->
<script type="text/javascript" src="../../doxy-boot.js"></script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink