使用“名称”表| C ++

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

“名称”表格。

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

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

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

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

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

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

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

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

平台标识符(平台ID)，
平台特异性标识符(平台应用程序)，
名称标识符(名称)，
和语言标识符(语言ID)。

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

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

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

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

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

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

逻辑字符串类别，
字符串语言，
字符串本身。

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

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

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

枚举 nameId和 platformid与上述参数相关。
枚举 unicodeplatformspecificid， macPlatformspecificid与参数platformspecificid有关。

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

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

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

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

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

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

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

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

getNamereCordsByNameId() - 返回由用户逻辑类别集合的条目列表，该条目由nameId参数定义了。
getMultilanguagenamebyid() - 返回所有条目，与传递的逻辑类别nameid相关，作为 MultiLanguageString类型的对象。通过 - * MultinanguageString 类型的对象，我们可以找出此类别的所有语言，并获取SET语言的字符串数据。您可以通过调用MultinanguageString*类型的方法来获取所有语言的列表。收到语言列表后，我们可以调用每种语言ID的 getStringForlangueId()方法。此方法返回使用此语言编写的数据字符串。

MultanguageString类还提供下一个方法：

包含斯特林(String str) - 检查对象的所有语言字符串中是否存在传递的字符串。
getEnglishString() - 如果发现，则返回用英语写的字符串。它返回第一个字符串，其中的语言是mslanguageId.english_united_states，mslanguageid.english_australia，mslanguageid.england.english_united_kingdom，mslanguageid.english_canada或mslanguageId.englugageId.englanguageId.englishId.english_ens_new_zealand。如果没有相关语言标识符的字符串，则该方法将返回列表的第一个字符串。
getallstrings() - 返回对象包含的所有语言的所有字符串。
使用类ttfnameTable的最简单方法是 getNameByid()，它是针对您仅需要以英语获得设定类别的值的情况而设计的。此方法寻找记录，该记录与2个标准相对应：

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

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

类 TtfNameTable 提供了一个方法 AddName，用于在 ’name’ 表中添加或更新记录。此方法创建类型 NameRecord 的结构并将其插入到 ’name’ 表中。如果该记录与参数 platformID、platformSpecificID、languageID 和 nameID 添加的记录相符，并且 nameID 已经存在，则该方法不会添加新记录，而是使用参数 name 定义的值更新现有记录中的字符串数据。

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

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

添加包括并使用名称空间：

 1#include <system/text/string_builder.h>
 2#include <系统/Enum.h>
 3#include <system/console.h>
 4#include <system/collections/list.h>
 5#include <aspose.font.cpp/src/ttftables/ttfnametable.h>
 6#include <aspose.font.cpp/src/ttftables/ttftableRepository.h>
 7#include <aspose.font.cpp/src/ttf/ttffont.h>
 8#include <aspose.font.cpp/src/multinanguagestring.h>
 9#include <aspose.font.cpp/src/fonttype.h>
10#include <aspose.font.cpp/src/font.h>
11
12using namespace System;
13using namespace Aspose::Font::Ttf;
14using namespace Aspose::Font::TtfTables;

声明和初始化字体变量。

1	System::SharedPtr<Aspose::Font::Ttf::TtfFont> _font;

下一个2个类别的片段打印值 *完整字体名称 *并为字体lora-regular产生相同的结果

1    //1
2	String fullFontName = _font->get_TtfTables()->get_NameTable()->GetNameById(TtfNameTable::NameId::FullName);
3	Console::WriteLine(String::Format(u"Full font name: {0}", fullFontName));
4	//2
5	String fullFontName = _font->get_TtfTables()->get_NameTable()->GetMultiLanguageNameById(TtfNameTable::NameId::FullName)->GetEnglishString();
6	Console::WriteLine(String::Format(u"Full font name: {0}", fullFontName));

打印“名称”表的全部内容。

下面的摘要显示了如何完成此操作。

 1    System::ArrayPtr<TtfNameTable::NameId> ids = System::Enum<TtfNameTable::NameId>::GetValues();
 2    
 3    for (TtfNameTable::NameId nameId : ids)
 4    {
 5        System::SharedPtr<MultiLanguageString> mlString = _font->get_TtfTables()->get_NameTable()->GetMultiLanguageNameById(nameId);
 6        if (mlString == nullptr)
 7        {
 8            continue;
 9        }
10        System::Console::WriteLine(System::String::Format(u"{0}: {1}", nameId, GetMultiLanguageStringValue(mlString)));
11    }
12
13    //Using of this method has no sense when strings from 'name' table have only single language, but it can be useful when font
14    //'name' table include multilingual strings
15    System::String MetadataExamples::GetMultiLanguageStringValue(System::SharedPtr<MultiLanguageString> mlString)
16    {
17        System::ArrayPtr<int32_t> languages = mlString->GetAllLanguageIds();
18        if (languages->get_Length() == 1)
19        {
20            return mlString->GetEnglishString();
21        }
22        
23        System::SharedPtr<System::Text::StringBuilder> sb = System::MakeObject<System::Text::StringBuilder>();
24        
25        for (int32_t i = 0; i < languages->get_Length(); i++)
26        {
27            int32_t langId = languages[i];
28            sb->Append(System::String::Format(u"{0}: {1}", System::Enum<TtfNameTable::MSLanguageId>::GetName((TtfNameTable::MSLanguageId)langId), mlString->GetStringForLanguageId(langId)));
29            if (i != (languages->get_Length() - 1))
30            {
31                sb->Append(u", ");
32            }
33        }
34        
35        return sb->ToString();
36    }

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

要正确添加或刷新表“名称”中的条目，我们需要传递platformID，platformspecificid和Laganagening ID参数的值，这些值与已经存在的“名称”表中的参数相吻合。为此，在刷新数据之前，我们将阅读与名称标识符定义的与刷新逻辑类别相关的名称类型的现有记录。

 1	//Struct for update operations
 2	struct UpdateData
 3	{
 4	private:
 5		TtfNameTable::NameId _nameId;
 6		System::String _data;
 7
 8	public:
 9		UpdateData(TtfNameTable::NameId nameId, String data)
10		{
11			this->_nameId = nameId;
12			this->_data = data;
13		}
14
15		TtfNameTable::NameId get_NameId() const
16		{
17			return this->_nameId;
18		}
19
20		String get_StringData() const
21		{
22			return this->_data;
23		}
24	};
25
26	UpdateData recordsToUpdate[] = {
27		UpdateData(TtfNameTable::NameId::FontSubfamily, String(u"Italic")),
28		UpdateData(TtfNameTable::NameId::Description, String(u"New description"))};
29
30	SharedPtr<TtfNameTable::NameRecord> firstRecord = nullptr;
31
32	for(UpdateData updateData : recordsToUpdate)
33	{
34		//Declare variable for NameRecord structure to use for update operations
35		SharedPtr<TtfNameTable::NameRecord> record = nullptr;
36
37		System::ArrayPtr<System::SharedPtr<TtfNameTable::NameRecord>> records = _font->get_TtfTables()->get_NameTable()->GetNameRecordsByNameId(updateData.get_NameId());
38
39		//In this example we will use only info from the first NameRecord structure returned to update font metadata.
40		//Many actual fonts require serious analyze of all NameRecords returned to update metadata correctly
41
42		//Initialize just created variables
43		if (records->get_Length() == 0)
44		{
45			//If no any record was found for current name identifer,
46			//we will use first found record for any name identifier
47			if (firstRecord == nullptr)
48			{
49				firstRecord = GetFirstExistingRecord(_font->get_TtfTables()->get_NameTable());
50			}
51			record = firstRecord;
52		}
53		else
54		{
55			record = records[0];
56		}
57
58		//Add or update record in 'name' table
59		_font->get_TtfTables()->get_NameTable()->AddName(updateData.get_NameId(), StaticCast<TtfNameTable::PlatformId>(record->get_PlatformId()), record->get_PlatformSpecificId(), record->get_LanguageId(), updateData.get_StringData());
60	}
61		
62	System::SharedPtr<Aspose::Font::TtfTables::TtfNameTable::NameRecord> MetadataExamples::GetFirstExistingRecord(System::SharedPtr<Aspose::Font::TtfTables::TtfNameTable> table)
63	{
64	    System::ArrayPtr<System::SharedPtr<TtfNameTable::NameRecord>> records;
65	    for (TtfNameTable::NameId nameId : System::Enum<TtfNameTable::NameId>::GetValues())
66	    {
67	        records = table->GetNameRecordsByNameId(nameId);
68	        if (records->get_Length() != 0)
69	        {
70	            return records[0];
71	        }
72	    }
73        
74	    return table->GetAllNameRecords()->idx_get(0);
75	}

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

使用TrueType字体渲染文本使用类型1字体