Appendix L. IPP Extensions

Staple positions are specified with respect to portrait media orientation. See RFC3806.

Punch positions are specified with respect to portrait media orientation. See RFC3806.

Also see Section K.2.2.2, “Booklet Imposition”

A finishing that shifts Each Set in the output-bin from the previous one by a small amount which is device dependent (PWG5100.1).

The internal IPP extension org.savapage-requesting-user-name is the equivalent of IPP PRINT_JOB operation attribute requesting-user-name. In the example below it is mapped to PPD Option VENRequestingUserName.

*VENRequestingUserName org.savapage-requesting-user-name

This attribute indicates whether front covers are wanted for a printed copy and which sides of the cover must contain print-stream pages.

For example:

*SPJob/Copy: org.savapage-cover-front-type \
  *no-cover print-none print-front print-back print-both  

The IPP media-source the cover is printed from.

For example:

*SPJob/Copy: org.savapage-cover-front-media-source \
  *tray-3 tray-4  

This attribute indicates whether back covers are wanted for a printed copy and which sides of the cover must contain print-stream pages.

Also see Section L.1.2.1, “org.savapage-cover-front-type”.

The IPP media-source the cover is printed from. Also see Section L.1.2.2, “org.savapage-cover-front-media-source”.

Internal IPP Job Copy options can be mapped to PPD with SPExtra rules as illustrated in the example below.

*SPExtra/org.savapage-cover-front-media-source/tray-3: cover-front-tray-3 \
    org.savapage-cover-front-type/!no-cover \
    *FrontCover/Yes \ 
    *FrontCoverPrintTray/TRAY3

*SPExtra/org.savapage-cover-front-media-source/tray-4: cover-front-tray-4 \
    org.savapage-cover-front-type/!no-cover \
    *FrontCover/Yes \ 
    *FrontCoverPrintTray/TRAY4

Copy Cost is charged per job copy, and specified for a combination of SPJob/Copy and other (media*) attribute values. Each cost rule is prefixed with *SPJob/Copy/Cost: and formatted like this:

*SPJob/Copy/Cost: <cost> <mnemonic> \  
   <copy>/[!]<value> ... \  
   <attr>/[!]<value> ... \  

For example:

*SPJob/Copy/Cost: 0.0200 cost-cover-front-A4 \
    org.savapage-cover-front-type/!no-cover \
    media/iso_a4_210x297mm

*SPJob/Copy/Cost: 0.0400 cost-cover-front-A3 \
    org.savapage-cover-front-type/!no-cover \
    media/iso_a3_297x420mm

This attribute represents a finishing action, on a set of pages (a copy), executed externally by an operator, on the printed output.

The same PDF document must be printed twice with different page ranges:

For example:

*SPJobTicket/Copy: org.savapage-cover-type \
  *no-cover int.printfront int.printboth  

The color of the cover can be specified with org.savapage-cover-type-color

Thias attribute specifies the color of the org.savapage-cover-type. For example:

*SPJobTicket/Copy: org.savapage-cover-type-color \
  *white yellow orange red pink blue green  

This attribute determines which Job start/end sheet(s), if any, must be printed with a Job. Contrary to the IPP job-sheets definition, where sheets are part of the job, org.savapage-job-sheets are printed as a separate job. In this way sheets can be printed from a different media-source with distinctive org.savapage-job-sheets-media and media-color.

A job sheet is a single monochrome page with job detail information.

The IPP media for org.savapage-job-sheets. Multiple keyword values are allowed, like iso_a4_210x297mm, iso_a3_297x420mm, etc.

SavaPage creates IPP print jobs that are printed according to LandscapeOrientation Minus90. This is convenient most of the time. For example, when a landscape oriented PDF is 4-up printed, and staple-top-right and punch-dual-right are available as finishing. But, what if staple-top-left and punch-dual-left are the only options available? In that case a 180 degrees rotation of the "Finished-Page" is needed. This is where the org.savapage.int-page-rotate180 boolean option comes in. This marker is added to each proxy printer as option to make the printed result "Rotate by 180 degrees", and translated by SavaPage to the proper CUPS orientation-requested and number-up-layout values.