Macro Language Reference > PIs > Text > <?tffamily>
  
<?tffamily>
Description
Specifies the required font family name for text. The command accepts a font family name, in the same way as <?tfqn>, but differs from <?tfqn> in that it will fall back to a typeface name if the current QuickFont table is missing a font family of the given name.
PTC ALD automatically creates a default QuickFont table, so that documents that want to use the QuickFont feature are no longer required to provide their own. This table will be identical to one generated by <?tqfautogen>, although without any style aliases such as “italic” or “bold.” If PTC ALD encounters a <?tffamily> command before a QuickFont table provided by the document has been activated using <?tfqt>, the automatically generated QuickFont table will be used.
Syntax
<?tffamily font_family:t>
font_family
The name of the required font family
If this name appears in the current QuickFont table (which might be the default QuickFont table that PTC ALD automatically creates) this family is selected.
If it does not appear in the current table a matching typeface is selected, if available
If no matching family or typeface exists, the PI fails silently.
Additional information
The effect of the <?tffamily> PI followed by any number of <?tfitalic>, <?tfstretch>, and <?tfweight> PIs is equivalent to a <?tfqn> command followed by a <?tfqs> request for the corresponding style, provided that the active QuickFont table contains each selected combination of font family and styles. If there is no entry for a requested combination of font family and style attributes in the current QuickFont table, the closest matching font is looked up by ignoring first the desired stretch, then the weight and then the italic style. Any missing style features are then simulated — see above. This represents the key difference between the four font family/style PIs and <?tfqs>: the latter cannot make any assumptions on how the (numbered) style attributes affect the appearance of the font, if an unknown style is requested, that request is silently ignored.
Related Links