使用“名称”表| Aspose.Font for .NET

trueType字体表’name’是与该字体相关的文本字符串的存储。这些字符串可以用不同的语言编写,可以代表各种实体,例如字体名称,姓名,设计师名称,许可证信息,版权通知等。 简而言之,表“名称”中保存的线描述了字体元数据。

“名称”表格。

可访问“名称”表的详细规范 Microsoft和 Apple文档。

有2种为“名称”表的格式,具有数字0和1的格式。在“名称”表中,这些格式数字被称为版本,因此格式0被指定为 版本0,而格式1-为 版本1。

格式1在语言标识中与格式0不同。 “名称”表中的任何条目都有一个语言标识符,用于检测该字符串的语言。格式0和格式1之间的差异在于如何解释这些语言标识符。

格式0的语言标识符具有特定于平台的解释,但是格式1的语言标识符与语言标签字符串相关联,语言标签字符串识别语言,无论平台如何。

为了更准确,格式1允许保持两种类型的语言标识符 - 具有特定于平台的解释的标识符以及与语言标签字符串相关的标识符(即独立于平台)。

aspose.font库支持“名称”表的格式0。为将来的版本计划对格式1的支持。

独立于“名称”表的格式,此表中的任何条目基于特定组件 - 结构 namerecord。

该结构的四个主要参数是:

参数platformId,platformSpecificid和’LanagingId’用于以特定于平台的方式设置字符串的语言。参数的值platformspecificid和`andageningId’仅在platformID参数的上下文中很重要。

例如,platformSpecificid等于0为Mac平台定义了罗马脚本,同时,platformSpecificid定义了Windows平台的罗马脚本。 以类似的方式,“语言ID”的值仅在使用的PlatformID参数的上下文中很重要。

例如,LeganageniD“定义英语美国)等于platformID = 1(Mac)和0x0409的platformId` = 3(Windows)的0x0409。

对于名称表格式1,与语言标签字符串关联的名称表1仅是languageID,该语言不论平台如何标识语言。

参数nameId是一个数字,它标识了逻辑字符串类别,例如字体名称,姓名等。有一个名称标识符的 *预定义集,所有平台和语言都是相同的。

因此,表“名称”的每个条目都可以分为3个部分:

  1. 逻辑字符串类别,
  2. 字符串语言,
  3. 字符串本身。

参数nameId与第一部分相关,parametersPlatformID,platformspecificid和langagenhingId’‘与第二部分有关。

如何使用aspose.font使用“名称”表记录?

对“名称”表的支持由类 ttfnameTable提供。此外,我们考虑此对象的功能。 首先,让我们描述使用 ttfnamegable类功能所需的枚举。

如上所述,“参数platformspecificid的值和语言ID仅在platformId参数的上下文中很重要”。因此,当平台ID为0时,这定义了Unicode平台时,请使用 unicodeplatformspecificid枚举,当PlatformID为1(Macintosh平台)时,使用 *MacPlatFormSpecificid 枚举,并且PlatformID为3(Windows Platform)是3(Windows Platform),请使用 * msplatformspecificiEnmumeration。

枚举 mslanguageId和 MacLanguageID与LagenchalID参数有关。 使用 mslanguageId枚举,当平台ID为3(Windows Platform)时,使用 MacLanguageId eNumeration当平台ID为1(Macintosh Platform)时。

现在让我们继续从“名称表中获取和刷新条目”的问题。

如何从“名称”表中获取记录?

让我们从方法 getAllnameRecords()开始。该方法如下,从其名称中返回所有条目,而无需排除“名称”表的排除。实际上,该方法通常不经常被调用,因为在大多数情况下,用户不需要所有条目,因此要获取所需的条目,必须对条目列表进行彻底过滤。

问题是,即使在一个逻辑类别中,例如,例如,该类别的字符串数据也可以是不同的语言。因此,每个语言都需要在此逻辑类别的“名称”表中单独的条目。就像Fontfamily类别的数据以英语,法语和德语存在,Fontfamily类别将包含3个条目。

此外,语言条目本身可以分为几个条目,这些条目重合字符串数据值和languageID值,但因platformID 和 platformSpecificID参数的值而差异。

为了简化“名称”表aspose.font库中的数据采样。

MultanguageString类还提供下一个方法:

  1. 该记录用英语编写,因此具有mslanguageId.english_united_states或mslanguageId.english_united_kingdom的值。
  2. 该记录的platformID具有等于 fontenvironment.current.currentplatformid的值(在当前实现中3,宣布Microsoft Platform)。

如何在“名称”表中添加/更新记录?

类ttfnameTable提供了一种方法 ADDNAME以在“名称”表中添加或更新记录。

此方法创建了 namerecord类型的结构,并将其插入“名称”表中。如果记录与parametersplatformId,platformSpecificid,languageID 和 nameID相吻合,则该方法不会添加新记录,但是使用parameternamename’n name’n name’Snew falue froun new value中更新了现有记录中的字符串数据。

参数nameId定义了记录的逻辑字符串类别。参数platformId,platformSpecificid和’LanagingId’用于设置字符串的语言。最后一个参数“名称”用于为记录设置字符串数据。

使用 * ttfNameTable *对象的功能的示例。

包括用于以下名称空间:

1    using System;
2    using System.IO;
3    using System.Text;
4    using Aspose.Font;
5    using Aspose.Font.Sources;
6    using Aspose.Font.Ttf;
7    using Aspose.Font.TtfTables;

加载示例使用的字体

以下代码片段假定已从 DataDir 加载 TTF/montserrat-bold.ttf,并将其保存到名为 font 的 TtfFont 变量中。有关加载过程,请参阅 加载 TrueType 字体、提取数据并保存。

以下两个代码片段输出完整字体名称值。对于示例字体,两者都会返回 Montserrat Bold。

1// Read the full font name by name ID
2
3string fullFontName = font.TtfTables.NameTable.GetNameById(TtfNameTable.NameId.FullName);
4Console.WriteLine("Full font name: {0}", fullFontName);
1// Read the English full font name from multilingual metadata
2
3string fullFontName = font.TtfTables.NameTable.GetMultiLanguageNameById(TtfNameTable.NameId.FullName).GetEnglishString();
4Console.WriteLine("Full font name: {0}", fullFontName);

输出预定义名称 ID 的记录

以下代码片段枚举预定义的 TtfNameTable.NameId 值,并为每个有内容的类别输出各语言的可用字符串。

 1// Print name-table strings for predefined name IDs
 2
 3TtfNameTable.NameId[] ids = Enum.GetValues<TtfNameTable.NameId>();
 4
 5foreach (TtfNameTable.NameId nameId in ids)
 6{
 7    MultiLanguageString? mlString = font.TtfTables.NameTable.GetMultiLanguageNameById(nameId);
 8    if (mlString == null)
 9        continue;
10    Console.WriteLine(string.Format("{0}: {1}", nameId, GetMultiLanguageStringValue(mlString)));
11}
12// Format the available language values for each predefined name ID.
13string GetMultiLanguageStringValue(MultiLanguageString mlString)
14{
15    int[] languages = mlString.GetAllLanguageIds();
16    if (languages.Length == 1)
17        return mlString.GetEnglishString();
18
19    StringBuilder sb = new StringBuilder();
20
21    for (int i = 0; i < languages.Length; i++)
22    {
23        int langId = languages[i];
24        sb.Append(String.Format("{0}: {1}", (Enum.GetName<TtfNameTable.MSLanguageId>(
25            (TtfNameTable.MSLanguageId)langId) ?? langId.ToString()), mlString.GetStringForLanguageId(langId)));
26        if (i != (languages.Length - 1))
27            sb.Append(", ");
28    }
29
30    return sb.ToString();
31}

更新类别“字体亚家族名称”和“描述”的值

要在 name 表中添加或更新条目,请传入与字体现有记录一致的平台 ID、平台特定 ID 和语言 ID。该示例更新第一个匹配的字体子系列记录。由于示例字体没有描述记录,因此会使用第一个可用名称记录的 ID 创建一个描述记录。其他平台和语言变体保持不变。

 1// Update font subfamily and description records
 2
 3// Use tuples so the complete operation fits in one method without a helper type.
 4(TtfNameTable.NameId NameId, string StringData)[] recordsToUpdate =
 5{
 6    (TtfNameTable.NameId.FontSubfamily, "Italic"),
 7    (TtfNameTable.NameId.Description, "New description")
 8};
 9
10TtfNameTable.NameRecord? firstRecord = null;
11foreach (var updateData in recordsToUpdate)
12{
13    TtfNameTable.NameRecord[] records = font.TtfTables.NameTable.GetNameRecordsByNameId(updateData.NameId);
14    TtfNameTable.NameRecord record;
15    // Update only the first matching record, preserving its platform and language.
16    // If the category is absent, use the identifiers of an existing name record.
17    if (records.Length == 0)
18    {
19        firstRecord ??= GetFirstExistingRecord(font.TtfTables.NameTable);
20        record = firstRecord;
21    }
22    else
23    {
24        record = records[0];
25    }
26
27    font.TtfTables.NameTable.AddName(updateData.NameId, (TtfNameTable.PlatformId)record.PlatformId,
28        record.PlatformSpecificId, record.LanguageId, updateData.StringData);
29}
30
31TtfNameTable.NameRecord GetFirstExistingRecord(TtfNameTable table)
32{
33    foreach (TtfNameTable.NameId nameId in Enum.GetValues<TtfNameTable.NameId>())
34    {
35        TtfNameTable.NameRecord[] records = table.GetNameRecordsByNameId(nameId);
36        if (records.Length != 0)
37            return records[0];
38    }
39
40    TtfNameTable.NameRecord[] allRecords = table.GetAllNameRecords();
41    if (allRecords.Length == 0)
42        throw new InvalidOperationException("The name table has no record to supply platform and language identifiers.");
43    return allRecords[0];
44}

您可以在测试中找到“名称”表的其他示例 解决方案metadataexamples.cs。