Carbon


ATSUSetFontFallbacks

Header: ATSUnicode.h Carbon status: Supported

Enables you to indicate the font list and search order to use when a font does not have all the glyphs for the characters it is trying to draw.

OSStatus ATSUSetFontFallbacks (
    ItemCount iFontFallbacksCount, 
    ATSUFontID iFonts, 
    ATSUFontFallbackMethod iFontFallbackMethod
);
Parameter descriptions
iFontFallbacksCount

The number of fonts you want searched. This should be equivalent to the number of elements in the iFontIDs array.

iFonts

An array of the fonts you want searched.

iFontFallbackMethod

The order that you want the fonts to be searched. See“Font Fallback Constants” for a description of possible search orders.

function result

A result code. The result code kATSUInvalidFontErr indicates that the font does not correspond to any installed font.

DISCUSSION

The ATSUSetFontFallbacks function enables you to specify the font list and search order to use when a font does not have all the glyphs for the characters it is trying to draw. If you do not call ATSUSetFontFallbacks, all the fonts on the system will be searched sequentially, and the first match valid font will be used.

If you are careful in ordering the fonts to be searched when you call ATSUSetFontFallbacks, you will minimize the time ATSUI needs to find a fallback font.

VERSION NOTES

Available beginning with ATSUI 1.1.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.6 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)