Configura la sostituzione dei caratteri nelle presentazioni su Android
Panoramica
La sostituzione dei caratteri consente ad Aspose.Slides di utilizzare un carattere disponibile al posto di un carattere non accessibile quando una presentazione viene renderizzata o convertita. La sostituzione influisce sull’output renderizzato; non modifica il carattere assegnato al contenuto della presentazione.
È possibile definire il carattere da utilizzare quando un determinato carattere non è disponibile e si possono esaminare le sostituzioni che Aspose.Slides effettuerà durante il rendering. Ciò aiuta a mantenere l’output coerente su dispositivi Android e ambienti con diversi caratteri disponibili.
Se un carattere è disponibile ma non ha una variante grassetto dedicata, vedere Gestire i caratteri senza una variante grassetto dedicata. Quella sezione spiega come rasterizzare il testo interessato durante l’esportazione PDF e le conseguenze per la selezione del testo, la ricerca e lo scaling.
Ottenere le sostituzioni dei caratteri
Utilizzare il metodo IFontsManager.getSubstitutions per determinare quali caratteri verranno sostituiti quando la presentazione viene renderizzata. Il metodo restituisce oggetti FontSubstitutionInfo che identificano i nomi del carattere originale e di quello sostituito.
Il seguente esempio Java elenca tutte le sostituzioni dei caratteri per una presentazione:
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();
}
Ottenere le sostituzioni dei caratteri per le diapositive selezionate
Utilizzare la sovraccarico del metodo IFontsManager.getSubstitutions con un argomento int[] slides per esaminare solo le sostituzioni necessarie a renderizzare diapositive specifiche. Questo è utile quando si renderizza o si esporta una parte di una presentazione, si verifica incrementialmente una presentazione di grandi dimensioni, si individuano diapositive che dipendono da caratteri non disponibili, si prepara un pacchetto di caratteri minimo per un’app Android o si diagnostica differenze di rendering senza elaborare diapositive non correlate.
L’array slides contiene indici diapositive basati su 1: 1 identifica la prima diapositiva. Al contrario, l’accessorio di raccolta Presentation.getSlides utilizza un indice basato su 0, quindi la stessa diapositiva viene acceduta come presentation.getSlides().get_Item(0). Tenere presente questa differenza quando si costruisce l’array per evitare errori di scarto di uno.
Richiamare la sovraccarico tramite il metodo Presentation.getFontsManager . Restituisce solo le sostituzioni determinate durante il rendering delle diapositive selezionate. Ogni risultato è un oggetto FontSubstitutionInfo che contiene i nomi del carattere originale e di quello sostituito. Il risultato riflette l’ambiente dei caratteri corrente, le regole di fallback configurate, le regole di sostituzione memorizzate in una IFontSubstRuleCollection e i font caricati esternamente.
La stessa sostituzione può essere necessaria per più di una diapositiva selezionata. Rimuovere i duplicati dai risultati quando si crea un inventario dei caratteri o un report di preflight. Il seguente esempio riporta ogni sostituzione restituita e poi crea un elenco ordinato di mappature di caratteri uniche:
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’interfaccia IFontsManager fornisce entrambi i sovraccarichi. Scegliere uno in base all’ambito dell’operazione di rendering:
| Sovraccarico | Usalo quando |
|---|---|
| getSubstitutions with no arguments | Hai bisogno delle sostituzioni per l’intera presentazione. |
getSubstitutions with int[] slides |
Hai bisogno delle sostituzioni per un intervallo selezionato, verifica incrementale o esportazione parziale. |
Impostare le regole di sostituzione dei caratteri
Per specificare il carattere che Aspose.Slides deve usare quando un carattere sorgente non è disponibile:
- Caricare la presentazione.
- Creare definizioni di carattere per i caratteri sorgente e sostitutivo.
- Creare una FontSubstRule con la condizione WhenInaccessible.
- Aggiungere la regola a una FontSubstRuleCollection.
- Assegnare la raccolta utilizzando il metodo FontsManager.setFontSubstRuleList.
- Renderizzare o convertire la presentazione.
Il seguente esempio Java sostituisce Arial a SomeRareFont quando SomeRareFont non è disponibile, quindi renderizza la prima diapositiva per verificare il risultato. Il carattere sostitutivo deve essere disponibile per 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
Per una modifica incondizionata dei caratteri utilizzati in tutta la presentazione, vedere Sostituzione dei caratteri.Limitazioni per i caratteri delle equazioni matematiche
Le regole di sostituzione dei caratteri fanno parte del processo standard di selezione dei caratteri utilizzato durante il rendering e la conversione. Funzionano per il testo normale quando Aspose.Slides può sostituire un carattere inaccessibile con il carattere disponibile specificato da una regola.
Le equazioni Office Math hanno un requisito aggiuntivo. Se un’equazione utilizza Cambria Math, Aspose.Slides potrebbe aver bisogno di quel carattere esatto per calcolare e renderizzare il layout dell’equazione. Una regola che sostituisce un altro carattere matematico, come STIX Two Math, non può sostituire Cambria Math a questo scopo, e il rendering potrebbe comunque segnalare che Cambria Math è necessario.
Per renderizzare o convertire una tale presentazione, rendere Cambria Math disponibile per Aspose.Slides. Caricarlo come font esterno in modo che l’applicazione possa usarlo durante il rendering e la conversione.
Questa limitazione si applica al layout delle equazioni. Le regole di sostituzione descritte sopra continuano a essere valide per il testo normale della presentazione.
FAQ
Qual è la differenza tra la sostituzione dei caratteri e la sostituzione dei caratteri?
Sostituzione dei caratteri cambia intenzionalmente un carattere con un altro in tutta la presentazione. La sostituzione dei caratteri seleziona un carattere per l’output renderizzato quando viene soddisfatta la condizione configurata, ad esempio quando il carattere originale non è disponibile.
Quando vengono applicate le regole di sostituzione?
Le regole partecipano alla sequenza di selezione dei caratteri durante il rendering e la conversione. Con WhenInaccessible, una regola viene utilizzata solo quando Aspose.Slides non può accedere al carattere sorgente.
Cosa succede quando un carattere è mancante e non è configurata alcuna regola di sostituzione?
Aspose.Slides seleziona il carattere disponibile più vicino secondo il suo processo di selezione dei caratteri. Il risultato dipende dai caratteri disponibili nell’ambiente di runtime.
Posso caricare font esterni per evitare la sostituzione?
Sì. È possibile caricare font esterni in modo che Aspose.Slides possa usarli durante il rendering e la conversione.
Aspose distribuisce i caratteri con la libreria?
No. Sei responsabile di fornire i caratteri e di rispettare le loro licenze.
I risultati di sostituzione possono differire tra dispositivi Android?
Sì. I caratteri di sistema disponibili possono variare tra versioni Android, dispositivi e fornitori, quindi un carattere disponibile in un ambiente potrebbe richiedere una sostituzione in un altro.
Come posso rendere coerente la selezione dei caratteri tra dispositivi Android?
Includi gli stessi file di caratteri richiesti con l’applicazione, caricali come font esterni e incorpora i caratteri quando la licenza lo consente. È anche possibile chiamare IFontsManager.getSubstitutions prima dell’esportazione per identificare sostituzioni inattese.