Personnaliser les polices PowerPoint dans .NET
Aperçu
Aspose.Slides vous permet d’utiliser des polices personnalisées dans les présentations sans les installer sur le système d’exploitation. Vous pouvez charger des polices depuis des dossiers personnalisés, fournir des polices pour une présentation spécifique via des sources de polices au niveau du document, ou charger des polices externes directement à partir de données binaires.
Les polices chargées sont utilisées lors du rendu ou de l’exportation d’une présentation, par exemple vers PDF, images et autres formats pris en charge. Cela permet de conserver une sortie cohérente quel que soit l’environnement. L’article explique également comment inspecter les dossiers de polices utilisés par Aspose.Slides et comment vider le cache des polices après avoir travaillé avec des polices externes.
L’enregistrement de polices personnalisées pour le rendu est distinct de l’incorporation de polices dans un fichier PPTX. Si une police doit être stockée à l’intérieur de la présentation, utilisez explicitement les fonctionnalités d’incorporation de polices.
Un thème de présentation peut référencer différentes familles de polices pour des systèmes d’écriture individuels. Ces correspondances stockent les noms de polices mais n’installent ni ne chargent les fichiers de polices. Consultez Polices de thème spécifiques au script pour gérer les correspondances, et utilisez les options de chargement ci‑dessous pour rendre les polices référencées disponibles pour un rendu cohérent.
Remarque
Aspose Slides vous permet de charger ces polices à l’aide de la méthode FontsLoader.LoadExternalFonts :
Charger des polices personnalisées
Aspose.Slides vous permet de charger les polices utilisées dans une présentation sans les installer sur le système. Cela influence le rendu des exportations — telles que PDF, images et autres formats pris en charge — afin que les documents résultants conservent le même aspect sur tous les environnements. Les polices sont chargées depuis des répertoires personnalisés.
- Spécifiez un ou plusieurs dossiers contenant les fichiers de polices.
- Appelez la méthode statique FontsLoader.LoadExternalFonts pour charger les polices depuis ces dossiers.
- Chargez et rendez/exportez la présentation.
- Appelez FontsLoader.ClearCache pour vider le cache des polices.
L’exemple de code suivant montre le processus de chargement des polices :
using Aspose.Slides;
using Aspose.Slides.Export;
// Définir les dossiers contenant les fichiers de polices personnalisées.
string[] fontFolders = { @"C:\MyFonts", @"D:\Fonts" };
// Charger les polices personnalisées depuis les dossiers spécifiés.
FontsLoader.LoadExternalFonts(fontFolders);
using Presentation presentation = new Presentation("sample.pptx");
// Rendre/exporter la présentation (par ex. en PDF, images ou autres formats) en utilisant les polices chargées.
presentation.Save("output.pdf", SaveFormat.Pdf);
// Vider le cache des polices après la fin du travail.
FontsLoader.ClearCache();
Remarque
FontsLoader.LoadExternalFonts ajoute des dossiers supplémentaires aux chemins de recherche des polices, mais ne modifie pas l’ordre d’initialisation des polices.
Les polices sont initialisées dans cet ordre :
- Le chemin de police par défaut du système d’exploitation.
- Les chemins chargés via FontsLoader.
Obtenir les dossiers de polices personnalisées
Aspose.Slides fournit la méthode GetFontFolders pour vous permettre de retrouver les dossiers de polices. Cette méthode renvoie les dossiers ajoutés via la méthode LoadExternalFonts ainsi que les dossiers de polices du système.
Ce code C# montre comment utiliser GetFontFolders :
using Aspose.Slides;
// Cette ligne affiche les dossiers qui sont vérifiés pour les fichiers de police.
// Ce sont les dossiers ajoutés via la méthode LoadExternalFonts et les dossiers de polices du système.
string[] fontFolders = FontsLoader.GetFontFolders();
Spécifier les polices personnalisées utilisées avec une présentation
Aspose.Slides fournit la propriété DocumentLevelFontSources pour vous permettre de spécifier les polices externes qui seront utilisées avec la présentation.
Ce code C# montre comment utiliser la propriété DocumentLevelFontSources :
using Aspose.Slides;
byte[] memoryFont1 = File.ReadAllBytes("customfonts\\CustomFont1.ttf");
byte[] memoryFont2 = File.ReadAllBytes("customfonts\\CustomFont2.ttf");
LoadOptions loadOptions = new LoadOptions();
loadOptions.DocumentLevelFontSources.FontFolders = new string[] { "assets\\fonts", "global\\fonts" };
loadOptions.DocumentLevelFontSources.MemoryFonts = new byte[][] { memoryFont1, memoryFont2 };
using (IPresentation presentation = new Presentation("MyPresentation.pptx", loadOptions))
{
// Travailler avec la présentation
// CustomFont1, CustomFont2, et les polices des dossiers assets\fonts & global\fonts ainsi que leurs sous-dossiers sont disponibles pour la présentation
}
Gérer les polices de manière externe
Aspose.Slides propose la méthode LoadExternalFont(byte[] data) pour charger des polices externes à partir de données binaires.
Ce code C# illustre le processus de chargement d’une police depuis un tableau d’octets :
using Aspose.Slides;
FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALN.TTF"));
FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALNBI.TTF"));
FontsLoader.LoadExternalFont(File.ReadAllBytes("ARIALNI.TTF"));
try
{
using (Presentation pres = new Presentation(""))
{
// police externe chargée pendant la durée de vie de la présentation
}
}
finally
{
FontsLoader.ClearCache();
}
Pour laisser une police enregistrée correspondante prendre le pas lors de l’exportation sans supprimer la police incorporée, consultez Privilégier les polices enregistrées aux polices incorporées (.NET 26.11 ou version ultérieure).
FAQ
Les polices personnalisées affectent‑elles l’exportation vers tous les formats (PDF, PNG, SVG, HTML) ?
Oui. Les polices connectées sont utilisées par le moteur de rendu pour tous les formats d’exportation.
Les polices personnalisées sont‑elles automatiquement incorporées dans le PPTX résultant ?
Non. Enregistrer une police pour le rendu n’est pas identique à l’incorporer dans un PPTX. Si vous avez besoin que la police soit transportée à l’intérieur du fichier de présentation, vous devez utiliser explicitement les fonctions d’incorporation.
Puis‑je contrôler le comportement de secours lorsqu’une police personnalisée ne possède pas certains glyphes ?
Oui. Configurez la substitution de police, les règles de remplacement et les ensembles de secours pour définir exactement quelle police sera utilisée lorsque le glyphe demandé est manquant.
Puis‑je utiliser des polices sous Linux/Docker sans les installer globalement ?
Oui. Pointez simplement vers vos propres dossiers de polices ou chargez les polices depuis des tableaux d’octets. Cela élimine toute dépendance aux répertoires de polices du système dans l’image du conteneur.
Remarque pour Linux/Docker : lors de l’appel à
FontsLoader.LoadExternalFonts, assurez‑vous que chaque entrée du tableaudirectoriescontient un chemin non vide pointant vers un répertoire existant. Si une variable d’environnement utilisée pour construire un chemin de police est indéfinie ou vide, Aspose.Slides peut tenter de résoudre la valeur vide comme un chemin complet, ce qui entraîne uneSystem.ArgumentException.
Qu’en est‑il de la licence — puis‑je incorporer n’importe quelle police personnalisée sans restriction ?
Vous êtes responsable de la conformité aux licences des polices. Les conditions varient ; certaines licences interdisent l’incorporation ou l’utilisation commerciale. Consultez toujours le contrat de licence (EULA) de la police avant de distribuer les sorties.