<doc>
  <legacy_id>3066</legacy_id>
  <name>revFontUnload</name>
  <type>command</type>
  <syntax>
    <example>revFontUnload <i>fontFile</i></example>
  </syntax>
  <library>Font Library</library>
  <objects>
  </objects>
  <synonyms>
    <synonym>XUNLOAD_FONT</synonym>
  </synonyms>
  <classification>
  </classification>
  <references>
    <command tag="revFontLoad">revFontLoad Command</command>
  </references>
  <history>
    <introduced version="2.8.1">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
    <web/>
  </classes>
  <security>
    <disk access="???"/>
  </security>
  <summary>Unloads a font file from memory.</summary>
  <examples>
    <example>revFontUnload myFontFile</example>
    <example>revFontUnload "C:/myFontFolder/myCustomFont.ttf"</example>
  </examples>
  <description>
    <p>The <b>revFontUnload</b> command unloads a font file from memory.</p><p/><p><b>Parameters:</b></p><p>The <i>fontFile</i> is the path of the font file to unload</p><p/><p><b>Value:</b></p><p>The <b>revFontUnload</b> command puts empty into the result if successful. Otherwise an error string is put into the result</p><p/><p><b>Note:</b> After unloading a font, the <function tag="fontNames">fontNames function</function> will return the names of the remaining fonts that are loaded. To determine the name of the unloaded font, compare the value of the <function tag="fontNames">fontNames</function> before and after unloading.</p><p/><p><img src="202650"/> <b>Caution!</b></p><p>Ensure fonts are not in use before unloading them to avoid unexpected behaviour.</p>
  </description>
</doc>