Работа с таблицей name | .NET
Таблица шрифтов TrueType «имя» — это хранилище текстовых строк, связанных с этим шрифтом. Эти строки могут быть написаны на разных языках и могут представлять различные объекты, такие как имена шрифтов, фамилии, имена дизайнеров, информацию о лицензии, уведомления об авторских правах и т. д. Короче говоря, строки, содержащиеся в таблице «имя», описывают метаданные шрифта.
Схема таблицы «имя»
Существует два формата таблицы «имя» с номерами 0 и 1 соответственно. В таблице name эти номера форматов называются версией, поэтому формат 0 обозначается как версия 0, а формат 1 - как версия 1.
Формат 1 отличается от формата 0 идентификацией языка. Любая запись в таблице name имеет идентификатор языка, который используется для определения языка этой строки. А разница между форматом 0 и форматом 1 заключается в том, как интерпретируются эти идентификаторы языка.
Идентификаторы языка для формата 0 интерпретируются в зависимости от платформы, но идентификаторы языка для формата 1 связаны со строками языковых тегов, которые идентифицируют языки независимо от платформы.
Для большей точности формат 1 позволяет хранить идентификаторы языка обоих типов — идентификаторы с интерпретацией, зависящей от платформы, и идентификаторы, связанные со строками языковых тегов (т. е. независимые от платформы).
Библиотека Aspose.Font поддерживает формат 0 таблицы name. Поддержка формата 1 запланирована в будущих выпусках.
Независимо от формата таблицы name, любая запись в этой таблице основана на определенном компоненте — структуре NameRecord.
Четыре основных параметра этой структуры:
- идентификатор платформы(platformID),
- идентификатор платформы (platformSpecificID),
- идентификатор имени (nameid),
- и идентификатор языка (languageID).
Параметры «platformID», «platformSpecificID» и «languageID» используются для установки языка строки в зависимости от платформы. Значения параметров «platformSpecificID» и «languageID» имеют значение только в контексте параметра «platformID».
Например, platformSpecificID, равный 0, определяет латинский алфавит для платформы Mac, и в то же время platformSpecificID определяет латинский алфавит для платформы Windows.
Аналогично, значение «languageID» имеет значение только в контексте используемого параметра «ID платформы».
Например, languageID, определяющий английский язык США, равен 0 для идентификатора платформы = 1 (Mac) и 0x0409 для platformID = 3 (Windows).
Исключениями являются только languageID для формата таблицы имен 1, связанного со строкой языкового тега, которая идентифицирует языки независимо от платформы.
Параметр nameID — это число, которое идентифицирует категорию логической строки, например имя шрифта, фамилию и другие. Существует предопределенный набор идентификаторов имен, который одинаков для всех платформ и языков.
Итак, каждую запись таблицы name условно можно разделить на 3 части:
- категория логической строки,
- строковый язык,
- сама строка.
Параметр «nameID» относится к первой части, параметры «platformID», «platformSpecificID» и «languageID» относятся ко второй части.
Как работать с записями таблицы «имя» с помощью Aspose.Font?
Поддержка таблицы name обеспечивается классом TtfNameTable. Далее рассмотрим функционал данного объекта.
Сначала опишем перечисления, необходимые для работы с функциональностью класса TtfNameTable.- Перечисления NameID и PlatformId относятся к таким параметрам, описанным выше, как nameID и PlatformID.
- Перечисления UnicodePlatformSpecificId, MacPlatformSpecificId, MSPlatformSpecificId связаны с параметром PlatformSpecificID.
Как было сказано выше, «Значения параметров PlatformSpecificID и LanguageID имеют значение только в контексте параметра PlatformID». Итак, когда идентификатор платформы равен 0 и это определяет платформу Unicode, используйте перечисление UnicodePlatformSpecificId, когда идентификатор платформы равен 1 (платформа Macintosh), используйте перечисление MacPlatformSpecificId, а когда идентификатор платформы равен 3 (платформа Windows), используйте перечисление MSPlatformSpecificId .
Перечисления MSLanguageId и MacLanguageId относятся к параметру LanguageID.
Используйте перечисление MSLanguageId, если идентификатор платформы равен 3 (платформа Windows), и используйте перечисление MacLanguageId, если идентификатор платформы равен 1 (платформа Macintosh).
Теперь приступим к получению и обновлению записей из таблицы имен.
Как получить записи из таблицы name?
Начнем с метода GetAllNameRecords(). Этот метод, как следует из названия, возвращает все записи без исключения таблицы name. На практике метод вызывается нечасто, так как пользователям в большинстве случаев не нужны все записи, поэтому для получения нужной записи список записей приходится тщательно фильтровать.
Дело в том, что даже в одной логической категории, например FontFamily, строковые данные этой категории могут быть на разных языках. Таким образом, для каждого языка требуется отдельная запись в таблице «имя» для этой логической категории. Например, если данные для категории FontFamily существуют на английском, французском и немецком языках, категория FontFamily будет включать 3 записи.
Кроме того, запись языка сама по себе может быть разделена на несколько записей, которые совпадают по значениям строковых данных и значению languageID, но различаются значениями параметров platformID и platformSpecificID.
Для упрощения выборки данных из таблицы name библиотека Aspose.Font предлагает следующие методы:
- GetNameRecordsByNameId() - возвращает список записей для заданной пользователем логической категории, определенной параметром
nameID. - GetMultiLanguageNameById() - возвращает все записи, соответствующие переданному nameID логической категории, в виде объекта типа MultiLanguageString. С помощью объекта типа - MultiLanguageString мы можем узнать все языки данной категории и получить строковые данные для заданного языка. Список всех языков можно получить, вызвав метод GetAllLanguageIds() типа MultiLanguageString. После получения списка языков мы можем вызвать метод GetStringForLanguageId() для каждого идентификатора языка. Этот метод возвращает строку данных, написанную на этом языке.
Класс MultiLanguageString также предлагает следующие методы:
ContainsString (string str) – проверяет, присутствует ли переданная строка внутри всех языковых строк объекта.
GetEnglishString() — возвращает строку, написанную на английском языке, если она найдена. Он возвращает первую строку, идентификатор языка которой — MSLanguageId.English_United_States, MSLanguageId.English_Australia, MSLanguageId.English_United_Kingdom, MSLanguageId.English_Canada или MSLanguageId.English_New_Zealand. Если строк с соответствующим идентификатором языка нет, метод возвращает первую строку списка.
GetAllStrings() — возвращает все строки всех языков, входящих в состав объекта.
Самый простой в использовании метод класса TtfNameTable — это GetNameById(), который был разработан для случаев, когда вам нужно только получить значение для заданной категории на английском языке. Этот метод ищет запись, соответствующую 2 критериям:
- Эта запись написана на английском языке, поэтому она имеет значение MSLanguageId.English_United_States или MSLanguageId.English_United_Kingdom для параметра LanguageID.
- Эта запись имеет идентификатор платформы со значением, равным FontEnvironment.Current.CurrentPlatformId (3 в текущей реализации, которая объявляет платформу Microsoft).
Как добавить/обновить записи в таблице «имя»?
Класс TtfNameTable предоставляет метод AddName для добавления или обновления записей в таблице name.
Этот метод создает структуру типа
NameRecord и вставляет ее в таблицу name. Если запись совпадает с добавленной по параметрам «platformID», «platformSpecificID», «languageID», «nameID» уже существует, метод не добавляет новую запись, а обновляет строковые данные в существующей записи, используя значение , определяемый параметром name.
Параметр nameId определяет категорию логической строки для записи. Параметры «platformId», «platformSpecificId» и «languageId» используются для установки языка строки. И последний параметр name используется для установки строковых данных для записи.
Примеры использования функций объекта 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;Загрузка шрифта, используемого в примерах
В следующих фрагментах предполагается, что TTF/montserrat-bold.ttf загружен из DataDir в переменную TtfFont с именем font. Процедура загрузки описана в разделе
Загрузка, извлечение данных и сохранение шрифтов 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);Вывод записей для предопределённых идентификаторов имён
Следующий фрагмент перебирает предопределённые значения 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, передайте идентификаторы платформы, кодировки платформы и языка, совпадающие с существующими записями шрифта. В примере обновляется первая подходящая запись Подсемейство шрифта. Поскольку в тестовом шрифте нет записи Описание, она создаётся с идентификаторами первой доступной записи имени. Остальные варианты для платформ и языков не изменяются.
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}Другие примеры обновления таблицы name вы можете найти в тесте solution MetadataExamples.cs.