Working with Document in PS file | Java

Create PS Document

Aspose.Page for Java offers two constructors in order to create PsDocument class. The following code snippet creates a 1-paged PS document:

//Create output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "document.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

//If you want to aassign page size other than A4, set page size in options
options.setPageSize(PageConstants.getSize(PageConstants.SIZE_A4, PageConstants.ORIENTATION_PORTRAIT));
//If you want to aassign page margins other than empty, set page margins in options
options.setMargins(PageConstants.getMargins(PageConstants.MARGINS_ZERO));
//If you plan to use fonts that located in non system folders, set additional fonts folders in options
options.setAdditionalFontsFolders(new String[] { FONTS_FOLDER });

//Set variable that indicates if resulting PostScript document will be multipaged
boolean multiPaged = false;

// Create new multipaged PS Document with one page opened
PsDocument document = new PsDocument(outPsStream, options, multiPaged);

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

If PS document is planning to be multi-paged, set multiPaged variable to true.

Another constructor allows creating PsDocument object with a defined number of pages:

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();
//Create output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "CreateDocument_outPS.ps");

// Create new multipaged PS Document with 2 pages. These two pages are not created. It must be added by addPage() method.
PsDocument document = new PsDocument(outPsStream, options, 2);

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

See working with PS document in .NET.

Let’s look at the PsSaveOptions class that encapsulates possible options helping to create the right PostScript document.

• SaveFormat specifies an output format of documents. Can be PS or EPS. In Aspose.Page library differences between these two formats are reflected only in PostScript comments and a file extension. Also in accordance with the EPS file specification EPS files should be 1-paged. PS format is used by default.

• PageSize specifies the size of the pages in the PS document. However, we can assign different page sizes for every page if it is required. The page size can be obtained from PageConstants class like in following example:

options.setPageSize(PageConstants.getSize(PageConstants.SIZE_International, PageConstants.ORIENTATION_PORTRAIT));

The default page size is “A4” in “Portrait” orientation.

• Margins specifies blank fields between the page boundaries and left, up, right, and bottom edges of the page content. It can be obtained from PageConstants class.

options.setMargins(PageConstants.getMargins(PageConstants.MARGINS_SMALL)); // 20 points for each margin

Default margins are “ZERO” (0, 0, 0, 0).

• BackGroundColor specifies a color of page’s background. Can be assigned as:

options.setBackgroundColor(new Color(211, 8, 48));

or:

options.setBackgroundColor(Color.YELLOW);

Default value is “null” that means no background.

• EmbedFonts controls the behavior of PsDocument while saving it to the file. If “false”, used fonts will not be written in the PS file. In this case, the PostScript interpreter will throw an error if the used font cannot be found in system folders on the target host.

• EmbedFontsAs controls the way how fonts will be embedded in the PS file. At this moment two ways work TrueType and Type3 font formats. The value can be set with help of FontConstants class like the following:

options.setEmbedFontsAs(FontsConstants.EMBED_FONTS_TYPE3);

The default value is “TrueType”.

• JpegQualityLevel specifies a level of compression/quality of images in the resulting PS document. The more quality is required the less compression will be and vice versa. Minimal quality is 0, and maximal - 100. The default is 75.

• AdditionalFontsFolder specifies locations where to find fonts. System font folders are always included by default.

• Debug allows outputting debug information to the console. The default value is false.

You can download examples and data files from GitHub.