Sophie

Sophie

distrib > Mageia > 7 > armv7hl > media > core-release > by-pkgid > 179f6d9d76f967979ea9b6d2656e8a89 > files > 39

libquesoglc0-0.7.2-10.mga7.armv7hl.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Font commands</title>
<link href="quesoglc.css" rel="stylesheet" type="text/css">
</head><body>
<table>
  <tr valign="top">
    <td width="190" align="center">
      <table class="qmenu" cellspacing="0">
        <tr>
          <td class="qglobal">
            <ul class="qmenu">
	      <li class="mainmenu"><a href="index.html" >Main</a></li>
            </ul>
          </td>
	</tr>
        <tr>
            <td class="qtitle">Tutorials</td>
        </tr>
	<tr>
	  <td class="qglobal">
            <ul class="qmenu">
	      <li class="mainmenu"><a href="tutorial.html">First Steps</a></li>
	      <li class="mainmenu"><a href="tutorial2.html">Measurement</a></li>
            </ul>
          </td>
	</tr>
        <tr>
            <td class="qtitle">Documentation</td>
        </tr>
	<tr>
	  <td class="qglobal">
            <ul class="qmenu">
	      <li class="mainmenu"><a href="overview.html">Overview</a></li>
	      <li class="mainmenu"><a href="glyph.html">Glyph conventions</a></li>
	      <li class="mainmenu"><a href="machinedef.html">Machine definition</a></li>
	      <li class="mainmenu"><a href="group__context.html">Context State</a></li>
	      <li class="mainmenu"><a href="group__font.html">Fonts</a></li>
	      <li class="mainmenu"><a href="group__global.html">Global</a></li>
	      <li class="mainmenu"><a href="group__master.html">Master</a></li>
	      <li class="mainmenu"><a href="group__transform.html">Transformation</a></li>
	      <li class="mainmenu"><a href="group__render.html">Render</a></li>
	      <li class="mainmenu"><a href="group__measure.html">Measurement</a></li>
            </ul>
          </td>
	</tr>
      </table>
    </td>
    <td>
      <table>
        <tr>
	  <td class="main">
<!-- Generated by Doxygen 1.8.14 -->
</div><!-- top -->
<div class="header">
  <div class="summary">
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<div class="title">Font commands</div>  </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gad92160700f02d2e8500cf971ad01d7d3"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#gad92160700f02d2e8500cf971ad01d7d3">glcAppendFont</a> (GLint inFont)</td></tr>
<tr class="separator:gad92160700f02d2e8500cf971ad01d7d3"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gaa10082d2d81fa5141445305ffb9d35d0"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#gaa10082d2d81fa5141445305ffb9d35d0">glcDeleteFont</a> (GLint inFont)</td></tr>
<tr class="separator:gaa10082d2d81fa5141445305ffb9d35d0"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gaab2c8a01997c3827b10aebedd8e78501"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#gaab2c8a01997c3827b10aebedd8e78501">glcFont</a> (GLint inFont)</td></tr>
<tr class="separator:gaab2c8a01997c3827b10aebedd8e78501"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gab9800f5153d46bd293b62dc7bfcd364f"><td class="memItemLeft" align="right" valign="top">GLboolean&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#gab9800f5153d46bd293b62dc7bfcd364f">glcFontFace</a> (GLint inFont, const GLCchar *inFace)</td></tr>
<tr class="separator:gab9800f5153d46bd293b62dc7bfcd364f"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gabffaeb1bae95bb7905475e3b4f6e106b"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#gabffaeb1bae95bb7905475e3b4f6e106b">glcFontMap</a> (GLint inFont, GLint inCode, const GLCchar *inCharName)</td></tr>
<tr class="separator:gabffaeb1bae95bb7905475e3b4f6e106b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga658c40ba0437274cf2849bc3dac4dd20"><td class="memItemLeft" align="right" valign="top">GLint&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#ga658c40ba0437274cf2849bc3dac4dd20">glcGenFontID</a> (void)</td></tr>
<tr class="separator:ga658c40ba0437274cf2849bc3dac4dd20"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga2e7e02243136b61d6540465d7504944e"><td class="memItemLeft" align="right" valign="top">const GLCchar *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#ga2e7e02243136b61d6540465d7504944e">glcGetFontFace</a> (GLint inFont)</td></tr>
<tr class="separator:ga2e7e02243136b61d6540465d7504944e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga76f1c73a4c6d605dbb85698dc52a9c96"><td class="memItemLeft" align="right" valign="top">const GLCchar *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#ga76f1c73a4c6d605dbb85698dc52a9c96">glcGetFontListc</a> (GLint inFont, GLCenum inAttrib, GLint inIndex)</td></tr>
<tr class="separator:ga76f1c73a4c6d605dbb85698dc52a9c96"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga7e3ced4b8e58e4c694e3f832e0ed6b2d"><td class="memItemLeft" align="right" valign="top">const GLCchar *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#ga7e3ced4b8e58e4c694e3f832e0ed6b2d">glcGetFontMap</a> (GLint inFont, GLint inCode)</td></tr>
<tr class="separator:ga7e3ced4b8e58e4c694e3f832e0ed6b2d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga2e9996be0a7e5fd0e997e63c346168eb"><td class="memItemLeft" align="right" valign="top">const GLCchar *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#ga2e9996be0a7e5fd0e997e63c346168eb">glcGetFontc</a> (GLint inFont, GLCenum inAttrib)</td></tr>
<tr class="separator:ga2e9996be0a7e5fd0e997e63c346168eb"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gaa15d21669924d3b4b1a34d4458bdf765"><td class="memItemLeft" align="right" valign="top">GLint&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#gaa15d21669924d3b4b1a34d4458bdf765">glcGetFonti</a> (GLint inFont, GLCenum inAttrib)</td></tr>
<tr class="separator:gaa15d21669924d3b4b1a34d4458bdf765"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga64088e47288e9f81348f547f338988f5"><td class="memItemLeft" align="right" valign="top">GLboolean&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#ga64088e47288e9f81348f547f338988f5">glcIsFont</a> (GLint inFont)</td></tr>
<tr class="separator:ga64088e47288e9f81348f547f338988f5"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga3ea371b2083f6c1b5b7068ac80f0946a"><td class="memItemLeft" align="right" valign="top">GLint&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#ga3ea371b2083f6c1b5b7068ac80f0946a">glcNewFontFromMaster</a> (GLint inFont, GLint inMaster)</td></tr>
<tr class="separator:ga3ea371b2083f6c1b5b7068ac80f0946a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gacc8675929261b5f04882d375cb54a530"><td class="memItemLeft" align="right" valign="top">GLint&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__font.html#gacc8675929261b5f04882d375cb54a530">glcNewFontFromFamily</a> (GLint inFont, const GLCchar *inFamily)</td></tr>
<tr class="separator:gacc8675929261b5f04882d375cb54a530"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>Commands to create, manage and destroy fonts. </p>
<p>A font is a stylistically consistent set of glyphs that can be used to render some set of characters. Each font has a family name (for example Palatino) and a state variable that selects one of the faces (for example Regular, Bold, Italic, BoldItalic) that the font contains. A typeface is the combination of a family and a face (for example Palatino Bold).</p>
<p>A font is an instantiation of a master for a given face.</p>
<p>Every font has an associated character map. A character map is a table of entries that maps integer values to the name string that identifies the characters. The character maps are used by GLC, for instance, to determine that the character code <em>65</em> corresponds to <em>A</em>. The character map of a font can be modified by either adding new entries or changing the mapping of the characters (see <a class="el" href="group__font.html#gabffaeb1bae95bb7905475e3b4f6e106b" title="This command modifies the character map of the font identified by inFont such that the font maps inCo...">glcFontMap()</a>).</p>
<p>GLC maintains two lists of fonts : <b>GLC_FONT_LIST</b> and <b>GLC_CURRENT_FONT_LIST</b>. The former contains every font that have been created with the commands <a class="el" href="group__font.html#gacc8675929261b5f04882d375cb54a530" title="This command performs a sequential search beginning with the first element of the GLC master list...">glcNewFontFromFamily()</a> and <a class="el" href="group__font.html#ga3ea371b2083f6c1b5b7068ac80f0946a" title="This command creates a new font from the master identified by inMaster. ">glcNewFontFromMaster()</a> and the later contains the fonts that GLC can use when it renders a character (notice however that if <b>GLC_AUTO_FONT</b> is enabled, GLC may automatically add new fonts from <b>GLC_FONT_LIST</b> to the <b>GLC_CURRENT_FONT_LIST</b> ). Finally, it must be stressed that the order in which the fonts are stored in the <b>GLC_CURRENT_FONT_LIST</b> matters : the first font of the list should be considered as the main font with which strings are rendered, while other fonts of this list should be seen as fallback fonts (i.e. fonts that are used when the first font of <b>GLC_CURRENT_FONT_LIST</b> does not map the character to render).</p>
<p>Most of the commands in this category have a parameter <em>inFont</em>. Unless otherwise specified, these commands raise <b>GLC_PARAMETER_ERROR</b> if <em>inFont</em> is less than zero or is greater than or equal to the value of the variable <b>GLC_FONT_COUNT</b>. </p>
<h2 class="groupheader">Function Documentation</h2>
<a id="gad92160700f02d2e8500cf971ad01d7d3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad92160700f02d2e8500cf971ad01d7d3">&#9670;&nbsp;</a></span>glcAppendFont()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void glcAppendFont </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command appends <em>inFont</em> to the list <b>GLC_CURRENT_FONT_LIST</b>. </p>
<p>The command raises <b>GLC_PARAMETER_ERROR</b> if <em>inFont</em> is not an element of the list <b>GLC_FONT_LIST</b> or if <em>inFont</em> is an element in the list <b>GLC_CURRENT_FONT_LIST</b> at the beginning of command execution. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The ID of the font to append to the list <b>GLC_CURRENT_FONT_LIST</b> </td></tr>
  </table>
  </dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__context.html#gaff9f0d258360614e3d2ffbdaeade1ecc" title="This command returns the string at offset inIndex from the first element in the string list identifie...">glcGetListc()</a> with argument <b>GLC_CURRENT_FONT_LIST</b> </dd>
<dd>
<a class="el" href="group__context.html#gad9d771a80cebb0d5e346066d2636bca0" title="This command returns the value of the integer variable or constant identified by inAttrib. ">glcGeti()</a> with argument <b>GLC_CURRENT_FONT_COUNT</b> </dd>
<dd>
<a class="el" href="group__font.html#gaab2c8a01997c3827b10aebedd8e78501" title="This command begins by removing all elements from the list GLC_CURRENT_FONT_LIST. ...">glcFont()</a> </dd>
<dd>
<a class="el" href="group__font.html#gacc8675929261b5f04882d375cb54a530" title="This command performs a sequential search beginning with the first element of the GLC master list...">glcNewFontFromFamily()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga3ea371b2083f6c1b5b7068ac80f0946a" title="This command creates a new font from the master identified by inMaster. ">glcNewFontFromMaster()</a> </dd></dl>

</div>
</div>
<a id="gaa10082d2d81fa5141445305ffb9d35d0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa10082d2d81fa5141445305ffb9d35d0">&#9670;&nbsp;</a></span>glcDeleteFont()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void glcDeleteFont </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command deletes the font identified by <em>inFont</em>. </p>
<p>If <em>inFont</em> is an element in the list <b>GLC_CURRENT_FONT_LIST</b>, the command removes that element from the list. All information about the font is lost, and the indice <em>inFont</em> become unused.</p>
<p>The command raises <b>GLC_PARAMETER_ERROR</b> if <em>inFont</em> is not an element of the list <b>GLC_FONT_LIST</b> and if <em>inFont</em> has not been generated by <a class="el" href="group__font.html#ga658c40ba0437274cf2849bc3dac4dd20" title="This command returns a font ID that is not an element of the list GLC_FONT_LIST. ">glcGenFontID()</a>. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The ID of the font to delete </td></tr>
  </table>
  </dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__context.html#gaced57b16eadb7e5f45a0a1cfff2621e9" title="This command returns the integer at offset inIndex from the first element in the integer list identif...">glcGetListi()</a> with argument <b>GLC_FONT_LIST</b> </dd>
<dd>
<a class="el" href="group__context.html#gad9d771a80cebb0d5e346066d2636bca0" title="This command returns the value of the integer variable or constant identified by inAttrib. ">glcGeti()</a> with argument <b>GLC_FONT_COUNT</b> </dd>
<dd>
<a class="el" href="group__font.html#ga64088e47288e9f81348f547f338988f5" title="This command returns GL_TRUE if inFont is the ID of a font. ">glcIsFont()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga658c40ba0437274cf2849bc3dac4dd20" title="This command returns a font ID that is not an element of the list GLC_FONT_LIST. ">glcGenFontID()</a> </dd>
<dd>
<a class="el" href="group__font.html#gacc8675929261b5f04882d375cb54a530" title="This command performs a sequential search beginning with the first element of the GLC master list...">glcNewFontFromFamily()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga3ea371b2083f6c1b5b7068ac80f0946a" title="This command creates a new font from the master identified by inMaster. ">glcNewFontFromMaster()</a> </dd></dl>

</div>
</div>
<a id="gaab2c8a01997c3827b10aebedd8e78501"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaab2c8a01997c3827b10aebedd8e78501">&#9670;&nbsp;</a></span>glcFont()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void glcFont </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command begins by removing all elements from the list <b>GLC_CURRENT_FONT_LIST</b>. </p>
<p>If <em>inFont</em> is nonzero, the command then appends <em>inFont</em> to the list. Otherwise, the command does not raise an error and the list remains empty.</p>
<p>The command raises <b>GLC_PARAMETER_ERROR</b> if <em>inFont</em> is nonzero and is not an element of the list <b>GLC_FONT_LIST</b>. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The ID of a font. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__context.html#gaff9f0d258360614e3d2ffbdaeade1ecc" title="This command returns the string at offset inIndex from the first element in the string list identifie...">glcGetListc()</a> with argument <b>GLC_CURRENT_FONT_LIST</b> </dd>
<dd>
<a class="el" href="group__context.html#gad9d771a80cebb0d5e346066d2636bca0" title="This command returns the value of the integer variable or constant identified by inAttrib. ">glcGeti()</a> with argument <b>GLC_CURRENT_FONT_COUNT</b> </dd>
<dd>
<a class="el" href="group__font.html#gad92160700f02d2e8500cf971ad01d7d3" title="This command appends inFont to the list GLC_CURRENT_FONT_LIST. ">glcAppendFont()</a> </dd></dl>

</div>
</div>
<a id="gab9800f5153d46bd293b62dc7bfcd364f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab9800f5153d46bd293b62dc7bfcd364f">&#9670;&nbsp;</a></span>glcFontFace()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">GLboolean glcFontFace </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const GLCchar *&#160;</td>
          <td class="paramname"><em>inFace</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command attempts to set the current face of the font identified by <em>inFont</em> to the face identified by the string <em>inFace</em>. </p>
<p>Examples for font faces are strings like <code>"Normal"</code>, <code>"Bold"</code> or <code>"Bold Italic"</code>. In contrast to some systems that have a different font for each face, GLC allows you to have the face be an attribute of the font.</p>
<p>If <em>inFace</em> is not an element of the font's string list attribute <b>GLC_FACE_LIST</b>, the command leaves the font's current face unchanged and returns <b>GL_FALSE</b>. If the command succeeds, it returns <b>GL_TRUE</b>.</p>
<p>If <em>inFont</em> is zero, the command iterates over the <b>GLC_CURRENT_FONT_LIST</b>. For each of the fonts named therein, the command attempts to set the font's current face to the face in that font that is identified by <em>inFace</em>. In this case, the command returns <b>GL_TRUE</b> if <b>GLC_CURRENT_FONT_LIST</b> contains one or more elements and the command successfully sets the current face of each of the fonts named in the list.</p>
<p>The command raises <b>GLC_PARAMETER_ERROR</b> if <em>inFont</em> is not an element in the list <b>GLC_FONT_LIST</b>. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The ID of the font to be changed </td></tr>
    <tr><td class="paramname">inFace</td><td>The face for <em>inFont</em> </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><b>GL_TRUE</b> if the command succeeded to set the face <em>inFace</em> to the font <em>inFont</em>. <b>GL_FALSE</b> is returned otherwise. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__font.html#ga2e7e02243136b61d6540465d7504944e" title="This command returns the string name of the current face of the font identified by inFont...">glcGetFontFace()</a> </dd></dl>

</div>
</div>
<a id="gabffaeb1bae95bb7905475e3b4f6e106b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gabffaeb1bae95bb7905475e3b4f6e106b">&#9670;&nbsp;</a></span>glcFontMap()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void glcFontMap </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inCode</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const GLCchar *&#160;</td>
          <td class="paramname"><em>inCharName</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command modifies the character map of the font identified by <em>inFont</em> such that the font maps <em>inCode</em> to the character whose name is the string <em>inCharName</em>. </p>
<p>If <em>inCharName</em> is <b>GLC_NONE</b>, <em>inCode</em> is removed from the character map.</p>
<p>The command raises <b>GLC_PARAMETER_ERROR</b> if <em>inCharName</em> is not <b>GLC_NONE</b> or an element of the font string's list attribute <b>GLC_CHAR_LIST</b>. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The ID of the font </td></tr>
    <tr><td class="paramname">inCode</td><td>The integer ID of a character </td></tr>
    <tr><td class="paramname">inCharName</td><td>The string name of a character </td></tr>
  </table>
  </dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__font.html#ga7e3ced4b8e58e4c694e3f832e0ed6b2d" title="This command returns the string name of the character that the font identified by inFont maps inCode ...">glcGetFontMap()</a> </dd></dl>

</div>
</div>
<a id="ga658c40ba0437274cf2849bc3dac4dd20"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga658c40ba0437274cf2849bc3dac4dd20">&#9670;&nbsp;</a></span>glcGenFontID()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">GLint glcGenFontID </td>
          <td>(</td>
          <td class="paramtype">void&#160;</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command returns a font ID that is not an element of the list <b>GLC_FONT_LIST</b>. </p>
<p>This command has also the effect of creating an empty font for the returned ID so that this ID become used. </p><dl class="section return"><dt>Returns</dt><dd>A new font ID </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__font.html#gaa10082d2d81fa5141445305ffb9d35d0" title="This command deletes the font identified by inFont. ">glcDeleteFont()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga64088e47288e9f81348f547f338988f5" title="This command returns GL_TRUE if inFont is the ID of a font. ">glcIsFont()</a> </dd>
<dd>
<a class="el" href="group__font.html#gacc8675929261b5f04882d375cb54a530" title="This command performs a sequential search beginning with the first element of the GLC master list...">glcNewFontFromFamily()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga3ea371b2083f6c1b5b7068ac80f0946a" title="This command creates a new font from the master identified by inMaster. ">glcNewFontFromMaster()</a> </dd></dl>

</div>
</div>
<a id="ga2e7e02243136b61d6540465d7504944e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2e7e02243136b61d6540465d7504944e">&#9670;&nbsp;</a></span>glcGetFontFace()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const GLCchar* glcGetFontFace </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command returns the string name of the current face of the font identified by <em>inFont</em>. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The font ID </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The string name of the font <em>inFont</em> </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__font.html#gab9800f5153d46bd293b62dc7bfcd364f" title="This command attempts to set the current face of the font identified by inFont to the face identified...">glcFontFace()</a> </dd></dl>

</div>
</div>
<a id="ga76f1c73a4c6d605dbb85698dc52a9c96"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga76f1c73a4c6d605dbb85698dc52a9c96">&#9670;&nbsp;</a></span>glcGetFontListc()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const GLCchar* glcGetFontListc </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">GLCenum&#160;</td>
          <td class="paramname"><em>inAttrib</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inIndex</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command returns an attribute of the font identified by <em>inFont</em> that is a string from a string list identified by <em>inAttrib</em>. </p>
<p>The command returns the string at offset <em>inIndex</em> from the first element in <em>inAttrib</em>. For example, if <em>inFont</em> has a face list (<code>Regular</code>, <code>Bold</code>, <code>Italic</code> ) and <em>inIndex</em> is <code>2</code>, then the command returns <code>Italic</code> if you query <b>GLC_FACE_LIST</b>.</p>
<p>Every GLC state variable that is a list has an associated integer element count whose value is the number of elements in the list.</p>
<p>Below are the string list attributes associated with each GLC master and font and their element count attributes : </p><center> <a class="anchor" id=""></a>
<table class="doxtable">
<caption>Master/font string list attributes</caption>
<tr>
<td>Name </td><td>Enumerant </td><td>Element count attribute  </td></tr>
<tr>
<td><b>GLC_CHAR_LIST</b> </td><td>0x0050 </td><td><b>GLC_CHAR_COUNT</b>  </td></tr>
<tr>
<td><b>GLC_FACE_LIST</b> </td><td>0x0051 </td><td><b>GLC_FACE_COUNT</b>  </td></tr>
</table>
</center><p> <br />
 The command raises <b>GLC_PARAMETER_ERROR</b> if <em>inIndex</em> is less than zero or is greater than or equal to the value of the list element count attribute. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The font ID </td></tr>
    <tr><td class="paramname">inAttrib</td><td>The string list from which a string is requested </td></tr>
    <tr><td class="paramname">inIndex</td><td>The offset from the first element of the list associated with <em>inAttrib</em> </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A string attribute of <em>inFont</em> identified by <em>inAttrib</em> </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__master.html#ga397dafe9ccebca28846af39356481742" title="This command returns a string from a string list that is an attribute of the master identified by inM...">glcGetMasterListc()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga2e9996be0a7e5fd0e997e63c346168eb" title="This command returns a string attribute of the font identified by inFont. ">glcGetFontc()</a> </dd>
<dd>
<a class="el" href="group__font.html#gaa15d21669924d3b4b1a34d4458bdf765" title="This command returns an integer attribute of the font identified by inFont. ">glcGetFonti()</a> </dd></dl>

</div>
</div>
<a id="ga7e3ced4b8e58e4c694e3f832e0ed6b2d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga7e3ced4b8e58e4c694e3f832e0ed6b2d">&#9670;&nbsp;</a></span>glcGetFontMap()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const GLCchar* glcGetFontMap </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inCode</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command returns the string name of the character that the font identified by <em>inFont</em> maps <em>inCode</em> to. </p>
<p>To change the map, that is, associate a different name string with the integer ID of a font, use <a class="el" href="group__font.html#gabffaeb1bae95bb7905475e3b4f6e106b" title="This command modifies the character map of the font identified by inFont such that the font maps inCo...">glcFontMap()</a>.</p>
<p>If <em>inCode</em> cannot be mapped in the font, the command returns <b>GLC_NONE</b>.</p>
<p>The command raises <b>GLC_PARAMETER_ERROR</b> if <em>inFont</em> is not an element of the list <b>GLC_FONT_LIST</b> </p><dl class="section note"><dt>Note</dt><dd>Changing the map of a font is possible but changing the map of a master is not. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The integer ID of the font from which to select the character </td></tr>
    <tr><td class="paramname">inCode</td><td>The integer ID of the character in the font map </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The string name of the character that the font <em>inFont</em> maps <em>inCode</em> to. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__master.html#ga35b8d2d3caef1e56f9751261765c08dc" title="This command returns the string name of the character that the master identified by inMaster maps inC...">glcGetMasterMap()</a> </dd>
<dd>
<a class="el" href="group__font.html#gabffaeb1bae95bb7905475e3b4f6e106b" title="This command modifies the character map of the font identified by inFont such that the font maps inCo...">glcFontMap()</a> </dd></dl>

</div>
</div>
<a id="ga2e9996be0a7e5fd0e997e63c346168eb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2e9996be0a7e5fd0e997e63c346168eb">&#9670;&nbsp;</a></span>glcGetFontc()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const GLCchar* glcGetFontc </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">GLCenum&#160;</td>
          <td class="paramname"><em>inAttrib</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command returns a string attribute of the font identified by <em>inFont</em>. </p>
<p>The table below lists the string attributes that are associated with each GLC master and font. </p><center> <a class="anchor" id=""></a>
<table class="doxtable">
<caption>Master/font string attributes</caption>
<tr>
<td>Name </td><td>Enumerant  </td></tr>
<tr>
<td><b>GLC_FAMILY</b> </td><td>0x0060  </td></tr>
<tr>
<td><b>GLC_MASTER_FORMAT</b> </td><td>0x0061  </td></tr>
<tr>
<td><b>GLC_VENDOR</b> </td><td>0x0062  </td></tr>
<tr>
<td><b>GLC_VERSION</b> </td><td>0x0063  </td></tr>
<tr>
<td><b>GLC_FULL_NAME_SGI</b> </td><td>0x8002  </td></tr>
</table>
</center> <dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The font for which the attribute is requested </td></tr>
    <tr><td class="paramname">inAttrib</td><td>The requested string attribute </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The string attribute <em>inAttrib</em> of the font <em>inFont</em> </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__master.html#ga548f2b1cabd967d2297ea8bb5ce809a3" title="This command returns a string attribute of the master identified by inMaster. ">glcGetMasterc()</a> </dd>
<dd>
<a class="el" href="group__font.html#gaa15d21669924d3b4b1a34d4458bdf765" title="This command returns an integer attribute of the font identified by inFont. ">glcGetFonti()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga76f1c73a4c6d605dbb85698dc52a9c96" title="This command returns an attribute of the font identified by inFont that is a string from a string lis...">glcGetFontListc()</a> </dd></dl>

</div>
</div>
<a id="gaa15d21669924d3b4b1a34d4458bdf765"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa15d21669924d3b4b1a34d4458bdf765">&#9670;&nbsp;</a></span>glcGetFonti()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">GLint glcGetFonti </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">GLCenum&#160;</td>
          <td class="paramname"><em>inAttrib</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command returns an integer attribute of the font identified by <em>inFont</em>. </p>
<p>The attribute is identified by <em>inAttrib</em>. The table below lists the integer attributes that are associated with each GLC master and font. </p><center> <a class="anchor" id=""></a>
<table class="doxtable">
<caption>Master/font integer attributes</caption>
<tr>
<td>Name </td><td>Enumerant  </td></tr>
<tr>
<td><b>GLC_CHAR_COUNT</b> </td><td>0x0070  </td></tr>
<tr>
<td><b>GLC_FACE_COUNT</b> </td><td>0x0071  </td></tr>
<tr>
<td><b>GLC_IS_FIXED_PITCH</b> </td><td>0x0072  </td></tr>
<tr>
<td><b>GLC_MAX_MAPPED_CODE</b> </td><td>0x0073  </td></tr>
<tr>
<td><b>GLC_MIN_MAPPED_CODE</b> </td><td>0x0074  </td></tr>
</table>
</center> <dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The font for which the attribute is requested. </td></tr>
    <tr><td class="paramname">inAttrib</td><td>The requested integer attribute </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The value of the specified integer attribute </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__master.html#ga5c8c239c416e8a879795f2e8b42699e2" title="This command returns an integer attribute of the master identified by inMaster. ">glcGetMasteri()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga2e9996be0a7e5fd0e997e63c346168eb" title="This command returns a string attribute of the font identified by inFont. ">glcGetFontc()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga76f1c73a4c6d605dbb85698dc52a9c96" title="This command returns an attribute of the font identified by inFont that is a string from a string lis...">glcGetFontListc()</a> </dd></dl>

</div>
</div>
<a id="ga64088e47288e9f81348f547f338988f5"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga64088e47288e9f81348f547f338988f5">&#9670;&nbsp;</a></span>glcIsFont()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">GLboolean glcIsFont </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command returns <b>GL_TRUE</b> if <em>inFont</em> is the ID of a font. </p>
<p>If <em>inFont</em> is not the ID of a font, the command does not raise an error. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The element to be tested </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><b>GL_TRUE</b> if <em>inFont</em> is the ID of a font, <b>GL_FALSE</b> otherwise. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__font.html#ga658c40ba0437274cf2849bc3dac4dd20" title="This command returns a font ID that is not an element of the list GLC_FONT_LIST. ">glcGenFontID()</a> </dd>
<dd>
<a class="el" href="group__font.html#gacc8675929261b5f04882d375cb54a530" title="This command performs a sequential search beginning with the first element of the GLC master list...">glcNewFontFromFamily()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga3ea371b2083f6c1b5b7068ac80f0946a" title="This command creates a new font from the master identified by inMaster. ">glcNewFontFromMaster()</a> </dd></dl>

</div>
</div>
<a id="ga3ea371b2083f6c1b5b7068ac80f0946a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3ea371b2083f6c1b5b7068ac80f0946a">&#9670;&nbsp;</a></span>glcNewFontFromMaster()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">GLint glcNewFontFromMaster </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inMaster</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command creates a new font from the master identified by <em>inMaster</em>. </p>
<p>The ID of the new font is <em>inFont</em>. If the command succeeds, it returns <em>inFont</em>. If <em>inFont</em> is the ID of a font at the beginning of command execution, the command executes the command <code>glcDeleteFont(inFont)</code> before creating the new font. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The ID of the new font </td></tr>
    <tr><td class="paramname">inMaster</td><td>The master from which to create the new font </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The ID of the new font if the command succceeds, <code>0</code> otherwise. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__context.html#gaced57b16eadb7e5f45a0a1cfff2621e9" title="This command returns the integer at offset inIndex from the first element in the integer list identif...">glcGetListi()</a> with argument <b>GLC_FONT_LIST</b> </dd>
<dd>
<a class="el" href="group__context.html#gad9d771a80cebb0d5e346066d2636bca0" title="This command returns the value of the integer variable or constant identified by inAttrib. ">glcGeti()</a> with argument <b>GLC_FONT_COUNT</b> </dd>
<dd>
<a class="el" href="group__font.html#ga64088e47288e9f81348f547f338988f5" title="This command returns GL_TRUE if inFont is the ID of a font. ">glcIsFont()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga658c40ba0437274cf2849bc3dac4dd20" title="This command returns a font ID that is not an element of the list GLC_FONT_LIST. ">glcGenFontID()</a> </dd>
<dd>
<a class="el" href="group__font.html#gacc8675929261b5f04882d375cb54a530" title="This command performs a sequential search beginning with the first element of the GLC master list...">glcNewFontFromFamily()</a> </dd>
<dd>
<a class="el" href="group__font.html#gaa10082d2d81fa5141445305ffb9d35d0" title="This command deletes the font identified by inFont. ">glcDeleteFont()</a> </dd></dl>

</div>
</div>
<a id="gacc8675929261b5f04882d375cb54a530"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gacc8675929261b5f04882d375cb54a530">&#9670;&nbsp;</a></span>glcNewFontFromFamily()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">GLint glcNewFontFromFamily </td>
          <td>(</td>
          <td class="paramtype">GLint&#160;</td>
          <td class="paramname"><em>inFont</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const GLCchar *&#160;</td>
          <td class="paramname"><em>inFamily</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>This command performs a sequential search beginning with the first element of the GLC master list, looking for the first master whose string attribute <b>GLC_FAMILY</b> equals <em>inFamily</em>. </p>
<p>If there is no such master the command returns zero. Otherwise, the command creates a new font from the master. The ID of the new font is <em>inFont</em>.</p>
<p>If the command succeeds, it returns <em>inFont</em>. If <em>inFont</em> is the ID of a font at the beginning of command execution, the command executes the command <code>glcDeleteFont(inFont)</code> before creating the new font. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">inFont</td><td>The ID of the new font. </td></tr>
    <tr><td class="paramname">inFamily</td><td>The font family, that is, the string that <b>GLC_FAMILY</b> attribute has to match. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The ID of the new font if the command succeeds, <code>0</code> otherwise. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__context.html#gaced57b16eadb7e5f45a0a1cfff2621e9" title="This command returns the integer at offset inIndex from the first element in the integer list identif...">glcGetListi()</a> with argument <b>GLC_FONT_LIST</b> </dd>
<dd>
<a class="el" href="group__context.html#gad9d771a80cebb0d5e346066d2636bca0" title="This command returns the value of the integer variable or constant identified by inAttrib. ">glcGeti()</a> with argument <b>GLC_FONT_COUNT</b> </dd>
<dd>
<a class="el" href="group__font.html#ga64088e47288e9f81348f547f338988f5" title="This command returns GL_TRUE if inFont is the ID of a font. ">glcIsFont()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga658c40ba0437274cf2849bc3dac4dd20" title="This command returns a font ID that is not an element of the list GLC_FONT_LIST. ">glcGenFontID()</a> </dd>
<dd>
<a class="el" href="group__font.html#ga3ea371b2083f6c1b5b7068ac80f0946a" title="This command creates a new font from the master identified by inMaster. ">glcNewFontFromMaster()</a> </dd>
<dd>
<a class="el" href="group__font.html#gaa10082d2d81fa5141445305ffb9d35d0" title="This command deletes the font identified by inFont. ">glcDeleteFont()</a> </dd></dl>

</div>
</div>
</div><!-- contents -->
          </td>
	</tr>
        <tr>
          <td align="center" class="main">
	    <hr>
            <small>
              <font color="#cccccc">Generated on Mon Oct 1 2018 06:30:23 for QuesoGLC by <a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border=0></a> 1.8.14 written by Dimitri van Heesch &copy;&nbsp;1997-2005</font>
            </small>
          </td>
        </tr>
      </table>
    </td>
  </tr>
</table>
</body>
</html>