Working with Text in PS file | Java

Add Text in PS Document

In this article, we consider the ways how a text can be added to a PS document.
Obviously, the text should be written in a document with some font. Fonts can be stored in system folders, and in this case, we call them system fonts and can be stored in custom folders, which are folders in which someone puts fonts for particular usage. Usually, these fonts are absent in system folders. We call such fonts custom fonts. Aspose.Page for Java library offers methods for using both system and custom fonts.

For using system fonts we just fill or outline a text with native Java’s java.awt.Font. Numbers in the method’s call are the x and y coordinates of the top-left corner of the text.

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

For using custom fonts, first add custom fonts folder in PsSaveOptions, then fetch com.aspose.page.font.DrFont. And finally fill or outline the text with this DrFont object.

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);

Another option is working with text that also belongs to a font. The font that is used to print text in the PostScript document can be embedded in this file or not embedded. In the first case, the text will always be rendered in any PostScript viewer or editor because it always lies with the text. In the second case, we should expect that the used font exists in system folders on the target host. If the used font doesn’t exist PostScript interpreter can throw an error.
The third option is also about a font because a font is the main thing in adding text. A font used for filling or drawing (or may be clipping) a text can be embedded in a PS file in various forms. Now TrueType and Type3 font types in embedding are supported.
The fourth option is the possibility to write the glyphs of the text with assigned advances (widths). It allows adding some artistry to the text.

In the example below we demonstrate the usage of various methods of adding text in a PS document with Aspose.Page for Java library.

An algorithm for adding text in a new PS document includes the following steps:

1. Create an output stream for the resulting PS file.
2. Create PsSaveOptions. If we use a custom font we add custom fonts folder(s) in the save options.
3. Create PsDocument with the already created output stream and save options.
4. Create necessary font, system or custom.
5. Fill or outline the text with the created font. Here we can assign java.awt.Paint or java.awt.Stroke depending on whether we fill or draw the text. Or we can fill and outline the text in one method. If we use a method without java.awt.Paint or java.awt.Stroke, the text will be filled or outlined with current paint/stroke in the current graphics state.
6. Close the page.
7. Save the document.
   

We split the example code into little code snippets to separate the initial preparation for the PS document, the usage of every method for adding text, and the completion of the document.

In this piece of code, we create an output stream and PsSaveOptions, add a custom fonts folder for using the custom font in the code, create a PsDocument object, set common for all methods text as a string variable, and create fontSize variable that is also used in every used method.

//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);

Here we demonstrate the usage of system font for filling the text with the current color of the graphics state (that is black) and with the new 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);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

The result

Now we fill the text with the custom font.

//////////////////////////////////////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);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

The result

Here we demonstrate the usage of system font for outlining the text with the current stroke of graphics state (that is black) and with the new Stroke.

//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);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

The result

Now we outline the text with the custom font.

//////////////////////////////////////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);
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

The result

Here we demonstrate the usage of the system font for filling and outlining the text with new SolidBrush and 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);

The result

Now we fill and outline the text with the custom font.

//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);

The result

Finally, we fill the text by assigning glyphs widths. The number of widths must be equal to the number of glyphs.

    //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);

The result

Close the current page, save the document.

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

//Save the document
document.save();

See working with a text in PS documents in .NET.

In the example above, there are used fonts embedded in the PostScript file as TrueType fonts, because it is the default behavior of saving fonts in the PsDocument class. If you need to change this behavior, please, use PsSaveOptions like the following:

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

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

You can download examples and data files from GitHub.