<doc>
  <legacy_id>3065</legacy_id>
  <name>revFontLoad</name>
  <type>command</type>
  <syntax>
    <example>revFontLoad <i>fontFile</i></example>
  </syntax>
  <library>Font Library</library>
  <objects>
  </objects>
  <synonyms>
    <synonym>XLOAD_FONT</synonym>
  </synonyms>
  <classification>
  </classification>
  <references>
    <command tag="revFontUnload">revFontUnload Command</command>
    <function tag="fontNames">fontNames Function</function>
  </references>
  <history>
    <introduced version="2.8.1">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
    <web/>
  </classes>
  <security>
    <disk access="???"/>
  </security>
  <summary>Loads a font using the font external library.</summary>
  <examples>
    <example>revFontLoad myFontFile</example>
    <example>revFontLoad "C:/myFontFolder/myCustomFont.ttf"</example>
  </examples>
  <description>
    <p>The <b>revFontLoad</b> command loads a font from a font file into memory.</p><p/><p><b>Parameters:</b></p><p>The <i>fontFile</i> is the path to the font file</p><p/><p><b>Value:</b></p><p>If the font was loaded successfully, the <b>revFontLoad</b> command puts empty into the <function tag="result">result</function>. If the font failed to load or invalid parameters were given, the <function tag="result">result</function> will contain an error string.  This will be 'couldn't find font' if the specifed file could not be found and 'couldn't load font' if the specified file could not be loaded as a font.</p><p/><p><b>Note:</b> After loading a font, the <function tag="fontNames">fontNames function</function> will return the name of the new font as well as all the previously loaded fonts. To determine the name of the newly loaded font, compare the value of the <function tag="fontNames">fontNames</function> before and after loading the font.</p><p/><p/><p/><p/>
  </description>
</doc>