Konfiguration von Font‑Substitution in Präsentationen mit Python über Java
Übersicht
Font‑Substitution ermöglicht es Aspose.Slides, eine verfügbare Schriftart anstelle einer nicht zugänglichen Schriftart zu verwenden, wenn eine Präsentation gerendert oder konvertiert wird. Die Substitution beeinflusst die gerenderte Ausgabe; sie ändert nicht die der Präsentation zugewiesene Schriftart.
Sie können die zu verwendende Schriftart festlegen, wenn eine bestimmte Schriftart nicht verfügbar ist, und die Substitutionen einsehen, die Aspose.Slides beim Rendern vornimmt. So bleibt die Ausgabe in Umgebungen mit unterschiedlichen installierten Schriftarten konsistent.
Font‑Substitutionen abrufen
Verwenden Sie die FontsManager.getSubstitutions-Methode, um zu bestimmen, welche Schriftarten beim Rendern der Präsentation substituiert werden. Die Methode gibt FontSubstitutionInfo-Objekte zurück, die den ursprünglichen und den substituierten Schriftnamen identifizieren.
Das folgende Python‑Beispiel listet alle Font‑Substitutionen für eine Präsentation auf:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
presentation = Presentation("Presentation.pptx")
try:
for substitution in presentation.getFontsManager().getSubstitutions():
print(f"{substitution.getOriginalFontName()} -> {substitution.getSubstitutedFontName()}")
finally:
presentation.dispose()
Font‑Substitutionen für ausgewählte Folien abrufen
Verwenden Sie die Überladung von FontsManager.getSubstitutions mit einem Java‑Integer‑Array‑Argument, um nur die Substitutionen zu prüfen, die zum Rendern bestimmter Folien erforderlich sind. Das ist nützlich, wenn Sie einen Teil einer Präsentation rendern oder exportieren, eine große Präsentation inkrementell überprüfen, Folien finden möchten, die von nicht verfügbaren Schriftarten abhängen, ein minimales Schriftpaket für einen Server oder Container vorbereiten oder Rendering‑Unterschiede diagnostizieren wollen, ohne nicht relevante Folien zu verarbeiten.
Das slides‑Array enthält ein‑basiert indizierte Folienzahlen: 1 bezeichnet die erste Folie. Im Gegensatz dazu verwendet der Zugriff auf die Sammlung über Presentation.getSlides null‑basiertes Indexieren, sodass dieselbe Folie über presentation.getSlides().get_Item(0) adressiert wird. Beachten Sie diesen Unterschied beim Erstellen des Arrays, um Off‑by‑One‑Fehler zu vermeiden.
Rufen Sie die Überladung über die Presentation.getFontsManager-Methode auf. Sie gibt nur die Substitutionen zurück, die beim Rendern der ausgewählten Folien ermittelt wurden. Jeder Eintrag ist ein FontSubstitutionInfo-Objekt, das den ursprünglichen und den substituierten Schriftnamen enthält. Das Ergebnis spiegelt die aktuelle Schriftumgebung, konfigurierte Fallback‑Regeln, in einer FontSubstRuleCollection gespeicherte Substitutionsregeln sowie extern geladene Schriftarten wider.
Die gleiche Substitution kann von mehr als einer ausgewählten Folie benötigt werden. Entfernen Sie Duplikate, wenn Sie ein Schriftinventar oder einen Preflight‑Report erstellen. Das folgende Beispiel gibt jede zurückgegebene Substitution aus und erzeugt anschließend eine sortierte Liste eindeutiger Schriftzuordnungen:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
presentation = Presentation("Presentation.pptx")
try:
selected_slides = jpype.JArray(jpype.JInt)([1, 3, 5])
substitutions = list(presentation.getFontsManager().getSubstitutions(selected_slides))
print("Substitutions for the selected slides:")
for substitution in substitutions:
print(f"{substitution.getOriginalFontName()} -> {substitution.getSubstitutedFontName()}")
unique_entries = {}
for substitution in substitutions:
entry = f"{substitution.getOriginalFontName()} -> {substitution.getSubstitutedFontName()}"
unique_entries.setdefault(entry.casefold(), entry)
print("Deduplicated font preflight report:")
for key in sorted(unique_entries):
print(unique_entries[key])
finally:
presentation.dispose()
Die Klasse FontsManager bietet beide Überladungen. Wählen Sie je nach Umfang des Render‑Vorgangs:
| Überladung | Verwenden, wenn |
|---|---|
| getSubstitutions ohne Argumente | Sie Substitutionen für die gesamte Präsentation benötigen. |
| getSubstitutions mit einem Java‑Integer‑Array | Sie Substitutionen für einen ausgewählten Bereich, eine inkrementelle Prüfung oder einen teilweisen Export benötigen. |
Font‑Substitutionsregeln festlegen
Um anzugeben, welche Schriftart Aspose.Slides verwenden soll, wenn eine Quellschriftart nicht verfügbar ist:
- Laden Sie die Präsentation.
- Erstellen Sie Schriftartdefinitionen für die Quell‑ und Ersatzschriftart.
- Erstellen Sie ein FontSubstRule mit der Bedingung WhenInaccessible.
- Fügen Sie die Regel einer FontSubstRuleCollection hinzu.
- Weisen Sie die Sammlung über die Methode FontsManager.setFontSubstRuleList zu.
- Rendern oder konvertieren Sie die Präsentation.
Das folgende Python‑Beispiel ersetzt Arial durch SomeRareFont, wenn SomeRareFont nicht verfügbar ist, und rendert anschließend die erste Folie, um das Ergebnis zu prüfen. Die Ersatzschriftart muss für Aspose.Slides verfügbar sein.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, FontSubstCondition, FontSubstRule, FontSubstRuleCollection, ImageFormat, Presentation
presentation = Presentation("Fonts.pptx")
try:
source_font = FontData("SomeRareFont")
substitute_font = FontData("Arial")
substitution_rule = FontSubstRule(source_font, substitute_font, FontSubstCondition.WhenInaccessible)
substitution_rules = FontSubstRuleCollection()
substitution_rules.add(substitution_rule)
presentation.getFontsManager().setFontSubstRuleList(substitution_rules)
image = presentation.getSlides().get_Item(0).getImage(1.0, 1.0)
try:
image.save("slide.jpg", ImageFormat.Jpeg)
finally:
image.dispose()
finally:
presentation.dispose()
Hinweis
Für eine bedingungslose Änderung der in einer gesamten Präsentation verwendeten Schriftarten siehe Font Replacement.Einschränkungen für Schriftarten in mathematischen Gleichungen
Font‑Substitutionsregeln sind Teil des standardmäßigen Schriftartauswahlprozesses, der beim Rendern und Konvertieren verwendet wird. Sie funktionieren für normalen Text, wenn Aspose.Slides eine nicht zugängliche Schriftart durch die in einer Regel angegebene verfügbare Schriftart ersetzen kann.
Office‑Math‑Gleichungen haben eine zusätzliche Anforderung. Verwendet eine Gleichung Cambria Math, kann Aspose.Slides diese exakte Schriftart benötigen, um das Layout der Gleichung zu berechnen und zu rendern. Eine Regel, die eine andere mathematische Schriftart, etwa STIX Two Math, substituiert, kann Cambria Math für diesen Zweck nicht ersetzen, und das Rendering kann weiterhin melden, dass Cambria Math erforderlich ist.
Stellen Sie Cambria Math Aspose.Slides zur Verfügung, um eine solche Präsentation zu rendern oder zu konvertieren. Installieren Sie sie im Betriebssystem oder laden Sie sie als externe Schriftart geladen.
Diese Einschränkung betrifft nur das Gleichungs‑Layout. Die oben beschriebenen Substitutionsregeln gelten weiterhin für den regulären Präsentationstext.
FAQ
Was ist der Unterschied zwischen Font Replacement und Font Substitution?
Font replacement ändert bewusst eine Schriftart durch eine andere in der gesamten Präsentation. Font‑Substitution wählt eine Schriftart für die gerenderte Ausgabe, wenn die konfigurierte Bedingung erfüllt ist, zum Beispiel wenn die Originalschriftart nicht verfügbar ist.
Wann werden Substitutionsregeln angewendet?
Die Regeln nehmen am font selection sequence während des Renderns und Konvertierens teil. Mit WhenInaccessible wird eine Regel nur verwendet, wenn Aspose.Slides nicht auf die Quellschriftart zugreifen kann.
Was passiert, wenn eine Schriftart fehlt und keine Substitutionsregel konfiguriert ist?
Aspose.Slides wählt die am besten passende verfügbare Schriftart gemäß seinem Schriftartauswahlprozess. Das Ergebnis hängt von den im Laufzeitumfeld verfügbaren Schriftarten ab.
Kann ich externe Schriftarten laden, um Substitution zu vermeiden?
Ja. Sie können externe Schriftarten laden, sodass Aspose.Slides sie beim Rendern und Konvertieren verwenden kann.
Stellt Aspose Schriftarten mit der Bibliothek bereit?
Nein. Sie sind dafür verantwortlich, Schriftarten bereitzustellen und deren Lizenzbedingungen einzuhalten.
Können Substitutions‑Ergebnisse zwischen Windows, Linux und macOS variieren?
Ja. Installierte Schriftarten und Suchpfade unterscheiden sich je nach Betriebssystem, sodass eine Schriftart, die auf einem Rechner verfügbar ist, auf einem anderen substituiert werden muss.
Wie kann ich die Schriftartauswahl bei Batch‑Konvertierungen konsistent halten?
Verwenden Sie dieselben Schriftdateien und -versionen auf jedem Rechner oder Container, laden Sie erforderliche externe Schriftarten und betten Sie Schriftarten ein, sofern die Lizenz dies zulässt. Sie können auch vor dem Export FontsManager.getSubstitutions aufrufen, um unerwartete Substitutionen zu erkennen.