com.klg.jclass.page.adobe.postscript
Class JCPostScriptPrinter

java.lang.Object
  |
  +--com.klg.jclass.page.JCPrinter
        |
        +--com.klg.jclass.page.adobe.postscript.JCPostScriptPrinter

public class JCPostScriptPrinter

extends JCPrinter

Implements the PrinterDriver interface.

Field Summary

protected int	characterEncoding
static int	ENCODING_ISO_LATIN_1
static int	ENCODING_ISO_LATIN_1_EURO

Fields inherited from class com.klg.jclass.page.JCPrinter

bookmarkTree, bookmarkTreeVisible, collate, compressed, endPage, graphics, imageNumber, isDocOpen, numCopies, orientation, os, pageCount, printListeners, reverseOrder, startPage

Constructor Summary

JCPostScriptPrinter(OutputStream os)
Creates a PostScript printer given an OutputStream.

JCPostScriptPrinter(OutputStream os, com.klg.jclass.page.FontParser parser, String jarLocation, String fileExtension, String fontMapFileName)
Constructor.

Method Summary

void	beginPage(Rectangle2D pageSize, int pageNumber) Outputs the PostScript code necessary to start a page.
void	closeDocument(Rectangle2D pageSize) Completes the document (output the DSC trailer).
void	endPage(Rectangle2D pageSize) End the page; outputs the appropriate DSC comments, etc.
int	getCharacterEncoding() Gets the character encoding vector being used for PostScript output.
Graphics	getGraphics() Gets a Graphics that draws to this printer.
boolean	isImageScalable() Returns true since PostScript can scale images itself.
void	openDocument(Rectangle2D pageSize) Initializes the document (PostScript document headers, etc.)
void	setCharacterEncoding(int encoding) Sets the character encoding vector to use for PostScript output.
void	setup() Creates default styles, any other one-time initialization.

Methods inherited from class com.klg.jclass.page.JCPrinter

addPrintListener, getCollate, getFontFamilies, getNumCopies, getOrientation, getOutputPageEnd, getOutputPageStart, getOutputStream, getReverseOrder, isBookmarkTreeVisible, isCompressed, isDocumentOpen, isLandscape, output, output, output, output, removePrintListener, setCollate, setCompressed, setNumCopies, setOrientation, setOutputPageEnd, setOutputPageStart, setOutputStream, setReverseOrder, supportsHyperlinks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ENCODING_ISO_LATIN_1

public static final int ENCODING_ISO_LATIN_1

See Also:

Constant Field Values

ENCODING_ISO_LATIN_1_EURO

public static final int ENCODING_ISO_LATIN_1_EURO

See Also:

Constant Field Values

characterEncoding

protected int characterEncoding

Constructor Detail

JCPostScriptPrinter

public JCPostScriptPrinter(OutputStream os)

Creates a PostScript printer given an OutputStream.

Note: For large documents and for optimal performance, wrap the output stream in a BufferedOutputStream. For example:

 		BufferedOutputStream bos 	= new BufferedOutputStream(os, 2048);
 		JCPrinter printer 			= new JCPostScriptPrinter(bos);
 

Parameters:

os - an OutputStream to write the PostScript code to

JCPostScriptPrinter

public JCPostScriptPrinter(OutputStream os,
                           com.klg.jclass.page.FontParser parser,
                           String jarLocation,
                           String fileExtension,
                           String fontMapFileName)

Constructor. Allows detailed specification of font creation. The constructor which takes one argument is akin to calling this constructor with these parameters:

		JCPrinter p = new JCPostScriptPrinter(
				someOutputStream,						// the output stream
				new com.klg.jclass.page.adobe.postscript.AFMParser(), // the parser
				"/com/klg/jclass/page/adobe/fonts.jar", // jar location
				".afm",									// file extension
				"com.klg.jclass.page.adobe.JCAdobeFontMap");
 

Note: For large documents and for optimal performance, wrap the output stream in a BufferedOutputStream. For example:

 		BufferedOutputStream bos 	= new BufferedOutputStream(os, 2048);
 		JCPrinter printer 			= new JCPostScriptPrinter(bos, ...);
 

Parameters:

os - the OutputStream to which formatted output should be sent

parser - the FontParser which creates fonts from afm files

jarLocation - the location of the jar containing afm files relative to the class loader including the name of the jar file

fileExtension - the parser will turn files contained in "jarLocation" ending with this extension into fonts

fontMapFileName - the user fontmap file; a file containing mappings between font names and their aliases

Method Detail

setup

public void setup()

Creates default styles, any other one-time initialization. Builds font families from available fonts.

Specified by:

setup in class JCPrinter

isImageScalable

public boolean isImageScalable()

Returns true since PostScript can scale images itself.

Specified by:

isImageScalable in class JCPrinter

Returns:

true since PostScript can scale images itself

setCharacterEncoding

public void setCharacterEncoding(int encoding)

Sets the character encoding vector to use for PostScript output. Possible values are ENCODING_ISO_LATIN_1 (self-explanatory) or ENCODING_ISO_LATIN_1_EURO (the ISO Latin 1 set with the Euro character added at decimal 128).

Parameters:

encoding - the character encoding vector to use

getCharacterEncoding

public int getCharacterEncoding()

Gets the character encoding vector being used for PostScript output. Possible values are ENCODING_ISO_LATIN_1 (self-explanatory) or ENCODING_ISO_LATIN_1_EURO (the ISO Latin 1 set with the Euro character added at decimal 128).

Returns:

the character encoding vector being used

openDocument

public void openDocument(Rectangle2D pageSize)

Initializes the document (PostScript document headers, etc.)

Overrides:

openDocument in class JCPrinter

Parameters:

pageSize - the size of the default/first page of the document

closeDocument

public void closeDocument(Rectangle2D pageSize)

Completes the document (output the DSC trailer).

Overrides:

closeDocument in class JCPrinter

Parameters:

pageSize - the size of the default/last page of the document

beginPage

public void beginPage(Rectangle2D pageSize,
                      int pageNumber)

Outputs the PostScript code necessary to start a page. (Document Structuring Conventions comments, page orientation, etc.)

Overrides:

beginPage in class JCPrinter

Parameters:

pageSize - the dimensions of the new page

pageNumber -

endPage

public void endPage(Rectangle2D pageSize)

End the page; outputs the appropriate DSC comments, etc.

Overrides:

endPage in class JCPrinter

Parameters:

pageSize - the dimensions of the current page

getGraphics

public Graphics getGraphics()

Gets a Graphics that draws to this printer.

Overrides:

getGraphics in class JCPrinter

Returns:

a Graphics object instantiated for this printer