Configurer la substitution de police dans les présentations avec Java

À propos de cette page

Configurez les règles de substitution de police et inspectez les polices substituées dans Aspose.Slides pour Java lors du rendu ou de la conversion de présentations PowerPoint et OpenDocument.

Vue d’ensemble

La substitution de police permet à Aspose.Slides d’utiliser une police disponible à la place d’une police qui ne peut pas être accédée lorsqu’une présentation est rendue ou convertie. La substitution affecte la sortie rendue ; elle ne modifie pas la police assignée au contenu de la présentation.

Vous pouvez définir la police à utiliser lorsqu’une police particulière est indisponible, et vous pouvez examiner les substitutions qu’Aspose.Slides effectuera lors du rendu. Cela aide à maintenir une sortie cohérente entre des environnements possédant des polices installées différentes.

Si une police est disponible mais n’a pas de graisse dédiée, consultez Gérer les polices sans graisse dédiée. Cette section explique comment rastériser le texte affecté lors de l’exportation PDF et les conséquences pour la sélection de texte, la recherche et le redimensionnement.

Obtenir les substitutions de police

Utilisez la méthode IFontsManager.getSubstitutions pour déterminer quelles polices seront substituées lorsque la présentation sera rendue. La méthode renvoie des objets FontSubstitutionInfo qui identifient les noms de police d’origine et de substitution.

L’exemple Java suivant répertorie toutes les substitutions de police pour une présentation :

import com.aspose.slides.FontSubstitutionInfo;
import com.aspose.slides.Presentation;

Presentation presentation = new Presentation("Presentation.pptx");
try {
    for (FontSubstitutionInfo substitution : presentation.getFontsManager().getSubstitutions()) {
        System.out.println(substitution.getOriginalFontName() + " -> " + substitution.getSubstitutedFontName());
    }
} finally {
    presentation.dispose();
}

Obtenir les substitutions de police pour les diapositives sélectionnées

Utilisez la surcharge IFontsManager.getSubstitutions avec un argument int[] slides pour examiner uniquement les substitutions requises pour rendre des diapositives spécifiques. Cela est utile lorsque vous rendez ou exportez une partie d’une présentation, que vous effectuez une vérification incrémentielle d’une grande présentation, que vous recherchez les diapositives dépendant de polices indisponibles, que vous préparez un package de polices minimal pour un serveur ou un conteneur, ou que vous diagnostiquez des différences de rendu sans traiter les diapositives non concernées.

Le tableau slides contient des index de diapositives basés à 1 : 1 identifie la première diapositive. En revanche, l’accesseur de collection Presentation.getSlides utilise un indexation à base 0, de sorte que la même diapositive est accessible via presentation.getSlides().get_Item(0). Gardez cette différence à l’esprit lors de la construction du tableau afin d’éviter les erreurs d’indice décalé.

Appelez la surcharge via la méthode Presentation.getFontsManager . Elle ne renvoie que les substitutions déterminées lors du rendu des diapositives sélectionnées. Chaque résultat est un objet FontSubstitutionInfo contenant les noms de police d’origine et de substitution. Le résultat reflète l’environnement de police actuel, les règles de secours configurées et les polices externes. Les règles de substitution stockées dans une IFontSubstRuleCollection sont appliquées lors du rendu de la présentation, mais le résultat ne les répertorie pas ; vérifiez les polices dans le fichier de sortie à la place.

La même substitution peut être requise par plusieurs diapositives sélectionnées. Dédupliquez les résultats lorsque vous créez un inventaire de polices ou un rapport de pré‑vol. L’exemple suivant signale chaque substitution renvoyée puis crée une liste triée des correspondances de polices uniques :

import com.aspose.slides.FontSubstitutionInfo;
import com.aspose.slides.Presentation;
import java.util.ArrayList;
import java.util.List;
import java.util.Set;
import java.util.TreeSet;

Presentation presentation = new Presentation("Presentation.pptx");
try {
    int[] selectedSlides = { 1, 3, 5 };
    List<FontSubstitutionInfo> substitutions = new ArrayList<>();
    for (FontSubstitutionInfo substitution : presentation.getFontsManager().getSubstitutions(selectedSlides)) {
        substitutions.add(substitution);
    }

    System.out.println("Substitutions for the selected slides:");
    for (FontSubstitutionInfo substitution : substitutions) {
        System.out.println(substitution.getOriginalFontName() + " -> " + substitution.getSubstitutedFontName());
    }

    Set<String> sortedPreflightEntries = new TreeSet<>(String.CASE_INSENSITIVE_ORDER);
    for (FontSubstitutionInfo substitution : substitutions) {
        String entry = substitution.getOriginalFontName() + " -> " + substitution.getSubstitutedFontName();
        sortedPreflightEntries.add(entry);
    }

    System.out.println("Deduplicated font preflight report:");
    for (String entry : sortedPreflightEntries) {
        System.out.println(entry);
    }
} finally {
    presentation.dispose();
}

L’interface IFontsManager fournit les deux surcharges. Choisissez‑en une en fonction de la portée de l’opération de rendu :

Surcharge	Utilisez‑la lorsque
getSubstitutions avec aucun argument	Vous avez besoin des substitutions pour l’ensemble de la présentation.
getSubstitutions avec `int[] slides`	Vous avez besoin des substitutions pour une plage sélectionnée, une vérification incrémentielle ou une exportation partielle.

Définir les règles de substitution de police

Pour spécifier la police qu’Aspose.Slides doit utiliser lorsqu’une police source est indisponible :

Chargez la présentation.
Créez des définitions de police pour la police source et la police de substitution.
Créez une FontSubstRule avec la condition WhenInaccessible.
Ajoutez la règle à une FontSubstRuleCollection.
Attribuez la collection en utilisant la méthode FontsManager.setFontSubstRuleList.
Rendez ou convertissez la présentation.

L’exemple Java suivant substitue Arial à SomeRareFont lorsque SomeRareFont est indisponible, puis rend la première diapositive pour vérifier le résultat. La police de substitution doit être disponible pour Aspose.Slides.

import com.aspose.slides.FontData;
import com.aspose.slides.FontSubstCondition;
import com.aspose.slides.FontSubstRule;
import com.aspose.slides.FontSubstRuleCollection;
import com.aspose.slides.IFontData;
import com.aspose.slides.IFontSubstRule;
import com.aspose.slides.IFontSubstRuleCollection;
import com.aspose.slides.IImage;
import com.aspose.slides.ImageFormat;
import com.aspose.slides.Presentation;

Presentation presentation = new Presentation("Fonts.pptx");
try {
    IFontData sourceFont = new FontData("SomeRareFont");
    IFontData substituteFont = new FontData("Arial");
    IFontSubstRule substitutionRule = new FontSubstRule(sourceFont, substituteFont, FontSubstCondition.WhenInaccessible);

    IFontSubstRuleCollection substitutionRules = new FontSubstRuleCollection();
    substitutionRules.add(substitutionRule);
    presentation.getFontsManager().setFontSubstRuleList(substitutionRules);

    IImage image = presentation.getSlides().get_Item(0).getImage(1f, 1f);
    try {
        image.save("slide.jpg", ImageFormat.Jpeg);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}

Note

Pour un changement inconditionnel des polices utilisées dans l’ensemble d’une présentation, consultez Remplacement de police.

Limites pour les polices d’équations mathématiques

Les règles de substitution de police font partie du processus standard de sélection de police utilisé lors du rendu et de la conversion. Elles fonctionnent pour le texte ordinaire lorsqu’Aspose.Slides peut remplacer une police inaccessible par la police disponible spécifiée par une règle.

Les équations Office Math ont une exigence supplémentaire. Si une équation utilise Cambria Math, Aspose.Slides peut avoir besoin exactement de cette police pour calculer et rendre la disposition de l’équation. Une règle qui substitue une autre police mathématique, comme STIX Two Math, ne peut pas remplacer Cambria Math à cet effet, et le rendu peut toujours indiquer que Cambria Math est requis.

Pour rendre ou convertir une telle présentation, rendez Cambria Math disponible pour Aspose.Slides. Installez‑la dans le système d’exploitation ou chargez‑la comme police externe.

Cette limitation s’applique à la disposition des équations. Les règles de substitution décrites ci‑dessus s’appliquent toujours au texte ordinaire de la présentation.

FAQ

Quelle est la différence entre le remplacement de police et la substitution de police ?

Remplacement de police modifie intentionnellement une police en une autre dans l’ensemble de la présentation. La substitution de police sélectionne une police pour la sortie rendue lorsque la condition configurée est remplie, comme lorsque la police d’origine est indisponible.

Quand les règles de substitution sont‑elles appliquées ?

Les règles participent à la séquence de sélection de police pendant le rendu et la conversion. Avec WhenInaccessible, une règle n’est utilisée que lorsqu’Aspose.Slides ne peut pas accéder à la police source.

Que se passe‑t‑il lorsqu’une police est manquante et qu’aucune règle de substitution n’est configurée ?

Aspose.Slides sélectionne la police la plus proche disponible selon son processus de sélection de police. Le résultat dépend des polices présentes dans l’environnement d’exécution.

Puis‑je charger des polices externes pour éviter la substitution ?

Oui. Vous pouvez charger des polices externes afin qu’Aspose.Slides les utilise pendant le rendu et la conversion.

Aspose distribue‑t‑il des polices avec la bibliothèque ?

Non. Vous êtes responsable de fournir les polices et de respecter leurs licences.

Les résultats de substitution peuvent‑ils différer entre Windows, Linux et macOS ?

Oui. Les polices installées et les emplacements de recherche de polices diffèrent selon le système d’exploitation, de sorte qu’une police disponible sur une machine peut nécessiter une substitution sur une autre.

Comment garantir une sélection de police cohérente lors de conversions par lots ?

Utilisez les mêmes fichiers de police et les mêmes versions sur chaque machine ou conteneur, chargez les polices externes requises, et intégrez les polices lorsque les licences le permettent. Vous pouvez également appeler IFontsManager.getSubstitutions avant l’exportation pour identifier les substitutions inattendues.

Optimiser le remplacement de police dans les présentations en Java Séquence de sélection des polices dans Aspose.Slides pour Java