CTFontDescriptor.h学习

2017-03-02

该类从以下四个方面来学习。

1.Descriptor Types

1	CFTypeID CTFontDescriptorGetTypeID( void ) CT_AVAILABLE(10_5, 3_2);

2.Descriptor Constants

ke’y	value	解释
kCTFontURLAttribute	CFURLRef	通过 descriptor 访问字体的url
kCTFontNameAttribute	CFStringRef	先从 PostScript arr 中找，没发现在从 family 数字找，没发现用 display name 。，如果还是从字体列表中没找到，默认返回 Helvetica 字体
kCTFontDisplayNameAttribute	CFStringRef	这个返回display name 大多数是 the full name。
kCTFontFamilyNameAttribute	CFStringRef	返回 family name
kCTFontStyleNameAttribute	CFStringRef	返回 the style name of the font。代表设计者对该字体样式的描述。
kCTFontTraitsAttribute	CFDictionaryRef	返回改字体的特性 traits 字典。
kCTFontVariationAttribute	CFDictionaryRef	不知道啥用
kCTFontSizeAttribute	CFNumberRef	返回字体的大小
kCTFontMatrixAttribute	CFDataRef	该data是 CGAffineTransform信息
kCTFontCascadeListAttribute	CFArrayRef	级联表格数组，具体干嘛的不知道。看结果在说
kCTFontCharacterSetAttribute	CFCharacterSetRef
kCTFontLanguagesAttribute	CFArrayRef
kCTFontBaselineAdjustAttribute	CFNumberRef
kCTFontMacintoshEncodingsAttribute	CFNumberRef
kCTFontFeaturesAttribute	CFArrayRef
kCTFontFeatureSettingsAttribute
kCTFontFixedAdvanceAttribute	CFNumberRef
kCTFontOrientationAttribute	CFNumberRef
kCTFontFormatAttribute	CFNumber
kCTFontRegistrationScopeAttribute	CTFontManagerScope
kCTFontPriorityAttribute
kCTFontEnabledAttribute
kCTFontDownloadableAttribute
kCTFontDownloadedAttribute

typedef CF_ENUM(uint32_t, CTFontOrientation) {
    kCTFontOrientationDefault    CT_ENUM_AVAILABLE(10_8, 6_0) = 0,
    kCTFontOrientationHorizontal CT_ENUM_AVAILABLE(10_8, 6_0) = 1,
    kCTFontOrientationVertical   CT_ENUM_AVAILABLE(10_8, 6_0) = 2,
    kCTFontDefaultOrientation CT_ENUM_DEPRECATED(10_5, 10_11, 3_2, 9_0) = kCTFontOrientationDefault,
    kCTFontHorizontalOrientation CT_ENUM_DEPRECATED(10_5, 10_11, 3_2, 9_0) = kCTFontOrientationHorizontal,
    kCTFontVerticalOrientation CT_ENUM_DEPRECATED(10_5, 10_11, 3_2, 9_0) = kCTFontOrientationVertical
};

typedef CF_ENUM(uint32_t, CTFontFormat) {
    kCTFontFormatUnrecognized       = 0,
    kCTFontFormatOpenTypePostScript = 1,
    kCTFontFormatOpenTypeTrueType   = 2,
    kCTFontFormatTrueType           = 3,
    kCTFontFormatPostScript         = 4,
    kCTFontFormatBitmap             = 5
};

3.Descriptor Creation

1
2
3

CTFontDescriptorRef CTFontDescriptorCreateWithNameAndSize(
    CFStringRef         name,
    CGFloat             size ) CT_AVAILABLE(10_5, 3_2);

1 2	CTFontDescriptorRef CTFontDescriptorCreateWithAttributes( CFDictionaryRef attributes ) CT_AVAILABLE(10_5, 3_2);

1
2
3

CTFontDescriptorRef CTFontDescriptorCreateCopyWithAttributes(
    CTFontDescriptorRef     original,
    CFDictionaryRef         attributes ) CT_AVAILABLE(10_5, 3_2);

1
2
3

CTFontDescriptorRef __nullable CTFontDescriptorCreateCopyWithFamily(
    CTFontDescriptorRef     original,
    CFStringRef             family ) CT_AVAILABLE(10_9, 7_0);

CTFontDescriptorRef __nullable CTFontDescriptorCreateCopyWithSymbolicTraits(
    CTFontDescriptorRef     original,
    CTFontSymbolicTraits    symTraitValue,
    CTFontSymbolicTraits    symTraitMask ) CT_AVAILABLE(10_9, 7_0);

CTFontDescriptorRef CTFontDescriptorCreateCopyWithVariation(
    CTFontDescriptorRef     original,
    CFNumberRef             variationIdentifier,
    CGFloat                 variationValue ) CT_AVAILABLE(10_5, 3_2);

CTFontDescriptorRef CTFontDescriptorCreateCopyWithFeature(
    CTFontDescriptorRef     original,
    CFNumberRef             featureTypeIdentifier,
    CFNumberRef             featureSelectorIdentifier ) CT_AVAILABLE(10_5, 3_2);

1
2
3

CFArrayRef __nullable CTFontDescriptorCreateMatchingFontDescriptors(
    CTFontDescriptorRef     descriptor,
    CFSetRef __nullable     mandatoryAttributes ) CT_AVAILABLE(10_5, 3_2);

1
2
3

CTFontDescriptorRef __nullable CTFontDescriptorCreateMatchingFontDescriptor(
    CTFontDescriptorRef     descriptor,
    CFSetRef __nullable     mandatoryAttributes ) CT_AVAILABLE(10_5, 3_2);

typedef CF_ENUM(uint32_t, CTFontDescriptorMatchingState) {
    kCTFontDescriptorMatchingDidBegin,              // called once at the beginning.
    kCTFontDescriptorMatchingDidFinish,             // called once at the end.
    
    kCTFontDescriptorMatchingWillBeginQuerying,     // called once before talking to the server.  Skipped if not necessary.
    kCTFontDescriptorMatchingStalled,               // called when stalled. (e.g. while waiting for server response.)
    
    // Downloading and activating are repeated for each descriptor.
    kCTFontDescriptorMatchingWillBeginDownloading,  // Downloading part may be skipped if all the assets are already downloaded
    kCTFontDescriptorMatchingDownloading,
    kCTFontDescriptorMatchingDidFinishDownloading,
    kCTFontDescriptorMatchingDidMatch,              // called when font descriptor is matched.
    
    kCTFontDescriptorMatchingDidFailWithError       // called when an error occurred.  (may be called multiple times.)
};

keys for progressParameter dictionary

key	value
kCTFontDescriptorMatchingSourceDescriptor
kCTFontDescriptorMatchingDescriptors
kCTFontDescriptorMatchingResult
kCTFontDescriptorMatchingPercentage
kCTFontDescriptorMatchingCurrentAssetSize
kCTFontDescriptorMatchingTotalDownloadedSize
kCTFontDescriptorMatchingTotalAssetSize
kCTFontDescriptorMatchingError

bool CTFontDescriptorMatchFontDescriptorsWithProgressHandler(
    CFArrayRef                          descriptors,
    CFSetRef __nullable                 mandatoryAttributes,
    CTFontDescriptorProgressHandler     progressBlock) CT_AVAILABLE(10_9, 6_0);

4.Descriptor Accessors

1
2
3

CFTypeRef __nullable CTFontDescriptorCopyAttribute(
    CTFontDescriptorRef     descriptor,
    CFStringRef             attribute ) CT_AVAILABLE(10_5, 3_2);

CFTypeRef __nullable CTFontDescriptorCopyLocalizedAttribute(
    CTFontDescriptorRef     descriptor,
    CFStringRef             attribute,
    CFStringRef __nullable * __nullable language ) CT_AVAILABLE(10_5, 3_2);

###