Carbon


ATSUGetFontFeatureNameCode

Header: ATSUnicode.h Carbon status: Supported

Obtains the name code of a feature selector or type.

OSStatus ATSUGetFontFeatureNameCode (
    ATSUFontID iFont, 
    ATSUFontFeatureType iType, 
    ATSUFontFeatureSelector iSelector, 
    FontNameCode *oNameCode
);
Parameter descriptions
iFont

The ID of the font whose feature type or selector you want to determine the name code for.

iType

A valid feature type whose name code you want to obtain.

iSelector

The feature selector whose name code you want to obtain. If you pass the constant kATSUNoSelector, the value passed back in the oNameCode parameter represents the name code of the feature type.

oNameCode

On return, a pointer to the name code of the feature selector name. If you pass the constant kATSUNoSelector in the iSelector parameter, the value passed back represents the name code of the feature type. See “Font Name Code Constants” in the Font Manager for a description of possible values. You cannot pass NULL for this parameter.

function result

A result code. The result code kATSUInvalidFontErr indicates that the ID does not correspond to any installed font. The result code kATSUNotSetErr indicates that the font has no name in its name table for the indicated font feature.

DISCUSSION

By default, ATSUGetFontFeatureNameCode function obtains the name code of a particular feature selector. If you wish to determine the name code of the feature type, pass the constant kATSUNoSelector in the iSelector parameter. You can pass the value passed back in the oNameCode parameter to the function ATSUFindFontName to find the localized feature selector or feature type name identified by this name code.

VERSION NOTES

Available beginning with ATSUI 1.0.

AVAILABILITY

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


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