Integrated: 8314070: javax.print: Support IPP output-bin attribute extension

[Alexander Scherbatiy]

On Thu, 12 Oct 2023 15:39:45 GMT, Alexander Scherbatiy <alexsch at openjdk.org> wrote:

> The fix adds new public `OutputBin` print attribute class which allow to set a printer output bin in a `PrinterJob` class. The corresponding internal `CustomOutputBin` class is added as well.
> 
> - Constants used in `OutputBin` class are based on [Internet Printing Protocol (IPP): “output-bin” attribute extension](https://ftp.pwg.org/pub/pwg/candidates/cs-ippoutputbin10-20010207-5100.2.pdf) document.
> - `CUPSPrinter.getOutputBins(String printer)` method uses PPD  `ppdFindOption(..., "OutputBin")` function to get supported output bins for the given printer on native level.
> - The fix propagates the `OutputBin` attribute from the printer job attributes to `NSPrintInfo` print settings with `OutputBin` key on macOS.
> 
> The fix was tested on `Kyocera ECOSYS M8130cidn` printer where `ppdFindOption(..., "OutputBin")` call returns 4 output bins (text, choice): 
> - Printer settings, None
> - Inner tray, INNERTRAY
> - Separator tray, SEPARATORTRAY
> - Finisher (face-down), Main
> 
> if `Printer settings`, `Inner tray`, or `Finisher (face-down)` CustomOutputBins is set to `PrinterJob.print(...)` attributes a test page is printed to the Main tray of the  `Kyocera ECOSYS M8130cidn` printer. If `Separator tray` is used a page is printed to the Separator tray. This is consistent with the printer behavior when a native print dialog is used from a native Preview app to print a document on macOS.

This pull request has now been integrated.

Changeset: c7d2a5c1
Author:    Alexander Scherbatiy <alexsch at openjdk.org>
URL:       https://git.openjdk.org/jdk/commit/c7d2a5c1c4e86955100f4c40170dc25222abd07f
Stats:     1479 lines in 25 files changed: 1476 ins; 0 del; 3 mod

8314070: javax.print: Support IPP output-bin attribute extension

Reviewed-by: psadhukhan, prr

-------------

PR: https://git.openjdk.org/jdk/pull/16166