Travailler avec la table 'name' | .NET

La table de polices TrueType « nom » est le stockage des chaînes de texte liées à cette police. Ces chaînes peuvent être écrites dans différentes langues et représenter diverses entités, telles que des noms de polices, des noms de famille, des noms de concepteurs, des informations de licence, des avis de droits d’auteur, etc. En bref, les lignes contenues dans la table « nom » décrivent les métadonnées de police.

Schéma de la table ’name'.

The detailed specification for ’name’ table is accessible in Microsoft and Apple documentations.

Il existe 2 formats pour une table « nom » avec les numéros 0 et 1 respectivement. En termes de table ’name’, ces numéros de format sont nommés comme version, donc le format 0 est désigné comme version 0 et le format 1 comme version 1.

Le format 1 diffère du format 0 dans l’identification de la langue. Toute entrée de la table ’name’ possède un identifiant de langue, qui est utilisé pour détecter la langue de cette chaîne. Et la différence entre le format 0 et le format 1 réside dans la manière dont ces identifiants de langue sont interprétés.

Les identifiants de langue pour le format 0 ont une interprétation spécifique à la plate-forme, mais les identifiants de langue pour le format 1 sont associés à des chaînes de balises de langue, qui identifient les langues quelle que soit la plate-forme.

Pour plus de précision, le format 1 permet de conserver les identifiants de langue des deux types : les identifiants avec une interprétation spécifique à la plate-forme et les identifiants associés aux chaînes de balises de langue (c’est-à-dire indépendants d’une plate-forme).

La bibliothèque Aspose.Font prend en charge le format 0 de la table ’name’. La prise en charge du format 1 est prévue pour les prochaines versions.

Indépendamment du format de la table ’name’, toute entrée de cette table est basée sur un composant particulier - la structure NameRecord.

Les quatre paramètres principaux de cette structure sont :

Les paramètres platformID, platformSpecificID et languageID sont utilisés pour définir la langue de la chaîne d’une manière spécifique à la plate-forme. Les valeurs des paramètres platformSpecificID et languageID n’ont d’importance que dans le contexte du paramètre platformID.

Par exemple, platformSpecificID égal à 0 définit le script romain pour la plate-forme Mac, et en même temps, platformSpecificID définit le script romain pour la plate-forme Windows.

De la même manière, la valeur de languageID n’a d’importance que dans le contexte du paramètre platformID utilisé.

Par exemple, languageID définissant l’anglais USA est égal à 0 pour platformID = 1 (Mac) et 0x0409 pour platformID = 3 (Windows).

Les exclusions sont uniquement langageID pour le format de table de noms 1, associé à une chaîne de balise de langue, qui identifie les langues quelle que soit la plateforme.

Le paramètre nameID est un nombre qui identifie une catégorie de chaîne logique, telle que le nom de la police, le nom de famille et autres. Il existe un ensemble prédéfini d’identifiants de nom, qui est le même pour toutes les plates-formes et toutes les langues.

Ainsi, chaque entrée de la table ’nom’ peut être conditionnellement divisée en 3 parties :

  1. catégorie de chaîne logique,
  2. langage de chaînes,
  3. la chaîne elle-même.

Le paramètre nameID est lié à la première partie, les paramètres platformID, platformSpecificID et langageID sont liés à la deuxième partie.

Comment travailler avec les enregistrements de la table « nom » à l’aide d’Aspose.Font ?

La prise en charge de la table ’name’ est fournie par la classe TtfNameTable. De plus, nous considérons la fonctionnalité de cet objet.

Tout d’abord, décrivons les énumérations nécessaires pour utiliser les fonctionnalités de la classe TtfNameTable.

Comme mentionné ci-dessus, “les valeurs des paramètres platformSpecificID et languageID n’ont d’importance que dans le contexte du paramètre platformID”. Ainsi, lorsque platformID est 0 et que cela définit la plate-forme Unicode, utilisez l’énumération UnicodePlatformSpecificId, lorsque platformID est 1 (plate-forme Macintosh), utilisez l’énumération MacPlatformSpecificId et lorsque platformID est 3 (plate-forme Windows), utilisez l’énumération MSPlatformSpecificId. .

Les énumérations MSLanguageId et MacLanguageId sont liées au paramètre LanguageID. Utilisez l’énumération MSLanguageId lorsque platformID est 3 (plate-forme Windows) et utilisez l’énumération MacLanguageId lorsque platformID est 1 (plate-forme Macintosh).

Passons maintenant à la question de l’obtention et de l’actualisation des entrées de la « table des noms ».

Comment récupérer les enregistrements de la table ’name’ ?

Commençons par la méthode GetAllNameRecords(). Cette méthode, comme son nom l’indique, renvoie toutes les entrées sans exclusions de la table ’name’. En pratique, la méthode n’est pas souvent appelée car dans la plupart des cas, les utilisateurs n’ont pas besoin de toutes les entrées, donc pour obtenir l’entrée nécessaire, la liste des entrées doit être soigneusement filtrée.

Le fait est que même dans une catégorie logique, FontFamily par exemple, les données de chaîne de cette catégorie peuvent être dans différentes langues. Ainsi, chaque langue a besoin d’une entrée distincte dans la table « nom » pour cette catégorie logique. Comme si les données de la catégorie FontFamily existaient en anglais, français et allemand, la catégorie FontFamily comprendrait 3 entrées.

De plus, l’entrée de langue peut elle-même être divisée en quelques entrées qui coïncident par les valeurs de données de chaîne et la valeur languageID, mais diffèrent par les valeurs des paramètres platformID et platformSpecificID.

Pour simplifier l’échantillonnage des données de la table ’name’, la bibliothèque Aspose.Font propose les méthodes suivantes :

La classe MultiLanguageString propose également les méthodes suivantes :

  1. Cet enregistrement est rédigé en anglais, il a donc la valeur MSLanguageId.English_United_States ou MSLanguageId.English_United_Kingdom pour le paramètre LanguageID.
  2. Cet enregistrement a platformID avec la valeur égale à FontEnvironment.Current.CurrentPlatformId (3 dans l’implémentation actuelle, qui déclare la plate-forme Microsoft).

Comment ajouter/mettre à jour des enregistrements dans la table ’name’ ?

La classe TtfNameTable fournit une méthode AddName pour ajouter ou mettre à jour des enregistrements dans la table ’name'.

Cette méthode crée la structure de type NameRecord et l’insère dans la table ’name’. Si l’enregistrement coïncide avec celui ajouté par les paramètres platformID, platformSpecificID, langueID et nameID existe déjà, la méthode n’ajoute pas de nouvel enregistrement, mais met à jour les données de chaîne dans l’enregistrement existant en utilisant la valeur , défini par le paramètre name.

Le paramètre nameId définit la catégorie de chaîne logique pour un enregistrement. Les paramètres platformId, platformSpecificId et lingualId sont utilisés pour définir la langue de la chaîne. Et le dernier paramètre « nom » est utilisé pour définir les données de chaîne pour un enregistrement.

Exemples d’utilisation des fonctions de l’objet TtfNameTable.

Incluez using pour les espaces de noms suivants :

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;

Chargement de la police utilisée dans les exemples

Les extraits suivants supposent que TTF/montserrat-bold.ttf a été chargé depuis DataDir dans une variable TtfFont nommée font. Consultez Chargement, extraction des données et enregistrement des polices TrueType pour connaître la procédure de chargement.

Les deux extraits suivants affichent la valeur Nom complet de la police. Tous deux renvoient Montserrat Bold pour la police d’exemple.

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);

Affichage des enregistrements pour les identifiants de nom prédéfinis

L’extrait suivant parcourt les valeurs prédéfinies de TtfNameTable.NameId et affiche les chaînes disponibles dans chaque langue pour chaque catégorie renseignée.

 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}

Mise à jour des valeurs des catégories « Nom de la sous-famille de police » et « Description »

Pour ajouter ou mettre à jour une entrée de la table name, transmettez des identifiants de plateforme, spécifiques à la plateforme et de langue correspondant aux enregistrements existants de la police. L’exemple met à jour le premier enregistrement Sous-famille de police correspondant. Comme la police d’exemple ne contient aucun enregistrement Description, il en crée un avec les identifiants du premier enregistrement de nom disponible. Les autres variantes de plateforme et de langue restent inchangées.

 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}

D’autres exemples pour actualiser la table ’name’ que vous pouvez trouver dans le test solution MetadataExamples.cs.