Spécifiez TrueType Emplacement des polices

Cette rubrique décrit le comportement par défaut de Aspose.Words lorsqu’il recherche des polices TrueType, y compris les différences spécifiques au système d’exploitation, et montre comment spécifier les sources de polices utilisateur.

La classe FontSourceBase est utilisée pour spécifier diverses sources de polices. Il existe plusieurs implémentations de la classe FontSourceBase:

Les détails d’implémentation pour certaines classes sont expliqués ci-dessous.

Charger des polices à partir du système

Il existe une classe spéciale SystemFontSource qui est toujours utilisée par défaut. Il représente toutes les polices TrueType installées sur le système. Par conséquent, il est possible de créer une liste de sources avec SystemFontSource et toutes les autres sources requises:

Une seule instance de la classe SystemFontSource est définie par défaut dans FontSettings. Sur différents systèmes d’exploitation, les polices peuvent être situées à des endroits différents. Cependant, l’utilisation d’une instance FontSettings pour chaque document n’est pas une solution optimale. Dans la majorité des cas, l’utilisation de DefaultInstance devrait suffire.

Les instances par document ne sont nécessaires que s’il est nécessaire d’utiliser différentes sources de polices pour différents documents, ce qui est un cas rare. L’utilisation de plusieurs instances FontSettings diminue les performances car elles ne partagent pas le cache.

Où Aspose.Words Recherche TrueType Polices sur Windows

Dans la plupart des cas, les utilisateurs Windows ne rencontrent pas de problèmes importants avec des polices manquantes ou des mises en page incorrectes. En règle générale, Aspose.Words parcourt un document et lorsqu’il rencontre le lien d’une police, il récupère avec succès les données de la police à partir du dossier système.

Sur Windows, Aspose.Words prend d’abord toutes les polices disponibles dans le dossier _%windir%\Fonts. Ce paramètre fonctionnera pour vous la plupart du temps. Vous ne spécifiez vos propres dossiers de polices que si vous en avez besoin. Aspose.Words recherche également les polices supplémentaires enregistrées dans la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts. De plus, Windows 10 permet l’installation de polices pour l’utilisateur actuel. Les polices sont placées dans le dossier %userprofile%\AppData\Local\Microsoft\Windows\Fonts et également spécifiées dans le registre HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Fonts, où Aspose.Words recherchera ces polices.

Si un document contient des polices incorporées, Aspose.Words peut lire les données de police pertinentes du document et les utiliser pour créer la mise en page du document. Les documents peuvent également contenir des liens vers des polices qui ne se trouvent pas dans les dossiers système, auquel cas les scénarios suivants s’appliquent:

  • Les utilisateurs peuvent configurer de nouvelles sources de polices via la classe FontSettings
  • Aspose.Words peut essayer de remplacer la police manquante par une police similaire

Polices sur des systèmes autres queWindows

Aspose.Words recherchera les polices dans les dossiers de polices système. Une liste de ces dossiers peut être vue par la méthode GetSystemFontFolders. Si aucune police prise en charge n’est trouvée, Aspose.Words utilisera la police par défaut intégrée Fanwood.ttf.

Étant donné que les métriques de police de Windows et nonWindows OS sont différentes, Aspose.Words fait tout son possible pour trouver une police similaire et créer une mise en page similaire à l’original. Cependant, ce n’est pas toujours possible. Dans ces cas, la classe FontSettings doit être utilisée pour ajouter des polices personnalisées ou des règles de substitution.

Où Aspose.Words Recherche TrueType Polices sur Linux

Différentes distributions Linux peuvent stocker des polices dans des dossiers différents. Aspose.Words recherche des polices à plusieurs endroits. Par défaut, Aspose.Words recherche les polices dans tous les emplacements suivants: /usr/share/fonts, /usr/local/share/fonts, /usr/X11R6/lib/X11/fonts. Ce comportement par défaut fonctionnera pour la plupart des distributions Linux, mais il n’est pas garanti qu’il fonctionnera tout le temps, auquel cas vous devrez peut-être spécifier explicitement l’emplacement des polices true type. Pour ce faire, vous devez savoir où les polices TrueType sont installées sur votre distribution Linux.

Où Aspose.Words Recherche TrueType Polices sur Mac OS X

Aspose.Words recherche les polices dans le dossier /Library/Fonts, qui est l’emplacement standard pour les polices TrueType sur Mac OS X. Bien que ce paramètre fonctionne pour vous la plupart du temps, vous devrez peut-être spécifier vos propres dossiers de polices au cas où vous en auriez besoin.

TrueType Polices sur Android

Sur Android, le flux de travail des polices est encapsulé dans la classe Typeface. Il existe cinq types de polices de caractères, chaque police de caractères représente un groupe de familles de polices similaires:

  • DEFAULT
  • DEFAULT_BOLD
  • MONOSPACE
  • SANS_SERIF
  • SERIF

Par exemple, selon Android ' s fonts.xml fichier de configuration, “times” appartient à la famille “serif” donc NotoSerif - Régulier.ttf sera utilisé lorsque des “heures” sont demandées:

Fonts.xml

<family name="serif">
        <font weight="400" style="normal">NotoSerif-Regular.ttf</font>
        <font weight="700" style="normal">NotoSerif-Bold.ttf</font>
        <font weight="400" style="italic">NotoSerif-Italic.ttf</font>
        <font weight="700" style="italic">NotoSerif-BoldItalic.ttf</font>
</family>
<alias name="times" to="serif" />
<alias name="times new roman" to="serif" />

Pour rechercher des polices similaires, les stratégies décrites précédemment sont utilisées.

En plus d’eux, Aspose.Words a sa propre liste de remplacements pour la plate-forme Android.

Supposons que le document contienne la police PMingLiU-ExtB, tout d’abord, Aspose.Words recherche la police requise dans les sources système.

La liste par défaut des dossiers de polices Android est:

  • /système / polices
  • /système / police
  • /données / polices

Le Aspose.Words regarde à travers les sources définies par l’utilisateur qui ont été définies avec la méthode:

Java

fontSettings.setFontsFolder("/home/user/MyFonts", true);

Dans le cas où un remplacement explicite a été spécifié, Aspose.Words remplace la police manquante par la suggestion de l’utilisateur:

Java

fontSettings.getSubstitutionSettings().getTableSubstitution().setSubstitutes("PMingLiU-ExtB", "Liberation Serif");

Si aucune des règles n’a fonctionné, Aspose.Words vérifie la table de remplacement interne. Si le tableau contient des informations sur un bon ajustement, la police est remplacée. Dans notre cas, Aspose.Words sélectionnera Typeface.SERIF. Mais si la table ne sait rien de la police demandée, Aspose.Words choisit une police basée sur des règles de mots spéciales MS ou sur la distance la plus proche dans l’espace Panose.

TrueType Polices sur .NET Core et Xamarin

Pour .NET Core et Xamarin la même règle s’applique que pour Aspose.Words pour la version Java. Par défaut, toutes les polices système de la plate-forme sur laquelle l’application s’exécute sont disponibles. La liste des dossiers dans lesquels la recherche sera effectuée peut être trouvée en appelant la méthode:

Java

SystemFontSource().getAvailableFonts()

Charger les polices à partir du dossier

Si le document en cours de traitement contient des liens vers des polices qui ne sont pas sur le système, ou si vous ne souhaitez pas les ajouter au dossier système, ou si vous n’avez pas les autorisations, la meilleure solution serait d’ajouter un dossier avec vos propres polices en utilisant la méthode SetFontsSources. Cela permettra de remplacer la source système par une source utilisateur. Aspose.Words ne recherchera plus les polices dans le registre ou le dossier Windows\Font et recherchera uniquement les polices dans le(s) dossier (s) spécifié (s). La méthode GetFontSources renverra les valeurs correspondantes.

Spécifiez un ou Plusieurs dossiers de polices

Les méthodes SetFontsFolder et SetFontsFolders sont des raccourcis vers la méthode SetFontSources avec une ou plusieurs instances FolderFontSource. Ces méthodes sont utilisées pour indiquer où Aspose.Words doit rechercher les polices. Si un dossier n’existe pas ou n’est pas accessible, Aspose.Words ignore simplement ce dossier. Si tous les dossiers, y compris les sources pour la substitution de police, ont été ignorés, Aspose.Words utilisera la police Fanwood par défaut.

L’exemple suivant montre comment définir le dossier ou la source, que Aspose.Words utilisera ensuite pour rechercher les polices TrueType lors du rendu ou de l’incorporation des polices:

Un paramètre booléen supplémentaire contrôle si les polices sont analysées de manière récursive dans tous les dossiers, analysant ainsi tous les dossiers enfants d’un dossier spécifié. L’exemple suivant montre comment définir Aspose.Words pour rechercher les polices TrueType dans plusieurs dossiers lors du rendu ou de l’incorporation de polices:

Vous pouvez télécharger le fichier modèle de cet exemple à partir de Aspose.Words GitHub.

Si vous ne souhaitez pas du tout utiliser de polices système, Aspose.Words vous permet de les ignorer et d’utiliser uniquement vos propres polices:

Java

FontSettings.getDefaultInstance().setFontsFolder("C:\\MyFonts\\", true);

Propriété Prioritaire

La propriété Priority est utilisée lorsqu’il existe des polices avec le même nom de famille et le même style dans différentes sources de polices. Dans ce cas, Aspose.Words sélectionne la police de la source avec la valeur de priorité la plus élevée. Par exemple, il existe une ancienne version de la police dans le dossier système et le client a ajouté une nouvelle version de la même police dans un dossier personnalisé.

Charger des polices à partir du flux

Aspose.Words fournit la classe StreamFontSource, qui permet de charger des polices à partir du flux. Pour utiliser la source de police stream, un utilisateur doit créer une classe dérivée de StreamFontSource et fournir une implémentation de la méthode OpenFontDataStream. La méthode OpenFontDataStream peut être appelée plusieurs fois. Pour la première fois, il sera appelé lorsque Aspose.Words analysera les sources de polices fournies pour obtenir une liste des polices disponibles. Plus tard, il peut être appelé si la police est utilisée dans le document pour analyser les données de police et pour incorporer les données de police dans certains formats de sortie. StreamFontSource peut être utile car il permet de charger les données de police uniquement lorsque cela est nécessaire, et de ne pas les stocker en mémoire pour la durée de vie FontSettings.

StreamFontSource

Enregistrer et charger un Cache de recherche de polices

Lors de la première recherche d’une police, Aspose.Words parcourt les sources de polices spécifiées par l’utilisateur et forme un cache de recherche de polices basé sur les données de ces sources. Ainsi, le cache collectera des informations sur les polices disponibles: famille de polices, style, nom complet de la police, etc. Lors des appels suivants, Aspose.Words recherche des informations sur la police souhaitée par son nom dans le cache de recherche de polices, après quoi il analyse les fichiers spécifiés pour utiliser la police.

La procédure d’analyse de tous les fichiers de polices disponibles pour initialiser le cache prend beaucoup de temps. Aspose.Words vous permet d’enregistrer et de charger le cache à l’aide de la méthode FontSettings.SaveSearchCache pour résoudre le problème de performances. Autrement dit, l’utilisateur peut charger un cache précédemment enregistré à partir d’un fichier et ignorer l’étape d’analyse de tous les fichiers de polices disponibles.

Obtenir une liste des polices disponibles

Si vous souhaitez obtenir la liste des polices disponibles, qui, par exemple, peuvent être utilisées pour afficher un document PDF, vous pouvez utiliser la méthode GetAvailableFonts, comme illustré dans l’exemple de code suivant. La classe PhysicalFontInfo spécifie des informations sur la police physique disponible pour le moteur de polices Aspose.Words:

Installer TrueType Polices sur Linux dans Java