public class

PSPrinterJob

extends RasterPrinterJob

java.lang.Object
↳	java.awt.print.PrinterJob
	↳	sun.print.RasterPrinterJob
		↳	sun.print.PSPrinterJob

Class Overview

A class which initiates and executes a PostScript printer job.

Summary

Nested Classes
class	PSPrinterJob.EPSPrinter
class	PSPrinterJob.PluginPrinter	PluginPrinter generates EPSF wrapped with a header and trailer comment.

Constants
int	FILL_EVEN_ODD	Passed to the `setFillMode` method this value forces fills to be done using the even-odd fill rule.
int	FILL_WINDING	Passed to the `setFillMode` method this value forces fills to be done using the non-zero winding rule.

[Expand]

Inherited Constants

From class sun.print.RasterPrinterJob

[Expand]

Inherited Fields

From class sun.print.RasterPrinterJob

Public Constructors
	PSPrinterJob()

Public Methods
boolean	printDialog() Presents the user a dialog for changing properties of the print job interactively.

Protected Methods
void	abortDoc() Invoked if the application cancelled the printjob.
void	beginPath() Called to mark the start of a new path.
void	bezierTo(float control1x, float control1y, float control2x, float control2y, float endX, float endY) Add to the current path a bezier curve formed by the current pen position and the method parameters which are two control points and an ending point.
void	closeSubpath() Close the current subpath by appending a straight line from the current point to the subpath's starting point.
Graphics2D	createPathGraphics(PeekGraphics peekGraphics, PrinterJob printerJob, Printable painter, PageFormat pageFormat, int pageIndex) Examine the metrics captured by the `PeekGraphics` instance and if capable of directly converting this print job to the printer's control language or the native OS's graphics primitives, then return a `PSPathGraphics` to perform that conversion.
void	deviceFill(PathIterator pathIter, Color color, AffineTransform tx, Shape clip)
void	drawImageBGR(byte[] bgrData, float destX, float destY, float destWidth, float destHeight, float srcX, float srcY, float srcWidth, float srcHeight, int srcBitMapWidth, int srcBitMapHeight) Convert the 24 bit BGR image buffer represented by `image` to PostScript.
void	endDoc() Invoked by the RasterPrintJob super class this method is called after that last page has been imaged.
void	endPage(PageFormat format, Printable painter, int index) The RastePrintJob super class calls this method at the end of each page.
void	fillPath() Fill the current path using the current fill mode and color.
int	getCollatedCopies() Returns how many times the entire book should be printed by the PrintJob.
int	getNoncollatedCopies() Returns how many times each page in the book should be consecutively printed by PrintJob.
float	getPenX() Return the x coordinate of the pen in the current path.
float	getPenY() Return the y coordinate of the pen in the current path.
double	getPhysicalPageHeight(Paper p) Must be obtained from the current printer.
double	getPhysicalPageWidth(Paper p) Must be obtained from the current printer.
double	getPhysicalPrintableHeight(Paper p) Must be obtained from the current printer.
double	getPhysicalPrintableWidth(Paper p) Must be obtained from the current printer.
double	getPhysicalPrintableX(Paper p) For PostScript the origin is in the upper-left of the paper not at the imageable area corner.
double	getPhysicalPrintableY(Paper p) For PostScript the origin is in the upper-left of the paper not at the imageable area corner.
double	getXRes() Return the x resolution of the coordinates to be rendered.
double	getYRes() Return the y resolution of the coordinates to be rendered.
void	lineTo(float x, float y) Generate PostScript to draw a line from the current pen position to `(x, y)`.
void	moveTo(float x, float y) Generate PostScript to move the current pen position to `(x, y)`.
int	platformFontCount(Font font, String str)
void	printBand(byte[] bgrData, int x, int y, int width, int height) Prints the contents of the array of ints, 'data' to the current page.
void	selectClipPath() Intersect the gstate's current path with the current clip and make the result the new clip.
void	setClip(Shape clip)
void	setColor(Color color) Set the printer's current color to be that defined by `color`
void	setFillMode(int fillRule) Set the current path rule to be either `FILL_EVEN_ODD` (using the even-odd file rule) or `FILL_WINDING` (using the non-zero winding rule.)
boolean	setFont(Font font) Set the current PostScript font.
void	setTransform(AffineTransform transform)
void	startDoc() Invoked by the RasterPrinterJob super class this method is called to mark the start of a document.
void	startPage(PageFormat pageFormat, Printable painter, int index, boolean paperChanged) The RasterPrintJob super class calls this method at the start of each page.
boolean	textOut(Graphics g, String str, float x, float y, Font mLastFont, FontRenderContext frc, float width)

[Expand]

Inherited Methods

From class sun.print.RasterPrinterJob

abstract void	abortDoc()
void	cancel() If a print job is in progress, print() has been called but has not returned, then this signals that the job should be cancelled and the next chance.
boolean	checkAllowedToPrintToFile() User dialogs should disable "File" buttons if this returns false.
Graphics2D	createPathGraphics(PeekGraphics graphics, PrinterJob printerJob, Printable painter, PageFormat pageFormat, int pageIndex) Examine the metrics captured by the `PeekGraphics` instance and if capable of directly converting this print job to the printer's control language or the native OS's graphics primitives, then return a `PathGraphics` to perform that conversion.
PeekGraphics	createPeekGraphics(Graphics2D graphics, PrinterJob printerJob) Create and return an object that will gather and hold metrics about the print job.
void	debug_println(String str)
PageFormat	defaultPage(PageFormat page) The passed in PageFormat will be copied and altered to describe the default page size and orientation of the PrinterJob's current printer.
abstract void	endDoc() Called by the print() method at the end of a print job.
abstract void	endPage(PageFormat format, Printable painter, int index) End a page.
int	getCollatedCopies() Returns how many times the entire book should be printed by the PrintJob.
int	getCopies() Get the number of copies to be printed.
int	getCopiesInt()
int	getFirstPage() Return the zero based index of the first page to be printed in this job.
String	getJobName() Get the name of the document to be printed.
String	getJobNameInt()
int	getLastPage() Return the zero based index of the last page to be printed in this job.
int	getNoncollatedCopies() Returns how many times each page in the book should be consecutively printed by PrintJob.
Pageable	getPageable() Return the Pageable describing the pages to be printed.
abstract double	getPhysicalPageHeight(Paper p) Must be obtained from the current printer.
abstract double	getPhysicalPageWidth(Paper p) Must be obtained from the current printer.
abstract double	getPhysicalPrintableHeight(Paper p) Must be obtained from the current printer.
abstract double	getPhysicalPrintableWidth(Paper p) Must be obtained from the current printer.
abstract double	getPhysicalPrintableX(Paper p) Must be obtained from the current printer.
abstract double	getPhysicalPrintableY(Paper p) Must be obtained from the current printer.
PrintService	getPrintService() Returns the service (printer) for this printer job.
String	getUserName() Get the name of the printing user.
String	getUserNameInt()
abstract double	getXRes() Returns the resolution in dots per inch across the width of the page.
abstract double	getYRes() Returns the resolution in dots per inch down the height of the page.
void	initPrinter()
boolean	isCancelled() Returns true is a print job is ongoing but will be cancelled and the next opportunity.
boolean	isCollated() Return true if collated copies will be printed as determined in an attribute set.
boolean	isSupportedValue(Attribute attrval, PrintRequestAttributeSet attrset)
static PrintService	lookupDefaultPrintService()
PageFormat	pageDialog(PrintRequestAttributeSet attributes) return a PageFormat corresponding to the updated attributes, or null if the user cancelled the dialog.
PageFormat	pageDialog(PageFormat page) Display a dialog to the user allowing the modification of a PageFormat instance.
void	print() Prints a set of pages.
void	print(PrintRequestAttributeSet attributes) Prints a set of pages using the settings in the attribute set.
abstract void	printBand(byte[] data, int x, int y, int width, int height) Prints the contents of the array of ints, 'data' to the current page.
boolean	printDialog(PrintRequestAttributeSet attributes) Presents the user a dialog for changing properties of the print job interactively.
boolean	printDialog() Presents the user a dialog for changing properties of the print job interactively.
int	printPage(Pageable document, int pageIndex) Print a page from the provided document.
String	removeControlChars(String s)
void	saveState(AffineTransform at, Shape clip, Rectangle2D region, double sx, double sy) save graphics state of a PathGraphics for later redrawing of part of page represented by the region in that state
void	setAttributes(PrintRequestAttributeSet attributes)
void	setCollated(boolean collate) Set whether copies should be collated or not.
void	setCopies(int copies) Set the number of copies to be printed.
void	setJobName(String jobName) Set the name of the document to be printed.
void	setPageRange(int firstPage, int lastPage) Set the range of pages from a Book to be printed.
void	setPageable(Pageable document) The pages in the document to be printed are held by the Pageable instance 'document'.
void	setPrintService(PrintService service) Associate this PrinterJob with a new PrintService.
void	setPrintable(Printable painter) The pages in the document to be printed by this PrinterJob are drawn by the Printable object 'painter'.
void	setPrintable(Printable painter, PageFormat format) The pages in the document to be printed by this PrinterJob are drawn by the Printable object 'painter'.
abstract void	startDoc() Called by the print() method at the start of a print job.
abstract void	startPage(PageFormat format, Printable painter, int index, boolean paperChanged) Begin a new page.
void	updatePageAttributes(PrintService service, PageFormat page)
PageFormat	validatePage(PageFormat page) The passed in PageFormat is cloned and altered to be usable on the PrinterJob's current printer.
void	validatePaper(Paper origPaper, Paper newPaper) updates a Paper object to reflect the current printer's selected paper size and imageable area for that paper size.

From class java.awt.print.PrinterJob

abstract void	cancel() Cancels a print job that is in progress.
abstract PageFormat	defaultPage(PageFormat page) Clones the `PageFormat` argument and alters the clone to describe a default page size and orientation.
PageFormat	defaultPage() Creates a new `PageFormat` instance and sets it to a default size and orientation.
abstract int	getCopies() Gets the number of copies to be printed.
abstract String	getJobName() Gets the name of the document to be printed.
PageFormat	getPageFormat(PrintRequestAttributeSet attributes) Calculates a `PageFormat` with values consistent with those supported by the current `PrintService` for this job (ie the value returned by `getPrintService()`) and media, printable area and orientation contained in `attributes`.
PrintService	getPrintService() Returns the service (printer) for this printer job.
static PrinterJob	getPrinterJob() Creates and returns a `PrinterJob` which is initially associated with the default printer.
abstract String	getUserName() Gets the name of the printing user.
abstract boolean	isCancelled() Returns `true` if a print job is in progress, but is going to be cancelled at the next opportunity; otherwise returns `false`.
static PrintService[]	lookupPrintServices() A convenience method which looks up 2D print services.
static StreamPrintServiceFactory[]	lookupStreamPrintServices(String mimeType) A convenience method which locates factories for stream print services which can image 2D graphics.
PageFormat	pageDialog(PrintRequestAttributeSet attributes) A convenience method which displays a cross-platform page setup dialog.
abstract PageFormat	pageDialog(PageFormat page) Displays a dialog that allows modification of a `PageFormat` instance.
abstract void	print() Prints a set of pages.
void	print(PrintRequestAttributeSet attributes) Prints a set of pages using the settings in the attribute set.
boolean	printDialog(PrintRequestAttributeSet attributes) A convenience method which displays a cross-platform print dialog for all services which are capable of printing 2D graphics using the `Pageable` interface.
abstract boolean	printDialog() Presents a dialog to the user for changing the properties of the print job.
abstract void	setCopies(int copies) Sets the number of copies to be printed.
abstract void	setJobName(String jobName) Sets the name of the document to be printed.
abstract void	setPageable(Pageable document) Queries `document` for the number of pages and the `PageFormat` and `Printable` for each page held in the `Pageable` instance, `document`.
void	setPrintService(PrintService service) Associate this PrinterJob with a new PrintService.
abstract void	setPrintable(Printable painter, PageFormat format) Calls `painter` to render the pages in the specified `format`.
abstract void	setPrintable(Printable painter) Calls `painter` to render the pages.
abstract PageFormat	validatePage(PageFormat page) Returns the clone of `page` with its settings adjusted to be compatible with the current printer of this `PrinterJob`.

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

Constants

protected static final int FILL_EVEN_ODD

Passed to the setFillMode method this value forces fills to be done using the even-odd fill rule.

Constant Value: 1 (0x00000001)

protected static final int FILL_WINDING

Passed to the setFillMode method this value forces fills to be done using the non-zero winding rule.

Constant Value: 2 (0x00000002)

Public Constructors

public PSPrinterJob ()

Public Methods

public boolean printDialog ()

Presents the user a dialog for changing properties of the print job interactively.

Returns

true if the user does not cancel the dialog; false otherwise.

Throws

HeadlessException	if GraphicsEnvironment.isHeadless() returns true.

Protected Methods

protected void abortDoc ()

Invoked if the application cancelled the printjob.

protected void beginPath ()

Called to mark the start of a new path.

protected void bezierTo (float control1x, float control1y, float control2x, float control2y, float endX, float endY)

Add to the current path a bezier curve formed by the current pen position and the method parameters which are two control points and an ending point.

protected void closeSubpath ()

Close the current subpath by appending a straight line from the current point to the subpath's starting point.

protected Graphics2D createPathGraphics (PeekGraphics peekGraphics, PrinterJob printerJob, Printable painter, PageFormat pageFormat, int pageIndex)

Examine the metrics captured by the PeekGraphics instance and if capable of directly converting this print job to the printer's control language or the native OS's graphics primitives, then return a PSPathGraphics to perform that conversion. If there is not an object capable of the conversion then return null. Returning null causes the print job to be rasterized.

protected void deviceFill (PathIterator pathIter, Color color, AffineTransform tx, Shape clip)

protected void drawImageBGR (byte[] bgrData, float destX, float destY, float destWidth, float destHeight, float srcX, float srcY, float srcWidth, float srcHeight, int srcBitMapWidth, int srcBitMapHeight)

Convert the 24 bit BGR image buffer represented by image to PostScript. The image is drawn at (destX, destY) in device coordinates. The image is scaled into a square of size specified by destWidth and destHeight. The portion of the source image copied into that square is specified by srcX, srcY, srcWidth, and srcHeight.

protected void endDoc ()

Invoked by the RasterPrintJob super class this method is called after that last page has been imaged.

Throws

PrinterException

protected void endPage (PageFormat format, Printable painter, int index)

The RastePrintJob super class calls this method at the end of each page.

Throws

PrinterException

protected void fillPath ()

Fill the current path using the current fill mode and color.

protected int getCollatedCopies ()

Returns how many times the entire book should be printed by the PrintJob. If the printer itself supports collation then this method should return 1 indicating that the entire book need only be printed once and the copies will be collated and made in the printer.

protected int getNoncollatedCopies ()

Returns how many times each page in the book should be consecutively printed by PrintJob. If the printer makes copies itself then this method should return 1.

protected float getPenX ()

Return the x coordinate of the pen in the current path.

protected float getPenY ()

Return the y coordinate of the pen in the current path.

protected double getPhysicalPageHeight (Paper p)

Must be obtained from the current printer. Value is in device pixels. Not adjusted for orientation of the paper.

protected double getPhysicalPageWidth (Paper p)

Must be obtained from the current printer. Value is in device pixels. Not adjusted for orientation of the paper.

protected double getPhysicalPrintableHeight (Paper p)

Must be obtained from the current printer. Value is in device pixels. Not adjusted for orientation of the paper.

protected double getPhysicalPrintableWidth (Paper p)

Must be obtained from the current printer. Value is in device pixels. Not adjusted for orientation of the paper.

protected double getPhysicalPrintableX (Paper p)

For PostScript the origin is in the upper-left of the paper not at the imageable area corner.

protected double getPhysicalPrintableY (Paper p)

For PostScript the origin is in the upper-left of the paper not at the imageable area corner.

protected double getXRes ()

Return the x resolution of the coordinates to be rendered.

protected double getYRes ()

Return the y resolution of the coordinates to be rendered.

protected void lineTo (float x, float y)

Generate PostScript to draw a line from the current pen position to (x, y).

protected void moveTo (float x, float y)

Generate PostScript to move the current pen position to (x, y).

protected int platformFontCount (Font font, String str)

protected void printBand (byte[] bgrData, int x, int y, int width, int height)

Prints the contents of the array of ints, 'data' to the current page. The band is placed at the location (x, y) in device coordinates on the page. The width and height of the band is specified by the caller. Currently the data is 24 bits per pixel in BGR format.

Throws

PrinterException

protected void selectClipPath ()

Intersect the gstate's current path with the current clip and make the result the new clip.

protected void setClip (Shape clip)

protected void setColor (Color color)

Set the printer's current color to be that defined by color

protected void setFillMode (int fillRule)

Set the current path rule to be either FILL_EVEN_ODD (using the even-odd file rule) or FILL_WINDING (using the non-zero winding rule.)

protected boolean setFont (Font font)

Set the current PostScript font. Taken from outFont in PSPrintStream.

protected void setTransform (AffineTransform transform)

protected void startDoc ()

Invoked by the RasterPrinterJob super class this method is called to mark the start of a document.

Throws

PrinterException

protected void startPage (PageFormat pageFormat, Printable painter, int index, boolean paperChanged)

The RasterPrintJob super class calls this method at the start of each page.

Throws

PrinterException

Interfaces

Classes

PSPrinterJob

Class Overview

Summary

Constants

protected static final int FILL_EVEN_ODD

protected static final int FILL_WINDING

Public Constructors

public PSPrinterJob ()

Public Methods

public boolean printDialog ()

Returns

Throws

See Also

Protected Methods

protected void abortDoc ()

protected void beginPath ()

protected void bezierTo (float control1x, float control1y, float control2x, float control2y, float endX, float endY)

protected void closeSubpath ()

protected Graphics2D createPathGraphics (PeekGraphics peekGraphics, PrinterJob printerJob, Printable painter, PageFormat pageFormat, int pageIndex)

protected void deviceFill (PathIterator pathIter, Color color, AffineTransform tx, Shape clip)

protected void drawImageBGR (byte[] bgrData, float destX, float destY, float destWidth, float destHeight, float srcX, float srcY, float srcWidth, float srcHeight, int srcBitMapWidth, int srcBitMapHeight)

protected void endDoc ()

Throws

protected void endPage (PageFormat format, Printable painter, int index)

Throws

protected void fillPath ()

protected int getCollatedCopies ()

protected int getNoncollatedCopies ()

protected float getPenX ()

protected float getPenY ()

protected double getPhysicalPageHeight (Paper p)

protected double getPhysicalPageWidth (Paper p)

protected double getPhysicalPrintableHeight (Paper p)

protected double getPhysicalPrintableWidth (Paper p)

protected double getPhysicalPrintableX (Paper p)

protected double getPhysicalPrintableY (Paper p)

protected double getXRes ()

protected double getYRes ()

protected void lineTo (float x, float y)

protected void moveTo (float x, float y)

protected int platformFontCount (Font font, String str)

protected void printBand (byte[] bgrData, int x, int y, int width, int height)

Throws

protected void selectClipPath ()

protected void setClip (Shape clip)

protected void setColor (Color color)

protected void setFillMode (int fillRule)

protected boolean setFont (Font font)

protected void setTransform (AffineTransform transform)

protected void startDoc ()

Throws

protected void startPage (PageFormat pageFormat, Printable painter, int index, boolean paperChanged)

Throws

protected boolean textOut (Graphics g, String str, float x, float y, Font mLastFont, FontRenderContext frc, float width)