Configura la sostituzione dei font nelle presentazioni usando PHP
Panoramica
La sostituzione dei font consente ad Aspose.Slides di utilizzare un font disponibile al posto di un font che non può essere accesso quando una presentazione viene renderizzata o convertita. La sostituzione influisce sull’output renderizzato; non modifica il font assegnato al contenuto della presentazione.
È possibile definire il font da utilizzare quando un determinato font non è disponibile e si possono ispezionare le sostituzioni che Aspose.Slides effettuerà durante il rendering. Questo aiuta a mantenere l’output coerente tra ambienti con font installati diversi.
Se un font è disponibile ma non ha un carattere grassetto dedicato, consulta Gestire i font senza un carattere grassetto dedicato. Quella sezione spiega come rasterizzare il testo interessato durante l’esportazione PDF e le conseguenze per la selezione del testo, la ricerca e il ridimensionamento.
Ottenere le sostituzioni dei font
Utilizza il metodo FontsManager::getSubstitutions per determinare quali font verranno sostituiti quando la presentazione viene renderizzata. Il metodo restituisce oggetti FontSubstitutionInfo che identificano i nomi del font originale e di quello sostituito.
Il seguente esempio PHP elenca tutte le sostituzioni dei font per una presentazione:
use aspose\slides\Presentation;
$presentation = new Presentation("Presentation.pptx");
try {
$enumerator = $presentation->getFontsManager()->getSubstitutions()->iterator();
try {
while (java_values($enumerator->hasNext())) {
$substitution = $enumerator->next();
$originalFontName = java_values($substitution->getOriginalFontName());
$substitutedFontName = java_values($substitution->getSubstitutedFontName());
echo $originalFontName . " -> " . $substitutedFontName . PHP_EOL;
}
} finally {
$enumerator->dispose();
}
} finally {
$presentation->dispose();
}
Ottenere le sostituzioni dei font per le diapositive selezionate
Utilizza la sovraccarico FontsManager::getSubstitutions con un argomento int[] slides per ispezionare solo le sostituzioni necessarie a renderizzare diapositive specifiche. Questo è utile quando si renderizza o si esporta parte di una presentazione, si verifica una grande presentazione in modo incrementale, si individuano diapositive che dipendono da font non disponibili, si prepara un pacchetto di font minimale per un server o container, o si diagnosticano 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’accessor della collezione Presentation::getSlides utilizza un indicizzamento a zero, quindi la stessa diapositiva si accede con $presentation->getSlides()->get_Item(0). Tieni presente questa differenza quando costruisci l’array per evitare errori di scostamento.
Chiama 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 font originale e di quello sostituito. Il risultato riflette l’ambiente font corrente, le regole di fallback configurate, le regole di sostituzione memorizzate in una FontSubstRuleCollection e i font caricati esternamente.
La stessa sostituzione può essere richiesta da più di una diapositiva selezionata. De‑duplifica i risultati quando crei un inventario dei font o un rapporto di preflight. Il seguente esempio segnala ogni sostituzione restituita e poi crea un elenco ordinato di mappature di font uniche:
use aspose\slides\Presentation;
$presentation = new Presentation("Presentation.pptx");
try {
$selectedSlides = [1, 3, 5];
$substitutions = [];
$enumerator = $presentation->getFontsManager()->getSubstitutions($selectedSlides)->iterator();
try {
while (java_values($enumerator->hasNext())) {
$substitutions[] = $enumerator->next();
}
} finally {
$enumerator->dispose();
}
echo "Substitutions for the selected slides:" . PHP_EOL;
foreach ($substitutions as $substitution) {
$originalFontName = java_values($substitution->getOriginalFontName());
$substitutedFontName = java_values($substitution->getSubstitutedFontName());
echo $originalFontName . " -> " . $substitutedFontName . PHP_EOL;
}
$sortedPreflightEntries = [];
foreach ($substitutions as $substitution) {
$originalFontName = java_values($substitution->getOriginalFontName());
$substitutedFontName = java_values($substitution->getSubstitutedFontName());
$entry = $originalFontName . " -> " . $substitutedFontName;
$sortedPreflightEntries[strtolower($entry)] = $entry;
}
ksort($sortedPreflightEntries, SORT_NATURAL | SORT_FLAG_CASE);
echo "Deduplicated font preflight report:" . PHP_EOL;
foreach ($sortedPreflightEntries as $entry) {
echo $entry . PHP_EOL;
}
} finally {
$presentation->dispose();
}
La classe FontsManager fornisce entrambe le sovraccarichi. Scegli quella più adatta all’ambito dell’operazione di rendering:
| Overload | Quando usarlo |
|---|---|
| getSubstitutions with no arguments | Hai bisogno delle sostituzioni per l’intera presentazione. |
getSubstitutions with int[] slides |
Hai bisogno delle sostituzioni per un intervallo selezionato, controllo incrementale o esportazione parziale. |
Impostare le regole di sostituzione dei font
Per specificare il font che Aspose.Slides deve utilizzare quando un font di origine non è disponibile:
- Carica la presentazione.
- Crea definizioni di font per i font di origine e di sostituzione.
- Crea una FontSubstRule con la condizione WhenInaccessible.
- Aggiungi la regola a una FontSubstRuleCollection.
- Assegna la collezione usando il metodo FontsManager::setFontSubstRuleList.
- Renderizza o converti la presentazione.
Il seguente esempio PHP sostituisce Arial per SomeRareFont quando SomeRareFont non è disponibile, e poi renderizza la prima diapositiva per verificare il risultato. Il font di sostituzione deve essere disponibile per Aspose.Slides.
use aspose\slides\FontData;
use aspose\slides\FontSubstCondition;
use aspose\slides\FontSubstRule;
use aspose\slides\FontSubstRuleCollection;
use aspose\slides\ImageFormat;
use aspose\slides\Presentation;
$presentation = new Presentation("Fonts.pptx");
try {
$sourceFont = new FontData("SomeRareFont");
$substituteFont = new FontData("Arial");
$substitutionRule = new FontSubstRule($sourceFont, $substituteFont, FontSubstCondition::WhenInaccessible);
$substitutionRules = new FontSubstRuleCollection();
$substitutionRules->add($substitutionRule);
$presentation->getFontsManager()->setFontSubstRuleList($substitutionRules);
$image = $presentation->getSlides()->get_Item(0)->getImage(1.0, 1.0);
try {
$image->save("slide.jpg", ImageFormat::Jpeg);
} finally {
$image->dispose();
}
} finally {
$presentation->dispose();
}
Note
Per una modifica incondizionata dei font utilizzati in tutta la presentazione, vedi Sostituzione dei font.Limitazioni per i font delle equazioni matematiche
Le regole di sostituzione dei font fanno parte del processo standard di selezione dei font usato durante il rendering e la conversione. Funzionano per il testo normale quando Aspose.Slides può sostituire un font inaccessibile con il font disponibile specificato da una regola.
Le equazioni Office Math hanno un requisito aggiuntivo. Se un’equazione utilizza Cambria Math, Aspose.Slides potrebbe aver bisogno esattamente di quel font per calcolare e renderizzare il layout dell’equazione. Una regola che sostituisce un altro font 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 presentazione di questo tipo, rendi Cambria Math disponibile per Aspose.Slides. Installalo nel sistema operativo o caricalo come font esterno.
Questa limitazione si applica al layout delle equazioni. Le regole di sostituzione descritte sopra continuano a valere per il testo normale della presentazione.
FAQ
Qual è la differenza tra sostituzione dei font e sostituzione condizionale dei font?
Sostituzione dei font cambia intenzionalmente un font in un altro in tutta la presentazione. La sostituzione dei font seleziona un font per l’output renderizzato quando la condizione configurata è soddisfatta, ad esempio quando il font originale non è disponibile.
Quando vengono applicate le regole di sostituzione?
Le regole partecipano alla sequenza di selezione dei font durante il rendering e la conversione. Con WhenInaccessible, una regola viene utilizzata solo quando Aspose.Slides non può accedere al font di origine.
Cosa accade quando un font manca e non è configurata alcuna regola di sostituzione?
Aspose.Slides seleziona il font disponibile più vicino in base al suo processo di selezione dei font. Il risultato dipende dai font disponibili nell’ambiente di esecuzione.
Posso caricare font esterni per evitare la sostituzione?
Sì. È possibile caricare font esterni affinché Aspose.Slides li utilizzi durante il rendering e la conversione.
Aspose distribuisce i font con la libreria?
No. Sei responsabile di fornire i font e di rispettare le loro licenze.
I risultati della sostituzione possono differire tra Windows, Linux e macOS?
Sì. I font installati e le posizioni di ricerca dei font variano a seconda del sistema operativo, quindi un font disponibile su una macchina può richiedere una sostituzione su un’altra.
Come posso rendere la selezione dei font coerente nelle conversioni batch?
Utilizza gli stessi file e versioni dei font su ogni macchina o container, carica i font esterni richiesti e incorpora i font quando le licenze lo consentono. È inoltre possibile chiamare FontsManager::getSubstitutions prima dell’esportazione per identificare sostituzioni inattese.