Specificare la posizione dei caratteri TrueType

In questo argomento viene descritto il comportamento predefinito di Aspose.Words quando cerca i font TrueType, incluse le differenze specifiche del sistema operativo e viene illustrato come specificare le origini dei font utente.

La classe FontSourceBase viene utilizzata per specificare varie fonti di font. Esistono diverse implementazioni della classe FontSourceBase:

I dettagli di implementazione per alcune classi sono spiegati di seguito.

Carica font dal sistema

Esiste una classe speciale SystemFontSource che viene sempre utilizzata per impostazione predefinita. Rappresenta tutti i font TrueType installati sul sistema. Pertanto, è possibile creare un elenco di sorgenti con SystemFontSource e qualsiasi altra fonte richiesta:

Una singola istanza della classe SystemFontSource è definita di default in FontSettings. Su diversi sistemi operativi, i font possono trovarsi in luoghi diversi. Tuttavia, l’utilizzo di un’istanza FontSettings per ogni documento non è una soluzione ottimale. Nella maggior parte dei casi, l’uso di DefaultInstance dovrebbe essere sufficiente.

Le istanze per documento sono necessarie solo se è necessario utilizzare fonti di font diverse per documenti diversi, il che è un caso raro. L’utilizzo di più istanze FontSettings riduce le prestazioni perché non condividono la cache.

Dove Aspose.Words Cerca i caratteri TrueTypesu Windows

Nella maggior parte dei casi, gli utenti di Windows non affrontano problemi significativi con font mancanti o layout errati. In genere, Aspose.Words passa attraverso un documento e quando incontra il collegamento di un font, recupera correttamente i dati del font dalla cartella di sistema.

Su Windows, Aspose.Words prima prende tutti i font disponibili dalla cartella _%windir%\Fonts. Questa impostazione funzionerà per te la maggior parte del tempo. Si specifica solo le proprie cartelle fonts se è necessario. Aspose.Words cerca anche font aggiuntivi registrati nella chiave del registro di sistema HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts. Inoltre, Windows 10 consente l’installazione di font per l’utente corrente. I font vengono inseriti nella cartella %userprofile%\AppData\Local\Microsoft\Windows\Fonts e specificati anche nel registro HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Fonts, dove Aspose.Words cercherà questi font.

Se un documento contiene font incorporati, Aspose.Words può leggere i dati dei font pertinenti dal documento e utilizzarli per creare il layout del documento. I documenti possono anche contenere collegamenti a font che non si trovano nelle cartelle di sistema, nel qual caso i seguenti scenari vengono a lavorare:

  • Gli utenti possono impostare nuove fonti di font tramite la classe FontSettings
  • Aspose.Words può provare a sostituire il font mancato con uno simile

Font su sistemi diversi daWindows

Aspose.Words cercherà i font nelle cartelle dei font di sistema. Un elenco di queste cartelle può essere visualizzato con il metodo GetSystemFontFolders. Se non vengono trovati font supportati, Aspose.Words utilizzerà il font predefinito incorporato Fanwood.ttf.

Poiché le metriche dei font di Windows e non-Windows OS sono diverse, Aspose.Words fa tutto il possibile per trovare un font simile e costruire un layout simile all’originale. Tuttavia, questo non è sempre possibile. In questi casi, la classe FontSettings deve essere utilizzata per aggiungere font personalizzati o regole di sostituzione.

Dove Aspose.Words Cerca i caratteri TrueTypesu Linux

Diverse distribuzioni Linux possono memorizzare font in cartelle diverse. Aspose.Words cerca i font in più posizioni. Per impostazione predefinita, Aspose.Words cerca i font in tutte le posizioni seguenti: /usr/share/fonts, /usr/local/share/fonts, /usr/X11R6/lib/X11/fonts. Questo comportamento predefinito funzionerà per la maggior parte delle distribuzioni Linux, ma non è garantito che funzioni sempre, nel qual caso potrebbe essere necessario specificare esplicitamente la posizione dei font true type. Per fare ciò, è necessario sapere dove sono installati i font TrueType nella distribuzione Linux.

Dove Aspose.Words Cerca i caratteri TrueTypesu Mac OS X

Aspose.Words cerca i font nella cartella /Library/Fonts, che è la posizione standard per i font TrueType su Mac OS X. Mentre questa impostazione funzionerà per te la maggior parte del tempo, potrebbe essere necessario specificare le proprie cartelle di font nel caso in cui sia necessario.

TrueType Caratteri su Android

Su Android, il flusso di lavoro font è incapsulato nella classe Typeface. Ci sono cinque tipi di caratteri tipografici, ogni carattere tipografico rappresenta un gruppo di famiglie di caratteri simili:

  • DEFAULT
  • DEFAULT_BOLD
  • MONOSPACE
  • SANS_SERIF
  • SERIF

Ad esempio, secondo Android fonts.xml file di configurazione, “times” appartiene alla famiglia “serif” so NotoSerif-Regular.ttf verrà utilizzato quando viene richiesto “tempi”:

Fonts.xml

<family name="serif">
        <font weight="400" style="normal">NotoSerif-Regular.ttf</font>
        <font weight="700" style="normal">NotoSerif-Bold.ttf</font>
        <font weight="400" style="italic">NotoSerif-Italic.ttf</font>
        <font weight="700" style="italic">NotoSerif-BoldItalic.ttf</font>
</family>
<alias name="times" to="serif" />
<alias name="times new roman" to="serif" />

Per cercare font simili, vengono utilizzate le strategie descritte in precedenza.

Oltre a questi, Aspose.Words ha un proprio elenco di sostituzioni per la piattaforma Android.

Diciamo che il documento contiene il font PMingLiU-ExtB, prima di tutto, Aspose.Words sta cercando il font richiesto all’interno delle sorgenti di sistema.

L’elenco predefinito delle cartelle del font Android è:

  • /sistema / caratteri
  • / sistema / carattere
  • /dati / caratteri

Aspose.Words esamina le origini definite dall’utente impostate con il metodo:

Java

fontSettings.setFontsFolder("/home/user/MyFonts", true);

Nel caso in cui sia stata specificata una sostituzione esplicita, Aspose.Words sostituisce il font mancante con il suggerimento dell’utente:

Java

fontSettings.getSubstitutionSettings().getTableSubstitution().setSubstitutes("PMingLiU-ExtB", "Liberation Serif");

Se nessuna delle regole ha funzionato, Aspose.Words controlla la tabella di sostituzione interna. Se la tabella contiene informazioni su una buona misura, il carattere viene sostituito. Nel nostro caso Aspose.Words selezionerà Typeface.SERIF. Ma se la tabella non sa nulla del font richiesto, Aspose.Words raccoglie un font basato su speciali regole di parola MS o sulla distanza più vicina nello spazio Panose.

Caratteri TrueType su .NET Coree Xamarin

Per .NET Core e Xamarin si applica la stessa regola di Aspose.Words per la versione Java. Per impostazione predefinita, sono disponibili tutti i font di sistema della piattaforma su cui viene eseguita l’applicazione. L’elenco delle cartelle in cui verrà eseguita la ricerca può essere trovato chiamando il metodo:

Java

SystemFontSource().getAvailableFonts()

Carica font dalla cartella

Se il documento in elaborazione contiene collegamenti a font che non si trovano nel sistema, o se non si desidera aggiungerli alla cartella di sistema o se mancano le autorizzazioni, la soluzione migliore sarebbe aggiungere una cartella con i propri font utilizzando il metodo SetFontsSources. Ciò consentirà di sostituire l’origine del sistema con un’origine utente. Aspose.Words non cercherà più i font nel Registro di sistema o nella cartella Windows\Font e cercherà invece solo i font all’interno delle cartelle specificate. Il metodo GetFontSources restituirà i valori corrispondenti.

Specificare una o più cartelle di font

I metodi SetFontsFolder e SetFontsFolders sono scorciatoie per il metodo SetFontSources con una o più istanze FolderFontSource. Questi metodi sono usati per indicare dove Aspose.Words dovrebbe cercare i font. Se una cartella non esiste o non è accessibile, Aspose.Words ignora semplicemente questa cartella. Se tutte le cartelle, incluse le fonti per la sostituzione del font, sono state ignorate, Aspose.Words utilizzerà il font Fanwood come predefinito.

Nell’esempio seguente viene illustrato come impostare la cartella o l’origine, che Aspose.Words utilizzerà successivamente per cercare i font TrueType durante il rendering o l’incorporamento dei font:

Un parametro booleano aggiuntivo controlla se i font vengono scansionati ricorsivamente in tutte le cartelle, quindi scansiona tutte le cartelle figlio di una cartella specificata. Nell’esempio seguente viene illustrato come impostare Aspose.Words per cercare in più cartelle i font TrueType durante il rendering o l’incorporamento dei font:

È possibile scaricare il file modello di questo esempio da Aspose.Words GitHub.

Se non si desidera utilizzare affatto i font di sistema, Aspose.Words consente di ignorarli e utilizzare solo i propri font:

Java

FontSettings.getDefaultInstance().setFontsFolder("C:\\MyFonts\\", true);

Proprietà prioritaria

La proprietà Priority viene utilizzata quando ci sono font con lo stesso nome di famiglia e lo stesso stile in diverse origini di font. In questo caso Aspose.Words seleziona il font dall’origine con il valore di priorità più alto. Ad esempio, c’è una vecchia versione del font nella cartella di sistema e il cliente ha aggiunto una nuova versione dello stesso font in una cartella personalizzata.

Carica font dal flusso

Aspose.Words fornisce la classe StreamFontSource, che consente di caricare i font dal flusso. Per utilizzare l’origine del font stream, un utente deve creare una classe derivata da StreamFontSource e fornire un’implementazione del metodo OpenFontDataStream. Il metodo OpenFontDataStream può essere chiamato più volte. Per la prima volta, verrà chiamato quando Aspose.Words esegue la scansione delle fonti di font fornite per ottenere un elenco di font disponibili. In seguito può essere chiamato se il font viene utilizzato nel documento per analizzare i dati del font e per incorporare i dati del font in alcuni formati di output. StreamFontSource può essere utile perché consente di caricare i dati del font solo quando è richiesto e non di memorizzarli nella memoria per la durata di FontSettings.

StreamFontSource

Salvare e caricare una cache di ricerca font

Durante la ricerca di un font per la prima volta, Aspose.Words esegue l’iterazione sulle origini del font specificate dall’utente e forma una cache di ricerca del font in base ai dati provenienti da tali origini. Pertanto, la cache raccoglierà informazioni sui font disponibili: famiglia di font, stile, nome completo del font e altri. Nelle chiamate successive, Aspose.Words cerca informazioni sul font desiderato con il suo nome nella cache di ricerca font, dopo di che analizza i file specificati per utilizzare il font.

La procedura per l’analisi di tutti i file di font disponibili per inizializzare la cache richiede molto tempo. Aspose.Words consente di salvare e caricare la cache utilizzando il metodo FontSettings.SaveSearchCache per risolvere il problema delle prestazioni. Cioè, l’utente può caricare una cache precedentemente salvata da un file e saltare la fase di analisi di tutti i file di font disponibili.

Ottieni un elenco di font disponibili

Se si desidera ottenere l’elenco dei font disponibili, che, ad esempio, possono essere utilizzati per il rendering di un documento PDF, è possibile utilizzare il metodo GetAvailableFonts, come illustrato nell’esempio di codice seguente. La classe PhysicalFontInfo specifica le informazioni sul carattere fisico disponibile per il motore di caratteri Aspose.Words:

Installare i caratteri TrueType su Linuxin Java