Function

CTFontCopyFeatureSettings

Returns an array of font feature-setting tuples.

Declaration

CFArrayRef CTFontCopyFeatureSettings(CTFontRef font);

Parameters

font

The font reference.

Return Value

A normalized array of font feature-setting dictionaries. The array contains only the non-default settings that should be applied to the font, or NULL if the default settings should be used.

Discussion

A feature-setting dictionary is a tuple of a kCTFontFeatureTypeIdentifierKey key-value pair and a kCTFontFeatureSelectorIdentifierKey key-value pair. Each setting dictionary indicates which setting is enabled. It is the caller's responsibility to handle exclusive and nonexclusive settings as necessary.

The feature settings are verified against those that the font supports and any that do not apply are removed. Further, feature settings that represent a default setting for the font are also removed.

See Also

Getting Font Features

CTFontCopyFeatures

Returns an array of font features.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software