Lavorare con il testo in un file PS | Java

Aggiungere testo in un documento PS

In questo articolo, consideriamo i modi in cui è possibile aggiungere testo a un documento PS.
Ovviamente, il testo dovrebbe essere scritto in un documento con un font specifico. I font possono essere memorizzati in cartelle di sistema e, in questo caso, li chiamiamo font di sistema e possono essere memorizzati in cartelle personalizzate, ovvero cartelle in cui vengono salvati font per un utilizzo specifico. Di solito, questi font non sono presenti nelle cartelle di sistema. Chiamiamo tali font font personalizzati. La libreria Aspose.Page per Java offre metodi per utilizzare sia font di sistema che personalizzati.

Per utilizzare i font di sistema, basta riempire o delineare un testo con il codice nativo di Java java.awt.Font. I numeri nella chiamata del metodo rappresentano le coordinate x e y dell’angolo in alto a sinistra del testo.

document.fillText(str, new java.awt.Font("Times New Roman", java.awt.Font.BOLD, fontSize), 50, 100);

Per utilizzare font personalizzati, aggiungi prima la cartella custom fonts in PsSaveOptions, quindi recupera com.aspose.page.font.DrFont. Infine, riempi o delinea il testo con questo oggetto DrFont.

options.setAdditionalFontsFolders(new String[] { FONTS_FOLDER });
com.aspose.page.font.DrFont drFont = ExternalFontCache.fetchDrFont("Palatino Linotype", fontSize, Font.PLAIN);
document.fillText(str, drFont, 50, 100);

Un’altra opzione è lavorare con testo che appartiene anche a un font. Il font utilizzato per stampare il testo nel documento PostScript può essere incorporato in questo file o non incorporato. Nel primo caso, il testo verrà sempre visualizzato in qualsiasi visualizzatore o editor PostScript perché si trova sempre insieme al testo. Nel secondo caso, dovremmo aspettarci che il font utilizzato esista nelle cartelle di sistema sull’host di destinazione. Se il font utilizzato non esiste, l’interprete PostScript potrebbe generare un errore.
Anche la terza opzione riguarda un font, perché un font è l’elemento principale per l’aggiunta di testo. Un font utilizzato per riempire o disegnare (o anche per ritagliare) un testo può essere incorporato in un file PS in vari formati. Ora sono supportati i font TrueType e Type3 per l’incorporamento.
La quarta opzione è la possibilità di scrivere i glifi del testo con avanzamenti (larghezze) assegnati. Ciò consente di aggiungere un tocco artistico al testo.

Nell’esempio seguente mostriamo l’utilizzo di vari metodi per aggiungere testo in un documento PS con la libreria Aspose.Page per Java.

Un algoritmo per l’aggiunta di testo in un nuovo documento PS include i seguenti passaggi:

1. Creare un flusso di output per il file PS risultante.
2. Creare PsSaveOptions. Se utilizziamo un font personalizzato, aggiungiamo le relative cartelle nelle opzioni di salvataggio.
3. Creare PsDocument con il flusso di output già creato e le relative opzioni di salvataggio.
4. Creare il font desiderato, system o custom.
5. Riempire o delineare il testo con il font creato. Qui possiamo assegnare java.awt.Paint o java.awt.Stroke a seconda che si desideri riempire o disegnare il testo. Oppure possiamo riempire e delineare il testo in un unico metodo. Se utilizziamo un metodo senza java.awt.Paint o java.awt.Stroke, il testo verrà riempito o contornato con il colore/tratto corrente nello stato grafico corrente.
6. Chiudere la pagina.
7. Salvare il documento.
   

Suddividiamo il codice di esempio in piccoli frammenti di codice per separare la preparazione iniziale per il documento PS, l’utilizzo di ciascun metodo per l’aggiunta di testo e il completamento del documento.

In questo frammento di codice, creiamo un flusso di output e PsSaveOptions, aggiungiamo una cartella font personalizzata per utilizzare il font personalizzato nel codice, creiamo un oggetto PsDocument, impostiamo il testo comune per tutti i metodi come variabile stringa e creiamo la variabile fontSize che viene utilizzata anche in ogni metodo utilizzato.

//Create output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "AddText_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();
// Set custom fonts folder. It will be added to system fonts folders for finding needed fonts.
options.setAdditionalFontsFolders(new String[] { FONTS_FOLDER });
//A text to write to the PS file
String str = "ABCDEFGHIJKLMNO";
int fontSize = 48;

// Create a new 1-paged PS Document
PsDocument document = new PsDocument(outPsStream, options, false);

Qui mostriamo l’utilizzo del font di sistema per riempire il testo con il colore corrente dello stato grafico (ovvero nero) e con il nuovo SolidBrush.

//////////////////////////////////////Using system font (located in system fonts folders) for filling text //////////////////
Font font = new Font("Times New Roman", Font.BOLD, fontSize);
//Fill text with default or already defined color. In the given case it is black.
document.fillText(str, font, 50, 100);
//Fill text with Blue color.
document.fillText(str, font, 50, 150, Color.BLUE);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Il risultato

Ora riempiamo il testo con il font personalizzato.

//////////////////////////////////////Using custom font (located in custom fonts folders) for filling text /////////////////
DrFont drFont = ExternalFontCache.fetchDrFont("Palatino Linotype", fontSize, Font.PLAIN);
//Fill text with default or already defined color. In the given case it is black.
document.fillText(str, drFont, 50, 200);
//Fill text with Blue color.
document.fillText(str, drFont, 50, 250, Color.BLUE);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Il risultato

Qui mostriamo l’utilizzo del font di sistema per delineare il testo con il tratto corrente dello stato grafico (ovvero nero) e con il nuovo Tratto.

//Create a stroke with a width of 2 points.
Stroke stroke = new BasicStroke(2);
//Create stroke's blue-violet color
Color strokeColor = new Color(138, 43, 226);

//////////////////////////////////////Using system font (located in system fonts folders) for outlining text ////////////////
//Outline text with default or already defined pen. In the given case it is a black colored 1-point width pen.
document.outlineText(str, font, 50, 300);

//Outline text with blue-violet colored 2-point width pen.
document.outlineText(str, font, 50, 350, strokeColor, stroke);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Il risultato

Ora tracciamo il contorno del testo con il font personalizzato.

//////////////////////////////////////Using custom font (located in custom fonts folders) for outlining text /////////////////
//Outline text with default or already defined pen. In the given case it is a black colored 1-point width pen.
document.outlineText(str, drFont, 50, 450);
//Outline text with blue-violet colored 2-point width pen.
document.outlineText(str, drFont, 50, 500, strokeColor, stroke);
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Il risultato

Qui mostriamo l’utilizzo del font di sistema per riempire e delineare il testo con i nuovi SolidBrush e Pen.

//Fill text with orange color and stroke with blue-violet 2-point width pen.
document.fillAndStrokeText(str, font, 50, 400, Color.YELLOW, strokeColor, stroke);

Il risultato

Ora riempiamo e tracciamo il contorno del testo con il font personalizzato.

//Fill the text with orange color and stroke with blue 2-point width pen.
document.fillAndStrokeText(str, drFont, 50, 550, Color.ORANGE, Color.BLUE, stroke);

Il risultato

Infine, riempiamo il testo assegnando le larghezze ai glifi. Il numero di larghezze deve essere uguale al numero di glifi.

    //Glyphs widths
    float[] widths = new float[] { 87, 87, 87, 87, 34, 87, 87 };    
    //Fill ASCII text using assigning glyphs widths.
    document.fillText("BAMBOOK", widths, drFont, 50, 600, Color.BLUE);
    
    //Glyphs widths
    widths = new float[] { 87, 34, 87, 87, 87, 87, 87 };
    //Fill Unicode text using assigning glyphs widths.
    document.fillText("ЗООПАРК", widths, drFont, 50, 650, Color.ORANGE);

Risultato

Chiudi la pagina corrente e salva il documento.

//Close the current page
document.closePage();

//Save the document
document.save();

Vedi come lavorare con un testo nei documenti PS in .NET.

Nell’esempio precedente, vengono utilizzati font incorporati nel file PostScript come font TrueType, poiché questo è il comportamento predefinito di salvataggio dei font nella classe PsDocument. Se è necessario modificare questo comportamento, utilizzare PsSaveOptions come segue:

//Do not embed used fonts.
options.setEmbedFonts(false);

//Embed used fonts as Type3 fonts.
options.setEmbedFontsAs(FontConstants.EMBED_FONTS_TYPE3);

È possibile scaricare esempi e file di dati da GitHub.