Core Text 编程指南03：常见字体操作

本章介绍了一些常见的字体处理操作，并展示了如何使用Core Text对它们进行编码。这些操作在iOS和OS X上是相同的。本章包含以下代码清单操作：

• 创建字体描述符
• 从字体描述符创建字体
• 创建相关字体
• 序列化字体
• 从序列化数据创建字体
• 改变字据
• 为角色获取字体

创建字体描述符

清单3-1中的示例函数从参数值创建字体描述符，指定PostScript字体名称和point大小。

清单3-1从名称和point大小创建字体描述符

CTFontDescriptorRef CreateFontDescriptorFromName(CFStringRef postScriptName,
                                              CGFloat size)
{
return CTFontDescriptorCreateWithNameAndSize(postScriptName, size);
}

清单3-2中的示例函数根据字体系列名称和字体特征创建字体描述符。

NSString* familyName = @"Papyrus";
CTFontSymbolicTraits symbolicTraits = kCTFontTraitCondensed;
CGFloat size = 24.0;

NSMutableDictionary* attributes = [NSMutableDictionary dictionary];
[attributes setObject:familyName forKey:(id)kCTFontFamilyNameAttribute];

// 属性字典包含另一个字典，特征字典，
// 在此示例中仅指定符号特征。
NSMutableDictionary* traits = [NSMutableDictionary dictionary];
[traits setObject:[NSNumber numberWithUnsignedInt:symbolicTraits]
                                       forKey:(id)kCTFontSymbolicTrait];

[attributes setObject:traits forKey:(id)kCTFontTraitsAttribute];
[attributes setObject:[NSNumber numberWithFloat:size]
                                     forKey:(id)kCTFontSizeAttribute];

CTFontDescriptorRef descriptor =
         CTFontDescriptorCreateWithAttributes((CFDictionaryRef)attributes);
CFRelease(descriptor);

从字体描述符创建字体

清单3-3显示了如何创建字体描述符并使用它来创建字体。当你调用CTFontCreateWithFontDescriptor 时，通常会为matrix参数传递NULL以指定默认（identity）矩阵。 CTFontCreateWithFontDescriptor 的大小和矩阵（第二个和第三个）参数会覆盖字体描述符中指定的任何参数，除非它们未指定（0.0表示大小，NULL表示矩阵）。

清单3-3从字体描述符创建字体

NSDictionary *fontAttributes =
              [NSDictionary dictionaryWithObjectsAndKeys:
                      @"Courier", (NSString *)kCTFontFamilyNameAttribute,
                      @"Bold", (NSString *)kCTFontStyleNameAttribute,
                      [NSNumber numberWithFloat:16.0],
                      (NSString *)kCTFontSizeAttribute,
                      nil];
// 创建描述符。
CTFontDescriptorRef descriptor =
      CTFontDescriptorCreateWithAttributes((CFDictionaryRef)fontAttributes);

// 使用描述符创建字体。
CTFontRef font = CTFontCreateWithFontDescriptor(descriptor, 0.0, NULL);
CFRelease(descriptor);

创建相关字体

将现有字体转换为相关或类似字体通常很有用。清单3-4中的示例函数显示了如何根据函数调用传递的Boolean参数的值使字体变粗或变粗。如果当前字体系列没有请求的样式，则该函数返回NULL。

清单3-4更改字体的特征

CTFontRef CreateBoldFont(CTFontRef font, Boolean makeBold)
{
CTFontSymbolicTraits desiredTrait = 0;
CTFontSymbolicTraits traitMask;

// 如果请求字体为粗体，请将所需特征设置为粗体。
if (makeBold) desiredTrait = kCTFontBoldTrait;

// 掩盖粗体特征以表明它是唯一要修改的特征。由于CTFontSymbolicTraits是一个位字段，如果需要可以更改多个特征。
traitMask = kCTFontBoldTrait;

// 创建原始字体的副本，并将屏蔽的特征设置为所需的值。如果字体系列没有合适的样式，则返回NULL。

return CTFontCreateCopyWithSymbolicTraits(font, 0.0, NULL, desiredTrait, traitMask);
}

清单3-8中的示例函数将给定字体转换为另一个字体系列中的类似字体，如果可能，保留特征。它可能返回NULL。传入0.0表示size参数，NULL表示矩阵参数，保留原始字体的大小。

清单3-5将字体转换为另一个系列

CTFontRef CreateFontConvertedToFamily(CTFontRef font, CFStringRef family)
{
// 使用新系列创建原始字体的副本。此调用尝试保留特征，如果不可能，则可能返回NULL。传入0.0和NULL表示大小和矩阵以保留值
// the original font.

return CTFontCreateCopyWithFamily(font, 0.0, NULL, family);
}

序列化字体

清单3-6中的示例函数显示了如何创建XML数据以序列化可嵌入文档中的字体。或者，并且优选地，可以使用NSArchiver。这只是完成此任务的一种方法，但它保留了以后重新创建确切字体所需的字体中的所有数据。

清单3-6序列化字体

CFDataRef CreateFlattenedFontData(CTFontRef font)
{
CFDataRef           result = NULL;
CTFontDescriptorRef descriptor;
CFDictionaryRef     attributes;

// 获取字体的字体描述符。
descriptor = CTFontCopyFontDescriptor(font);

if (descriptor != NULL) {
    // 从描述符中获取字体属性。这应该足以在以后重新创建描述符和字体。
    attributes = CTFontDescriptorCopyAttributes(descriptor);

    if (attributes != NULL) {
        // 如果属性是有效的属性列表，则直接展平属性列表。否则，我们可能需要分析属性并删除或手动将它们转换为可序列化的表单。这留给读者练习。
       if (CFPropertyListIsValid(attributes, kCFPropertyListXMLFormat_v1_0)) {
            result = CFPropertyListCreateXMLData(kCFAllocatorDefault, attributes);
        }
    }
}
return result;
}

从序列化数据创建字体

清单3-7中的示例函数显示了如何从展平的XML数据创建字体引用。它显示了如何解除字体属性并使用这些属性创建字体。

清单3-7从序列化数据创建字体

CTFontRef CreateFontFromFlattenedFontData(CFDataRef iData)
{
CTFontRef           font = NULL;
CFDictionaryRef     attributes;
CTFontDescriptorRef descriptor;

// 从属性列表中创建我们的字体属性。为简单起见，此示例创建一个不可变对象。如果您需要按摩或将某些属性从其可序列化的表单转换为Core Text可用表单，请在此处执行。
attributes =
      (CFDictionaryRef)CFPropertyListCreateFromXMLData(
                           kCFAllocatorDefault,
                           iData, kCFPropertyListImmutable, NULL);
if (attributes != NULL) {
    // 从属性创建字体描述符。
    descriptor = CTFontDescriptorCreateWithAttributes(attributes);
    if (descriptor != NULL) {
        // 从字体描述符创建字体。此示例使用0.0和NULL作为大小和矩阵参数。这导致使用描述符中存在的大小和/或矩阵创建字体（如果存在）。否则使用默认值。
        font = CTFontCreateWithFontDescriptor(descriptor, 0.0, NULL);
    }
}
return font;
}

改变字距

默认情况下启用连字和字距调整。要禁用，请将kCTKernAttributeName属性设置为0.清单3-8将kern大小设置为绘制的前几个字符的大数字。

清单3-8设置字距调整

// 使用先前定义的红色CGColor对象将前13个字符的颜色设置为红色。
CFAttributedStringSetAttribute(attrString, CFRangeMake(0, 13),
                                  kCTForegroundColorAttributeName, red);
// 将前18个字符之间的字距调整为20
CGFloat otherNum = 20;
CFNumberRef otherCFNum = CFNumberCreate(NULL, kCFNumberCGFloatType, &otherNum);
CFAttributedStringSetAttribute(attrString, CFRangeMake(0,18),
                                       kCTKernAttributeName, otherCFNum);

为字符获取字形

清单3-9显示了如何使用单个字体获取字符串中字符的字形。大多数情况下，你应该只使用CTLine对象来获取此信息，因为一种字体可能不会对整个字符串进行编码。此外，简单的字符到字形映射将无法获得复杂脚本的正确外观。如果你尝试显示字体的特定Unicode字符，则此简单字形映射可能是适当的。

清单3-9获取字符的字形

void GetGlyphsForCharacters(CTFontRef font, CFStringRef string)
{
// 获取字符串长度。
CFIndex count = CFStringGetLength(string);

// 为字符和字形分配缓冲区。
UniChar *characters = (UniChar *)malloc(sizeof(UniChar) * count);
CGGlyph *glyphs = (CGGlyph *)malloc(sizeof(CGGlyph) * count);

// 从字符串中获取字符。
CFStringGetCharacters(string, CFRangeMake(0, count), characters);

// 获取字符的字形。
CTFontGetGlyphsForCharacters(font, characters, glyphs, count);

// 在这里用字形做一些事情。未通过此字体映射的字符将为零。
// ...

// 释放 buffers
free(characters);
free(glyphs);
}

上一章	目录	下一章