<doc>
	<legacy_id></legacy_id>
	<name>start using font</name>
	<type>command</type>

	<syntax>
		<example>start using font file <i>fontFile</i> [globally]</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Loads a font from a font file into memory.</summary>

	<examples>
<example>start using font file "C:/myFontFolder/myCustomFont.ttf"</example>
<example>start using font file "C:/myFontFolder/myCustomFont.ttf" globally</example>
	</examples>

	<history>
		<introduced version="6.5">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
	</platforms>

	<classes>
		<desktop/>
	</classes>

	<security>
		<disk/>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="fontNames">fontNames Function</function>
		<command tag="stop using font">stop using font Command</command>
		<property tag="fontFilesInUse">fontFilesInUse Property</property>
	</references>

	<description>The <b>start using font</b> command loads a font from a font file into memory.<p>The <i>fontFile</i> is the path to the font file. Use the globally adverb to indicate that the font should be available to all applications on the system rather than private to the current application.</p><p><b>Value:</b></p><p>If the font was loaded successfully, the <b>start using font</b> command puts empty into the <function tag="result">result</function>. If the font failed to load, the <function tag="result">result</function> will contain an error string.  This will be 'can't load font file' if the specifed file could not be loaded as a font.</p><p></p><note>The <function tag="fontNames">fontNames function</function> will return the name of all available fonts and the <property tag="fontFilesInUse">fontFilesInUse property</property> will return the fill paths of the loaded font files. 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.</note></description>
</doc>